Registry / devops / colcon-devtools

colcon-devtools

library0.3.0pypypiunverified

colcon-devtools is an extension for the `colcon` build tool, providing commands and information about `colcon`'s extension points and installed extensions. It is currently at version 0.3.0. Its release cadence is generally aligned with the development of `colcon` itself, often releasing new versions alongside `colcon` or when new features or fixes are needed for its core functionality.

devops testing

pip install colcon-devtools

github ↗package ↗homepage ↗changelog ↗

INSTALL

IMPORT

SIG · COLCON-DEVTOOLS

colcon-devtools

devopspythonv0.3.0

harness data pending

Install & Compatibility

Where this runs

No compatibility data collected yet for this library.

Code

Verified usage

This quickstart first installs both `colcon-core` and `colcon-devtools`, then demonstrates a core functionality: listing all discovered `colcon` extensions, including those provided by `colcon-devtools`, with verbose output.

pip install colcon-core colcon-devtools colcon devtools extensions --verb

colcon --version

Debug

Known issues

gotcha`colcon-devtools` commands are subcommands of `colcon`. They will not be available if `colcon-core` is not installed or not accessible in your PATH.

fix

Ensure `colcon-core` is installed in the same Python environment: `pip install colcon-core colcon-devtools`

affects: All versions

gotchaAs an extension, `colcon-devtools` relies on the internal APIs of `colcon-core`. Significant changes in `colcon-core`'s major versions might require an update to `colcon-devtools` for compatibility, even if it doesn't explicitly declare a strict version dependency.

fix

If encountering issues after updating `colcon-core`, try upgrading `colcon-devtools` to its latest version: `pip install colcon-devtools --upgrade`

affects: All versions, especially across `colcon-core` major versions

Errors

Common errors & fixes

colcon: command not found

The `colcon` executable is not installed or not in your system's PATH. `colcon-devtools` provides extensions *to* `colcon`, not a standalone executable.

fix

First install `colcon-core`: `pip install colcon-core`. Ensure your Python environment's scripts directory is in your system's PATH.

colcon: error: unrecognized arguments: devtools

The `colcon-devtools` package is not correctly installed or `colcon` cannot find its extensions. This often happens if installed in a different virtual environment or if there's an issue with the `colcon` extension discovery mechanism.

fix

Ensure both `colcon-core` and `colcon-devtools` are installed in the same Python environment: `pip install colcon-core colcon-devtools --upgrade`.

Upgrade

Version history

0.3.0latest on PyPI · released Mar 13, 2024

Audit

Dependencies

colcon-corerequired`colcon-devtools` is an extension for `colcon`, requiring `colcon-core` to provide its functionality as `colcon` subcommands.

Agent activity

7 hits · last 30 days

node

OpenAI (training)

Resources

githubhttps://github.com/colcon/colcon-devtools ↗

packagehttps://pypi.org/project/colcon-devtools/ ↗

homepagehttps://colcon.readthedocs.io ↗

changeloghttps://github.com/colcon/colcon-devtools/milestones?direction=desc&sort=due_date&state=closed ↗