vcstool

0.3.0 verified Mon Apr 27 auth: no python

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.

pip install vcstool

Common errors

error ImportError: No module named vcstool ↓

cause vcstool is not installed or pip install failed due to missing setup.py in some environments.

fix

Run 'pip install vcstool --upgrade' or install from source: 'pip install git+https://github.com/dirk-thomas/vcstool.git'

error vcs: command not found ↓

cause vcstool's console script 'vcs' not in PATH after pip install (user install vs system install).

fix

Install with 'pip install --user vcstool' and ensure ~/.local/bin is in PATH, or use 'python -m vcstool' instead.

Warnings

gotcha 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. ↓

fix Use 'vcs import < .repos' etc. instead of the Python API when possible.

gotcha vcstool requires installed VCS tools (git, hg, bzr, svn) on PATH. If a VCS is missing, commands for that type silently fail or error. ↓

fix Install required VCS tools (e.g., 'apt-get install git mercurial subversion').

Imports

vcstool
```
import vcstool
```

Quickstart

Load a .repos file using the Python API.

import vcstool
# vcstool is primarily a CLI tool vcs; Python API is limited
# Example: parse a .repos file
from vcstool import config
repos = config.load('.repos')
print(repos)