tsrc 0.6.1

Manage multiple repositories

Demo

tsrc demo on asciinema.org

Documentation

See https://supertanker.github.io/tsrc/

Screenshots

• tsrc sync

• tsrc log

Tutorial

Getting started

• Make sure you are using Python3.4 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 on GitLab

• 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 active user>

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

  $ tsrc push --accept

Managing Pull Requests on GitHub

• Start working on your branch

• Run tsrc push once. You will be prompted for your login and password (then a token will be saved so you don’t have to authenticate again). The pull request will be created.

You can use the --reviewer option several times to request reviews from your team mates. You can also assign someone to the pull request with the --assign option.

Then you can use tsrc push --merge to merge the pull request, or tsrc push --close to close it.

Why not Google repo?

See the FAQ