{"id":26845,"library":"colcon-cd","title":"colcon-cd","description":"A shell function for colcon that allows changing the current working directory to the package base path. It is part of the colcon ecosystem and used in ROS 2 development. Current version is 0.1.1, released infrequently.","status":"active","version":"0.1.1","language":"python","source_language":"en","source_url":"https://github.com/colcon/colcon-cd","tags":["colcon","ros2","shell","cd","build"],"install":[{"cmd":"pip install colcon-cd","lang":"bash","label":"PyPI"}],"dependencies":[],"imports":[{"note":"colcon-cd is a shell function, not a Python module; importing may not be intended.","symbol":"colcon_cd","correct":"from colcon_cd import __version__"}],"quickstart":{"code":"# colcon-cd is a shell function, not a Python library.\n# Source the shell completion or use it directly:\n# eval \"$(colcon cd)\"","lang":"bash","description":"colcon-cd provides a shell function; typical usage is via sourcing."},"warnings":[{"fix":"Use as a shell command: source colcon_cd hook or eval '$(colcon cd)'","message":"colcon-cd is a shell extension, not a Python module. Attempting to import it in Python will fail or be meaningless.","severity":"gotcha","affected_versions":"all"},{"fix":"Install colcon-core and ensure .bashrc or .zshrc sources colcon's shell completion.","message":"Requires colcon-core to be installed and the shell hook to be sourced before use.","severity":"gotcha","affected_versions":"all"}],"env_vars":null,"last_verified":"2026-04-27T00:00:00.000Z","next_check":"2026-07-26T00:00:00.000Z","problems":[{"fix":"colcon-cd is not a Python module; use it as a shell command instead.","cause":"Trying to import colcon-cd as a Python module.","error":"ModuleNotFoundError: No module named 'colcon_cd'"},{"fix":"Install colcon-core with pip install colcon-common-extensions.","cause":"colcon not installed or not in PATH.","error":"bash: colcon: command not found"}],"ecosystem":"pypi","meta_description":null,"install_score":null,"install_tag":null,"quickstart_score":null,"quickstart_tag":null}