{"id":9603,"library":"colcon-output","title":"colcon-output","description":"colcon-output is an extension for the colcon build tool, primarily used in the ROS ecosystem, to customize and enhance the terminal output in various ways. It provides alternative output formats like 'log' for more detailed logs and 'json' for machine-readable output. The current version is 0.2.14, and it follows an infrequent, feature-driven release cadence, typically aligning with `colcon-core` updates.","status":"active","version":"0.2.14","language":"en","source_language":"en","source_url":"https://github.com/colcon/colcon-output/","tags":["colcon","build-tool","output-formatting","ros","ci-cd"],"install":[{"cmd":"pip install colcon-output","lang":"bash","label":"Install colcon-output"}],"dependencies":[{"reason":"colcon-output is an extension and requires the colcon core build tool to function.","package":"colcon-core","optional":false}],"imports":[{"note":"colcon-output is a colcon extension, not a library meant for direct programmatic import by end-user applications. Its features are accessed through the `colcon` command-line interface.","wrong":"from colcon_output import SomeClass","symbol":"colcon-output functionality","correct":"Functionality is enabled via colcon CLI arguments or configuration, not direct Python imports."}],"quickstart":{"code":"# Assuming you have a colcon workspace with a package (e.g., 'my_package')\n# Build with the 'log' output format for detailed messages\n# (Often used in CI/CD or when debugging verbose output)\ncolcon build --packages-select my_package --output-format log\n\n# Build with the 'json' output format for machine-readable results\n# (Useful for parsing build status in scripts)\ncolcon build --packages-select my_package --output-format json","lang":"bash","description":"This quickstart demonstrates how to use the `colcon-output` extension by specifying different output formats during a `colcon build` command. The `--output-format` argument allows you to switch between available formats like `standard`, `log`, `json`, or `json_verbose`."},"warnings":[{"fix":"Access `colcon-output` features through `colcon` command-line arguments (e.g., `--output-format`) or `colcon` configuration files, not via direct Python imports in user code.","message":"colcon-output is an extension, not a standalone library. Trying to `import colcon_output` directly in user scripts for its functionality will not work as expected, as its features are exposed through the `colcon` CLI.","severity":"gotcha","affected_versions":"All versions"},{"fix":"For fine-tuning color darkening, set the `COLCON_COLOR_DARKEN_THRESHOLD` environment variable (e.g., `export COLCON_COLOR_DARKEN_THRESHOLD=10`). Ensure your terminal supports 256-color output. In CI environments, you might need to force color output if it's automatically disabled.","message":"Color output may appear inconsistent or be disabled in certain terminal environments or CI/CD pipelines. This can be influenced by terminal capabilities or specific environment variables.","severity":"gotcha","affected_versions":"All versions"},{"fix":"Always ensure your `colcon-output` version is compatible with your `colcon-core` version. Check the `colcon-output` release notes and `colcon-core` documentation for specific compatibility matrices. Update both packages regularly (`pip install --upgrade colcon-core colcon-output`).","message":"Compatibility with `colcon-core` versions is crucial. Using an outdated `colcon-output` with a very new `colcon-core` (or vice-versa) might lead to unexpected behavior or missing features.","severity":"gotcha","affected_versions":"<0.2.0"}],"env_vars":null,"last_verified":"2026-04-17T00:00:00.000Z","next_check":"2026-07-16T00:00:00.000Z","problems":[{"fix":"Ensure `colcon-output` is installed in the same Python environment as `colcon-core` using `pip install colcon-output`. Verify installation with `pip list | grep colcon-output`.","cause":"`colcon-output` is not installed or not correctly recognized by `colcon`.","error":"colcon: error: unrecognized arguments: --output-format"},{"fix":"Use one of the officially supported output formats listed in the error message. Refer to the `colcon-output` documentation or its `--help` output for a current list of available formats.","cause":"An invalid or misspelled output format was provided to the `--output-format` argument.","error":"Unknown output format 'my_custom_format'. Valid formats are: ['standard', 'log', 'json', 'json_verbose']"},{"fix":"Try reinstalling `colcon-output` and `colcon-core` (`pip uninstall colcon-output colcon-core && pip install colcon-output colcon-core`). Ensure your Python environment is clean and correctly activated.","cause":"Plugin loading issue, often due to corrupted installation or environment path problems.","error":"Error: Failed to load entry point 'some_entry_point' for 'colcon_core.plugin.some_type'"}]}