The vcstools module provides a Python API for interacting with different version control systems (VCS/SCMs).

See http://www.ros.org/doc/api/vcstools/html

Install the latest release on Ubuntu using apt-get:

$ sudo apt-get install vcstools

On other Systems, use the pypi package:

$ pip install vcstools

source setup.sh to include the src folder in your PYTHONPATH.

Use the python library nose to test:

$ nosetests

To test with coverage, make sure to have python-coverage installed and run:

$ nosetests --with-coverage --cover-package vcstools

To run python3 compatibility tests, run either:

$ nosetests3
$ python3 -m unittest discover --pattern*.py