tsrc · PyPI

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.org/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>`_

Metadata

Release files for tsrc 0.2.0

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for tsrc 0.2.0
File	Size	Uploaded
tsrc-0.2.0.tar.gz	24.8 kB	Aug 9, 2017	Details

Built distribution (wheel)

Table of built distributions (wheels) for tsrc 0.2.0
File	Interpreter	ABI	Platform	Reset
tsrc-0.2.0-py3-none-any.whl 34.0 kB Aug 9, 2017	Python 3	none	any	Details

Total release size: 58.8 kB

Release files / tsrc-0.2.0.tar.gz

Download URL	tsrc-0.2.0.tar.gz
Size	24.8 kB
Tags	Source
SHA-256 checksum How to use checksums	`72ef0c4fd9fa2c07ab2d5b4a4bc3d366fd2ea9bbf2a74be458e0330b5b26d8e9`
BLAKE2b-256 checksum How to use checksums	`2afe6bb9a148cb79315d53d8cd50e945b30d217aa4b42211386c3963d502c96f`
Upload date	Aug 9, 2017
Uploaded using Trusted Publishing? What is trusted publishing?	No

Release files / tsrc-0.2.0-py3-none-any.whl

Download URL	tsrc-0.2.0-py3-none-any.whl
Size	34.0 kB
Tags	Python 3
SHA-256 checksum How to use checksums	`dfe7d532995feef5602fa91a229c8b61bb2d67059cecd1a7a192573be9cb17fe`
BLAKE2b-256 checksum How to use checksums	`7e06aa54402033ba1867564afed210e371a5fbf0441c4b80b471f0599a162219`
Upload date	Aug 9, 2017
Uploaded using Trusted Publishing? What is trusted publishing?	No