colcon-test-result is an extension for the `colcon` build tool that provides commands to display and analyze test results generated by `colcon test`. It simplifies checking test outcomes without diving into raw XML files. The current version is 0.3.8, and it sees several releases per year, often in sync with ROS 2 development cycles.
pip install colcon-core colcon-test-resultNo compatibility data collected yet for this library.
This quickstart demonstrates how to install the `colcon-test-result` extension along with `colcon-core` and verify its availability by invoking its help command. To use its full functionality, you would typically first run `colcon test` in a workspace to generate test results, and then use `colcon test-result` to view them (e.g., `colcon test-result --verbose --all`).
Ensure `colcon test` completes successfully before attempting to view results. Check the build log for test failures or output issues. Use `colcon test --event-handlers console_direct+` for more direct test output.
Use `colcon test ... --test-result-level {none, package, aborted, failed, summary}` for inline reporting, and `colcon test-result ...` for comprehensive post-run analysis.Always install compatible versions. If encountering issues after a `colcon-core` upgrade, check the release notes for both `colcon-core` and `colcon-test-result` for known compatibility issues or required version ranges. Upgrade `colcon-test-result` to the latest version that supports your `colcon-core` version.
Run `pip install colcon-test-result` to install the extension. Ensure your Python environment (and thus `colcon`) can find the installed package.
First, navigate to your `colcon` workspace root. Then, run `colcon test` to execute tests and generate results. After tests complete, retry `colcon test-result --all`.