Skip to main content

Manage multiple repositories

Project description

https://travis-ci.org/TankerApp/tsrc.svg?branch=master https://badge.fury.io/py/tsrc.png

Manage multiple git repos.

Screenshots

  • tsrc sync
https://dmerej.info/blog/pics/tsrc-sync.png
  • tsrc log
https://dmerej.info/blog/pics/tsrc-log.png

Tutorial

Getting started

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

  • Install tsrc with pip3 as usual.

  • 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
    
  • 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 git@example.com:foo.git origin url.
  • Similarly, bar will be cloned in <workspace>/bar using git@example.com/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

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Files for tsrc, version 0.1.4
Filename, size File type Python version Upload date Hashes
Filename, size tsrc-0.1.4-py3-none-any.whl (32.3 kB) File type Wheel Python version py3 Upload date Hashes View hashes
Filename, size tsrc-0.1.4.tar.gz (23.1 kB) File type Source Python version None Upload date Hashes View hashes

Supported by

Elastic Elastic Search Pingdom Pingdom Monitoring Google Google BigQuery Sentry Sentry Error logging AWS AWS Cloud computing DataDog DataDog Monitoring Fastly Fastly CDN DigiCert DigiCert EV certificate StatusPage StatusPage Status page