Tools

robotpy-build has some useful command line tools that can be executed via python3 -m robotpy_build TOOLNAME. On OSX/Linux, it is also installed as the robotpy-build script which can be executed directly.

scan-headers

This tool is designed to make it easy to populate the generate key for your python package.

This will scan all of your defined includes directories (including those of downloaded artifacts) and output something you can paste into the generate key of pyproject.toml.

create-gen

This will parse your defined generate items (generate key of pyproject.toml) and output yaml for them in the directory defined by generation_data. By default it will just print the file contents to stdout.

Use the --write argument to write the files, but it won’t overwrite existing files.

create-imports

Given a base package and a compiled module within that package, this will generate contents that contain all of the things exported by the compiled module. Often it is useful to put this in the __init__.py of your python package.

$ python -m robotpy_build create-imports rpydemo rpydemo._rpydemo