tsrc: manage groups of git repositories

Overview

tsrc is a command-line tool that helps you manage groups of several git repositories.

It can be seen in action on asciinema.org.

Requirements

Python 3.7 or later

Installation

Use pipx (recommended) or pip (ok, if you know what you're doing) to install.

Please see the installation docs for more info.

Usage Example

Create a manifest repository. (git@example.org/manifest.git)
Add a file named manifest.yml at the root of the manifest repository.

manifest.yml:

repos:
  - url: git@example.com/foo.git
    dest: foo

  - url: git@example.com/bar.git
    dest: bar

It is convenient while optional to include the manifest repository itself in your manifest.yml. It will allow you to have a local copy of you manifest repository to easily make changes to it in the future.

commit your manifest.yml and push the changes to the manifest repository.
Create a new workspace with all the repositories listed in the manifest:

$ tsrc init git@git.local/manifest.git

:: Configuring workspace in /path/to/work
...
=> Cloning missing repos
* (1/2) foo
...
* (2/2) bar
...
: Configuring remotes
Done ✓

Synchronize all the repositories in the workspace:

$ tsrc sync
=> Updating manifest
...
:: Configuring remotes
:: Synchronizing workspace
* (1/2) foo
=> Fetching origin
=> Updating branch
Already up to date
* (2/2) bar
=> Updating branch
Updating 29ac0e1..b635a43
Fast-forward
 bar.txt | 1 +
 1 file changed, 1 insertion(+)
 create mode 100644 bar.txt
Done ✓

Documentation

For more details and examples, please refer to tsrc documentation.

Release notes

Detailed changes for each release are documented in the changelog.

Contributing

We welcome feedback, bug reports, and bug fixes in the form of pull requests.

Detailed instructions can be found in the documentation.

License

tsrc is licensed under a BSD 3-Clause license.

History

This project was originally hosted on the TankerHQ organization, which was dmerejkowsky's employer from 2016 to 2021. They kindly agreed to give back ownership of this project to Dimitri in 2021 - thanks! Dimitri later on shared this project even more by moving it to the your-tools organization.

Metadata

Release files for tsrc 3.0.1

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 3.0.1
File	Size	Uploaded
tsrc-3.0.1.tar.gz	50.2 kB	Dec 26, 2023	Details

Built distribution (wheel)

Table of built distributions (wheels) for tsrc 3.0.1
File	Interpreter	ABI	Platform	Reset
tsrc-3.0.1-py3-none-any.whl 67.8 kB Dec 26, 2023	Python 3	none	any	Details

Total release size: 118.0 kB

Release files / tsrc-3.0.1.tar.gz

Download URL	tsrc-3.0.1.tar.gz
Size	50.2 kB
Tags	Source
SHA-256 checksum How to use checksums	`17ac5fccb7682b994aeb9f1d5c7d5b8a640758250aad5142064674b9d72ed114`
BLAKE2b-256 checksum How to use checksums	`817f5fa93b54dd2e3387ac05ddad145e066b3466be609c71a83e870174dc3986`
Upload date	Dec 26, 2023
Uploaded using Trusted Publishing? What is trusted publishing?	No
Uploaded via	`poetry/1.7.1 CPython/3.11.6 Linux/6.6.7-arch1-1`

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

Download URL	tsrc-3.0.1-py3-none-any.whl
Size	67.8 kB
Tags	Python 3
SHA-256 checksum How to use checksums	`feae5effbcf7fa2fcd8948afaec1a12d9614bd54540ebd23147204d46d6479f8`
BLAKE2b-256 checksum How to use checksums	`574be915360a60f01270836dbd2a67048019c9b482d4eb4fa222ef982889a355`
Upload date	Dec 26, 2023
Uploaded using Trusted Publishing? What is trusted publishing?	No
Uploaded via	`poetry/1.7.1 CPython/3.11.6 Linux/6.6.7-arch1-1`