Following docs - error JSII4: Could not find "main" file: ... - when building

[stuMilk]

Describe the issue

Following the instructions from Prerequisites and Quick Start onwards, but choosing Python instead of Java, I am bumping into the following error:

[__DATE_TIME__] [ERROR] jsii/compiler - Type model errors prevented the JSII assembly from being created
error JSII4: Could not find "main" file: __PATH_TO_FILE__ 

The file is referenced. No changes in config alter the message. The path given in the message reflects exactly the path of the referenced file. The code being used is exactly that in the docs.

TypeScript and JS files are being generated in the configured location, but no python.

I have looked at the file permissions and ownership, but there is nothing there to affect it. No sudo required (obviously).

I have tried running with --verbose and --debug but the error is thrown before additional languages are attempted, so no output.

So, what is this error, where is it documented and how is it mitigated?

env: MacOS Sonoma 14.6.1 - nodejs v20.17.0 - python 3.12

Links

https://aws.github.io/jsii/user-guides/lib-author/quick-start/set-up/

[stuMilk]

It seems that the error was due to the fact that the jsii install was incomplete. The folders/files were not the same as appeared in the git repo (initially used an npm install). Git repo downloaded, alterations made and the error disappeared. Still Python does not build. There are steps missing from the jsii docs that could potentially relate to adding a pycache file to destination/source folders, or a requirements.txt file. The latter would prevent some github checks from failing.

Feel free to close this ticket. However, documentation is lacking in clarity, through too much information similar to the AWS docs.