Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/rustworkshop/gitopolis
Manage multiple git repositories
https://github.com/rustworkshop/gitopolis
git
Last synced: 3 months ago
JSON representation
Manage multiple git repositories
- Host: GitHub
- URL: https://github.com/rustworkshop/gitopolis
- Owner: rustworkshop
- License: agpl-3.0
- Created: 2022-06-11T09:35:05.000Z (over 2 years ago)
- Default Branch: main
- Last Pushed: 2024-05-15T19:22:33.000Z (6 months ago)
- Last Synced: 2024-05-16T02:42:24.089Z (6 months ago)
- Topics: git
- Language: Rust
- Homepage:
- Size: 286 KB
- Stars: 20
- Watchers: 4
- Forks: 2
- Open Issues: 7
-
Metadata Files:
- Readme: README.md
- Funding: .github/FUNDING.yml
- License: LICENSE
Awesome Lists containing this project
- project-awesome - rustworkshop/gitopolis - Manage multiple git repositories (Rust)
README
# Gitopolis
Manage multiple git repositories with ease.
* 🤓 -> Run any shell or git command on multiple `git` repositories.
* 🤓 -> Re-clone all your repos on new machines.
* 🤓 -> Limit actions to custom tags.
* 🤓 -> Easy to remember and use command list (`add` / `exec` / `clone` / `tag`).
* 🤓 -> A-GPL v3 licensed labour of love ❤️.
## Installation
1. Grab the [latest release](https://github.com/timabell/gitopolis/releases/latest),
2. unzip it
3. put the binary somewhere in your `PATH`.
I suggest adding a shorter shell alias to save typing. Perhaps `gm` for git many or `gop`.
## Usage
### Initial setup
```sh
cd ~/repos/
gitopolis add *
```
### Running shell / git commands in many repos
```sh
gitopolis exec -- git pull
```
### Tagging
```sh
gitopolis tag some_tag repo1 repo2
gitopolis exec -t some_tag -- git pull
```
### Re-cloning repos on a new machine
```sh
mkdir ~/repos/ && cd ~/repos/
wget https://gist.githubusercontent.com/timabell/87add070a8a44db4985586efe380757d/raw/08be5b3c38190eeed4fda0060818fa39f3c67ee3/.gitopolis.toml
gitopolis clone
```
### Using shell aliases
You can't currently use shell aliases because commands are executed directly rather than passing through a shell such as bash/zsh/fish. See .
As a workaround you can create git aliases that run arbitrary shell commands. See
### Using chained commands
You can't chain commands together with `&&` or `||` like this `gitopolis exec -- git branch && git pull` because the shell (bash etc) will parse the `&&` before it ever gets to gitopolis.
As a workaround you can create git aliases that run arbitrary shell commands. See
### State file
Creates a single simple `.gitopolis.toml` file that you can edit, read, share with others and copy to other machines.
```toml
[[repos]]
path = "gitopolis"
tags = ["tim"]
[repos.remotes.origin]
name = "origin"
url = "[email protected]:timabell/gitopolis.git"
[[repos]]
path = "schema-explorer"
tags = ["tim", "databases"]
[repos.remotes.origin]
name = "origin"
url = "[email protected]:timabell/schema-explorer.git"
[[repos]]
path = "database-diagram-scm"
tags = ["databases"]
[repos.remotes.origin]
name = "origin"
url = "[email protected]:timabell/database-diagram-scm.git"
```
[View as gist](https://gist.github.com/timabell/87add070a8a44db4985586efe380757d).
[TOML](https://toml.io/) is a well-supported config markup with parsers for many programming languages.
---
---
## The name
Think a [metropolis](https://en.wikipedia.org/wiki/Metropolis) of git repos.
It's a lot to type as a name, but it's nice and unique, and if you use it a lot I suggest you create a shell alias to something shorter.
## Why did I create this?
* Wanted to learn more [Rust](https://www.rust-lang.org/).
* Had a client with many microservices and teams.
* Tried [gita](https://github.com/nosarthur/gita) but found command layout hard to remember, and didn't like having to install python.
* To help others with their microservices.
## Social
Help others discover gitopolis:
### Twitter
[Tweet about gitopolis](http://twitter.com/share?text=Gitopolis%20is%20fab,%20check%20it%20out%20-%20made%20by%20@tim_abell&url=https://github.com/timabell/gitopolis)
### Product Hunt
Vote for gitopolis:
## Contributing
Suggestions welcome, particularly adding your experience, problems and ideas to the issues list.
I'm happy for people to open issues that are actually just questions and support queries.
Rough internal design and ambitions can be found at [Design.md](Design.md).
PRs are appreciated but bear in mind I have my own plans and this is a side project for me to learn rust in a useful way, so worth talking to me before investing too much time in anything that might not fit yet. I hope to make this smoother with better CI tests etc. Start by opening an issue with your thoughts, or ping me some other way (I'm easy to find for better or worse).
### Builds
* [](https://github.com/timabell/gitopolis/actions/workflows/build-main.yml) - Continuous integration build.
* [](https://github.com/timabell/gitopolis/actions/workflows/build-tag.yml) - Release build - generates binaries for download from tagged builds.