Registry / devops / colcon-package-selection

colcon-package-selection

library0.2.10pypypiunverified

colcon-package-selection is an extension for colcon, a build tool primarily used in the Robot Operating System (ROS) ecosystem, to allow users to precisely select which packages should be processed during build, test, or install operations. It enhances colcon's core functionality by providing command-line arguments for including or excluding packages based on names or dependencies. The current version is 0.2.10. It follows the colcon core release cadence, typically tied to ROS releases or when new features/fixes are required.

devops

pip install colcon-package-selection

github ↗package ↗homepage ↗changelog ↗

INSTALL

IMPORT

SIG · COLCON-PACKAGE-SEL

colcon-package-selection

devopspythonv0.2.10

Install

5.1s avg

Import

—

Disk

40MB

Pass rate

10/ 10

Env Coverage10 / 10

glibc

3.9–3.13

musl

3.9–3.13

Install & Compatibility

Where this runs

tested against v0.2.10 · pip install

no network on importno background threads

Install × environment matrix

Each cell = how many times install + import succeeded across repeated harness runs. Partial = flaky.
glibc = Debian/Ubuntu slim · musl = Alpine Linux

musl

py 3.10–3.910 runs

installs and imports cleanly · install 0.0s · import 0.000s · 37.5MB

glibc

py 3.10–3.910 runs

installs and imports cleanly · install 5.1s · import 0.000s · 38MB

40MB installed

● package 40MB

Code

Verified usage

Verified import paths — ran on the pinned version, not inferred.

colcon-package-selection CLI

✓ colcon build --packages-select PACKAGE_NAME

✗ from colcon_package_selection import some_internal_class

This library is primarily an extension to the `colcon` command-line interface. Users interact with its functionality via `colcon` arguments (e.g., `--packages-select`), not through direct Python imports into user code. Attempting to import internal classes is generally incorrect for typical usage.

Demonstrates building a single package (`my_robot_pkg`) and its direct dependencies using `--packages-select`. This is the primary way to interact with `colcon-package-selection`. Ensure `colcon-package-selection` is installed and your `my_robot_pkg` is discoverable in the current workspace.

colcon build --packages-select my_robot_pkg

colcon --version

Debug

Known issues

gotchaUsing `--packages-select` only builds the specified packages, *not* their recursive dependencies. To build a package and all its dependencies, use `--packages-up-to`.

fix

Switch from `colcon build --packages-select PKG` to `colcon build --packages-up-to PKG` when a full dependency chain build is desired.

affects: All versions

gotchaArguments like `--packages-skip` take precedence over `--packages-select`. If a package is both selected and skipped, it will be skipped.

fix

Review your `colcon` command line for conflicting package selection arguments. Ensure `--packages-skip` is not unintentionally overriding a desired `--packages-select` target.

affects: All versions

gotchaWhen using shell globs (e.g., `colcon build --packages-select 'my_pkg_*'`), be aware that your shell might expand the glob before `colcon` processes it, potentially leading to incorrect selection or command-line length issues.

fix

Always quote your package patterns (e.g., `colcon build --packages-select 'my_pkg*'` or use colcon's `--regex` option if available for more complex patterns. Consult `colcon`'s documentation for specific pattern matching capabilities.

affects: All versions

Upgrade

Version history

0.2.10latest on PyPI · released Oct 6, 2020

Audit

Dependencies

colcon-corerequiredThis library is an extension to colcon, requiring colcon-core for its functionality.

Agent activity

25 hits · last 30 days

node

Resources

githubhttps://github.com/colcon/colcon-package-selection ↗

packagehttps://pypi.org/project/colcon-package-selection/ ↗

homepagehttps://colcon.readthedocs.io ↗

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