65e3593bf9
The --tool-opt runner option is the recommended practice for allowing runners to take additional arguments that are passed on to the underlying tool. It exists because we don't want to add one runner option for every single tool option that users might want to tweak -- that would be a nightmare. Enough runners are using this option that it's time to promote it to a common runner capability with consistent behavior, the same way we did for the --dev-id option in the past. This removes boilerplate from individual runner files and ensures consistent argument handling for this option when it is supported. Since --tool-opt is a bit long to type, and we've had some complaints about that, take this as an opportunity to standardize on -O as a short option equivalent for it. Signed-off-by: Martí Bolívar <marti.bolivar@nordicsemi.no> |
||
|---|---|---|
| .. | ||
| completion | ||
| runners | ||
| tests | ||
| zspdx | ||
| boards.py | ||
| build.py | ||
| build_helpers.py | ||
| completion.py | ||
| debug.py | ||
| export.py | ||
| flash.py | ||
| mypy.ini | ||
| README.txt | ||
| run_common.py | ||
| run_tests.py | ||
| sign.py | ||
| spdx.py | ||
| zcmake.py | ||
| zephyr_ext_common.py | ||
This directory contains implementations for west commands which are tightly coupled to the zephyr tree. This includes the build, flash, and debug commands. Before adding more here, consider whether you might want to put new extensions in upstream west. For example, any commands which operate on the multi-repo need to be in upstream west, not here. Try to limit what goes in here to Zephyr-specific features. When extending this code, please keep the unit tests (in tests/) up to date. The mypy static type checker is also run on the runners package. To run these tests locally on Windows, run: py -3 run_tests.py On macOS and Linux: ./run_tests.py Note that these tests are run as part of Zephyr's CI when submitting an upstream pull request, and pull requests which break the tests cannot be merged. Thanks!