{"id":22531,"library":"vcstool","title":"vcstool","description":"A command line tool for invoking VCS commands (git, hg, bzr, svn) on multiple repositories in parallel. Useful for managing workspace with many repositories. Version 0.3.0. Release cadence is low, stable.","status":"active","version":"0.3.0","language":"python","source_language":"en","source_url":"https://github.com/dirk-thomas/vcstool","tags":["vcs","git","mercurial","bazaar","subversion","repository","workspace"],"install":[{"cmd":"pip install vcstool","lang":"bash","label":"Standard install"}],"dependencies":[],"imports":[{"note":"","wrong":"","symbol":"vcstool","correct":"import vcstool"}],"quickstart":{"code":"import vcstool\n# vcstool is primarily a CLI tool vcs; Python API is limited\n# Example: parse a .repos file\nfrom vcstool import config\nrepos = config.load('.repos')\nprint(repos)","lang":"python","description":"Load a .repos file using the Python API."},"warnings":[{"fix":"Use 'vcs import < .repos' etc. instead of the Python API when possible.","message":"vcstool is primarily a CLI tool. The Python API is not fully stable and lacks documentation. Prefer using the 'vcs' command directly in shell scripts or CI.","severity":"gotcha","affected_versions":"all"},{"fix":"Install required VCS tools (e.g., 'apt-get install git mercurial subversion').","message":"vcstool requires installed VCS tools (git, hg, bzr, svn) on PATH. If a VCS is missing, commands for that type silently fail or error.","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":"Run 'pip install vcstool --upgrade' or install from source: 'pip install git+https://github.com/dirk-thomas/vcstool.git'","cause":"vcstool is not installed or pip install failed due to missing setup.py in some environments.","error":"ImportError: No module named vcstool"},{"fix":"Install with 'pip install --user vcstool' and ensure ~/.local/bin is in PATH, or use 'python -m vcstool' instead.","cause":"vcstool's console script 'vcs' not in PATH after pip install (user install vs system install).","error":"vcs: command not found"}],"ecosystem":"pypi","meta_description":null,"install_score":null,"install_tag":null,"quickstart_score":null,"quickstart_tag":null}