tsrc: manage multiple repos / review automation

Overview · Installation · Usage example · Documentation · Release notes · Contributing · License

Overview

tsrc is a command-line tool that helps you manage groups of several git repositories. It also provides some code review automation.

In can be seen in action on asciinema.org.

Installation

tsrc is available on pypi an can be installed via pip. It requires Python 3.4 or later.

Usage Example

• Create a manifest repository. (git@example.org/manifest)
• Push a file named manifest.yml looking like:

repos:
  - src: foo
    url: git@example.com/foo.git

  - src: bar
    url: git@example.com/bar.git

• Create a new workspace with all the repositories listed in the manifest:

$ tsrc init git@git.local/manifest.git

:: Configuring workspace in /path/to/work
...
=> Cloning missing repos
* (1/2) foo
...
* (2/2) bar
...
: Configuring remotes
Done ✓

• Synchronize all the repositories in the workspace:

$ tsrc sync
=> Updating manifest
...
:: Configuring remotes
:: Synchronizing workspace
* (1/2) foo
=> Fetching origin
=> Updating branch
Already up to date
* (2/2) bar
=> Updating branch
Updating 29ac0e1..b635a43
Fast-forward
 bar.txt | 1 +
 1 file changed, 1 insertion(+)
 create mode 100644 bar.txt
Done ✓

• Push current branch for review:

$ cd bar
$ git checkout new-feature
# hackity hack
$ tsrc push
=> Running git push
Branch 'new-feature' set up to track remote branch 'new-feature' from 'origin'.
Everything up-to-date
=> Creating merge request
:: See merge request at https://github.com/foo/bar/pull/42

Documentation

For more details and examples, please refer to tsrc documentation.

Release notes

Detailed changes for each release are documented in the changelog.

Contributing

We welcome feedback, bug reports, and bug fixes in the form of pull requests.

Detailed instructions can be found in the documentation.

License

tsrc is licensed under a BSD 3-Clause license.