Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/dmerejkowsky/tsrc
Manage groups of git repositories
https://github.com/dmerejkowsky/tsrc
cli git github gitlab python
Last synced: 14 days ago
JSON representation
Manage groups of git repositories
- Host: GitHub
- URL: https://github.com/dmerejkowsky/tsrc
- Owner: your-tools
- License: bsd-3-clause
- Created: 2017-07-21T12:29:59.000Z (over 7 years ago)
- Default Branch: main
- Last Pushed: 2024-10-25T09:00:15.000Z (about 2 months ago)
- Last Synced: 2024-11-30T23:37:11.961Z (22 days ago)
- Topics: cli, git, github, gitlab, python
- Language: Python
- Homepage: https://your-tools.github.io/tsrc/
- Size: 2.84 MB
- Stars: 206
- Watchers: 6
- Forks: 36
- Open Issues: 34
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
[](https://github.com/your-tools/tsrc/blob/main/LICENSE)
[](https://github.com/your-tools/tsrc/actions)
[](https://github.com/your-tools/tsrc/actions)
[](https://pypi.org/project/tsrc/)
[](https://github.com/your-tools/tsrc/actions)
# 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](https://asciinema.org/a/131625).
## Requirements
Python **3.8** or later
## Installation
Use `pipx` (recommended) or `pip` (ok, if you know what you're doing) to install.
Please see the [installation docs](https://your-tools.github.io/tsrc/getting-started/#installing_tsrc) for more info.
## Usage Example
- Create a *manifest* repository. (`[email protected]/manifest.git`)
- Add a file named `manifest.yml` at the root of the *manifest*
repository.
`manifest.yml`:
```yaml
repos:
- url: [email protected]/foo.git
dest: foo
- url: [email protected]/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:
```console
$ tsrc init [email protected]/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:
```console
$ 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](https://your-tools.github.io/tsrc/).
## Release notes
Detailed changes for each release are documented in the [changelog](https://your-tools.github.io/tsrc/changelog/).
## Contributing
We welcome feedback, [bug reports](https://github.com/your-tools/tsrc/issues), and bug fixes in the form of [pull requests](https://github.com/your-tools/tsrc/pulls).
Detailed instructions can be found [in the documentation](https://your-tools.github.io/tsrc).
## License
tsrc is licensed under a [BSD 3-Clause license](https://github.com/your-tools/tsrc/blob/main/LICENSE).
## History
This project was originally hosted on the [TankerHQ](https://github.com/TankerHQ) organization, which was [dmerejkowsky](https://github.com/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](https://github.com/your-tools) organization.