Skip to main content

Manage groups of git repositories

Project description

image

image

image

image

image

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.

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-3.0.1.tar.gz (50.2 kB view details)

Uploaded Source

Built Distribution

tsrc-3.0.1-py3-none-any.whl (67.8 kB view details)

Uploaded Python 3

File details

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

File metadata

  • Download URL: tsrc-3.0.1.tar.gz
  • Upload date:
  • Size: 50.2 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: poetry/1.7.1 CPython/3.11.6 Linux/6.6.7-arch1-1

File hashes

Hashes for tsrc-3.0.1.tar.gz
Algorithm Hash digest
SHA256 17ac5fccb7682b994aeb9f1d5c7d5b8a640758250aad5142064674b9d72ed114
MD5 5a229e2bc45c3fd3fe8ef7e85d5be7e3
BLAKE2b-256 817f5fa93b54dd2e3387ac05ddad145e066b3466be609c71a83e870174dc3986

See more details on using hashes here.

File details

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

File metadata

  • Download URL: tsrc-3.0.1-py3-none-any.whl
  • Upload date:
  • Size: 67.8 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: poetry/1.7.1 CPython/3.11.6 Linux/6.6.7-arch1-1

File hashes

Hashes for tsrc-3.0.1-py3-none-any.whl
Algorithm Hash digest
SHA256 feae5effbcf7fa2fcd8948afaec1a12d9614bd54540ebd23147204d46d6479f8
MD5 f717a15a9c04ec5752570712102df99d
BLAKE2b-256 574be915360a60f01270836dbd2a67048019c9b482d4eb4fa222ef982889a355

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