tsrc 0.1.4

Manage multiple repositories

Manage multiple git repos.

Demo

tsrc demo on asciinema.org

Screenshots

• tsrc sync

• tsrc log

Tutorial

Getting started

• Make sure you are using Python3.3 or higher.

• Install tsrc with pip3 as usual.

• Create a manifest repository. ([e-mail]/manifest)

• Push a file named manifest.yml looking like:

  repos:
    - src: foo
      url: [e-mail]/foo.git
  
    - src: bar
      url: [e-mail]/bar.git

• Clone the repositories with:

  $ mkdir workspace
  $ cd workspace
  $ tsrc init git@example/manifest.git

In this example:

• foo will be cloned in <workspace>/foo using [e-mail]:foo.git origin url.

• Similarly, bar will be cloned in <workspace>/bar using [e-mail]/bar.git

Managing Merge Requests

• Generate a token from GitLab

• Add the http url to the manifest:

  gitlab:
    url: http://gitlab.local

• Create a ~/.config/tsrc.yml looking like:

  auth:
    gitlab:
      token: <YOUR TOKEN>

• Start working on your branch

• Create the pull request:

  $ tsrc push --assignee <an octive user>

• When the review is done, tell GitLab to merge it once the CI passes:

  $ tsrc push --accept

Differences with google repo

We used repo for a while, but found that tsrc had both a better command line API and a nicer output.

On a less subjective level:

• Good support for Windows (no need for cygwin or anything like that)

• GitLab support (automate working with merge requests)

• Lastly, tsrc tries hard to never do any destructive operation or unexpected actions.

  For instance, tsrc never puts you in a “detached HEAD” state, nor does automatic rebases. It also never touches dirty repos.

  This is achieved by using mostly ‘porcelain’ commands from git, instead of relying on plumbings internals.

Also (and this matters a lot if you think about contribution):

• Comprehensive test suite

• Uses PEP8 coding style

• Written in Python 3, not Python 2

Here are a few features present in repo that are missing from tsrc (but may be implemented in the future)

• Cloning a specific branch (but see PR #7)

• Cloning a revision or tag

• Cloning several repositories in parallel

• Cloning just one or several groups of repositories

• Support for other hosting services such as gerrit or github