{"id":21056,"library":"colcon-argcomplete","title":"colcon-argcomplete","description":"Provides shell tab-completion for colcon (the Collective Construction tool for ROS) using the argcomplete library. Version 0.3.3 is the latest; released sporadically, last updated in 2022.","status":"active","version":"0.3.3","language":"python","source_language":"en","source_url":"https://github.com/colcon/colcon-argcomplete","tags":["colcon","argcomplete","ROS","tab-completion"],"install":[{"cmd":"pip install colcon-argcomplete","lang":"bash","label":"Install from PyPI"}],"dependencies":[{"reason":"Required for completion support.","package":"argcomplete","optional":false}],"imports":[{"note":"Direct import from the package.","symbol":"activate_argcomplete","correct":"from colcon_argcomplete import activate_argcomplete"}],"quickstart":{"code":"from colcon_argcomplete import activate_argcomplete\nimport argparse\n\nparser = argparse.ArgumentParser()\nactivate_argcomplete(parser)\nargs = parser.parse_args()\nprint(args)","lang":"python","description":"Activate argcomplete for a custom colcon command parser."},"warnings":[{"fix":"Install argcomplete and run: eval \"$(register-python-argcomplete colcon)\"","message":"Requires the argcomplete Python package to be installed and activated (e.g., eval \"$(register-python-argcomplete colcon)\") in your shell.","severity":"gotcha","affected_versions":"all"},{"fix":"Use the full path to colcon or ensure the symlink resolves correctly.","message":"Completion only works when colcon is invoked directly, not through symlinks or aliases.","severity":"gotcha","affected_versions":"all"},{"fix":"Monitor the colcon-argcomplete GitHub repo for compatibility.","message":"This package is part of the colcon ecosystem and may not receive updates if argcomplete changes its API.","severity":"deprecated","affected_versions":"0.3.x"}],"env_vars":null,"last_verified":"2026-04-27T00:00:00.000Z","next_check":"2026-07-26T00:00:00.000Z","problems":[{"fix":"pip install colcon-argcomplete","cause":"Package not installed or installed in a different Python environment.","error":"ModuleNotFoundError: No module named 'colcon_argcomplete'"},{"fix":"Run: eval \"$(register-python-argcomplete colcon)\"","cause":"Argcomplete not activated in the shell or missing from PATH.","error":"RuntimeError: Completion not registered. Ensure 'argcomplete' is installed and activated."}],"ecosystem":"pypi","meta_description":null,"install_score":null,"install_tag":null,"quickstart_score":null,"quickstart_tag":null}