Skip to main content

Manage groups of git repositories

Project description

https://img.shields.io/github/license/dmerejkowsky/tsrc.svg https://github.com/dmerejkowsky/tsrc/workflows/tests/badge.svg https://github.com/dmerejkowsky/tsrc/workflows/linters/badge.svg https://img.shields.io/pypi/v/tsrc.svg https://img.shields.io/badge/deps%20scanning-pyup.io-green

tsrc: manage groups of git repositories

Overview · Installation · Usage example · Documentation · Release notes · Contributing · License

Note

This project was originally hosted on the TankerHQ organization, which was my employer from 2016 to 2021. They kindly agreed to give back ownership of this project to me. Thanks!

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.

Note

tsrc does not adhere strictly to the semver specification. So before upgrading to a new version, please take the time to read the Changelog first!

Installation

tsrc is available on pypi and can be installed via pipx. (Or pip if you know what you are doing).

It requires Python 3.6 or later.

Usage Example

  • Create a manifest repository. (git@example.org/manifest)

  • Push a file named manifest.yml looking like:

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

 -  url: git@example.com/bar.git
    dest: bar
  • 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.

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

Uploaded Source

Built Distribution

tsrc-2.4.1-py3-none-any.whl (65.4 kB view details)

Uploaded Python 3

File details

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

File metadata

  • Download URL: tsrc-2.4.1.tar.gz
  • Upload date:
  • Size: 48.5 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: poetry/1.1.11 CPython/3.9.7 Linux/5.13.0-20-generic

File hashes

Hashes for tsrc-2.4.1.tar.gz
Algorithm Hash digest
SHA256 9da5d1696fa7445706d1820349db0ab6d653b97f917b9e807060066a9e3d5287
MD5 336ece3428e60e055999def8bb6aca16
BLAKE2b-256 48df1c299ca8e5c3a43071659d7d769d518dcee2fc273d4d3227f73cd6b97892

See more details on using hashes here.

File details

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

File metadata

  • Download URL: tsrc-2.4.1-py3-none-any.whl
  • Upload date:
  • Size: 65.4 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: poetry/1.1.11 CPython/3.9.7 Linux/5.13.0-20-generic

File hashes

Hashes for tsrc-2.4.1-py3-none-any.whl
Algorithm Hash digest
SHA256 4524a1842c9246686f7776008b303726eb5408ad043b1b060dc5f21d1ac18bd7
MD5 bee43fc50c8f3db784380f56f7e15f80
BLAKE2b-256 814f5e23c1be92510e14e1d530bf778aa76c4847d44f5c7f4d792f23d76865f2

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