Skip to main content

Manage multiple repositories

Project description

tsrc
====

.. image:: https://travis-ci.org/TankerApp/tsrc.svg?branch=master
:target: https://travis-ci.org/TankerApp/tsrc

.. image:: https://badge.fury.io/py/tsrc.png
:target: https://pypi-hypernode.com/project/tsrc/

Manage multiple git repos.

License
-------

BSD

Demo
----

`tsrc demo on asciinema.org <https://asciinema.org/a/131625>`_

Screenshots
-----------

* ``tsrc sync``

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

* ``tsrc log``

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


Documentation
--------------

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


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


Why not Google repo?
-------------------

See the `FAQ <https://tankerapp.github.io/tsrc/faq/#why_not_repo>`_


Project details


Download files

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

Source Distribution

tsrc-0.2.0.tar.gz (24.8 kB view details)

Uploaded Source

Built Distribution

tsrc-0.2.0-py3-none-any.whl (34.0 kB view details)

Uploaded Python 3

File details

Details for the file tsrc-0.2.0.tar.gz.

File metadata

  • Download URL: tsrc-0.2.0.tar.gz
  • Upload date:
  • Size: 24.8 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No

File hashes

Hashes for tsrc-0.2.0.tar.gz
Algorithm Hash digest
SHA256 72ef0c4fd9fa2c07ab2d5b4a4bc3d366fd2ea9bbf2a74be458e0330b5b26d8e9
MD5 203caf4c4ea700f6e004dba80cb17b04
BLAKE2b-256 2afe6bb9a148cb79315d53d8cd50e945b30d217aa4b42211386c3963d502c96f

See more details on using hashes here.

File details

Details for the file tsrc-0.2.0-py3-none-any.whl.

File metadata

File hashes

Hashes for tsrc-0.2.0-py3-none-any.whl
Algorithm Hash digest
SHA256 dfe7d532995feef5602fa91a229c8b61bb2d67059cecd1a7a192573be9cb17fe
MD5 40fb89178ef2c10063ffb4e1dbcd0b19
BLAKE2b-256 7e06aa54402033ba1867564afed210e371a5fbf0441c4b80b471f0599a162219

See more details on using hashes here.

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page