colcon-recursive-crawl is an extension for colcon, the build tool for ROS and other package-based systems, enabling it to recursively discover packages within a specified directory structure. As of version 0.2.3, it enhances colcon's package discovery capabilities without requiring manual listing. Releases are infrequent, tied to specific feature additions or compatibility updates with `colcon-core`.
pip install colcon-recursive-crawlNo compatibility data collected yet for this library.
This quickstart demonstrates how to use `colcon-recursive-crawl` to build packages found in a nested directory structure. The extension adds the `--recursive-crawl` argument to standard colcon verbs like `build`, `test`, or `install`. This example sets up a simple `src` directory with two dummy packages for testing.
Ensure `pip install colcon-core` has been run before using `colcon-recursive-crawl`.
Correct usage: `colcon build --recursive-crawl src`. Incorrect: `colcon --recursive-crawl build src`.
Update `colcon-recursive-crawl` to its latest version (`pip install --upgrade colcon-recursive-crawl`) after upgrading `colcon-core`. Consult `colcon-recursive-crawl`'s GitHub for specific compatibility notes.
Install the extension using `pip install colcon-recursive-crawl`. Ensure the Python environment where `colcon-core` is installed is active.
Verify that `package.xml` files exist in the expected package directories within `<your/path>` and that they are correctly formatted according to ROS package standards. Check for typos in the path.
Install `colcon-core` using `pip install colcon-core`. If already installed, ensure your shell environment is correctly configured to include the Python script path in your system's PATH variable.