A command-line tool to view multiple git repos
In the presence of multiple related git repos, it helps to see their status (branch, modification) side by side, as in the following screenshot:
Here the color codings denote the 5 situations between local and remote branches:
- white: the local branch has no remote branch.
- green: the local branch is the same as the remote branch.
- red: the local branch has diverged from the remote branch.
- purple: the local branch is ahead of the remote branch (good for push).
- yellow: the local branch is behind the remote branch (good for merge).
The color choices of purple for ahead and yellow for behind is motivated by blueshift and redshift.
The extra status symbols have the following meaning:
+: staged change exists*: unstaged change exists
The supported commands are
gita add <repo-path>: add repo togitagita rm <repo-name>: remove repo fromgitagita ls: display the status of all reposgita ls <repo-name>: display the absolute path of the specified repogita fetch: fetch all remote updatesgita fetch <repo-name(s)>: fetch remote updates for the specified repo(s)gita pull <repo-name(s)>: pull remote updates for the specified repo(s)gita merge <repo-name(s)>: merge remote updates for the specified repo(s)gita push <repo-name(s)>: push local updates of the specified repo(s) to remote
The repo paths are saved in ~/.gita_path
installation
To install, simply use pip3
pip3 install gita
Alternatively, you can download the source code and run pip3 install -e <gita source folder>.
I also put the following line in my .bashrc file
alias gita="python3 -m gita"
TODO
- auto-completion
Release files for gita 0.4.1
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | |
|---|---|---|---|
| gita-0.4.1.tar.gz | 4.1 kB | Details |
Release files / gita-0.4.1.tar.gz
| Download URL | gita-0.4.1.tar.gz |
|---|---|
| Size | 4.1 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
fb45843e397756da811c970d1df46e61c7c12c599bd97ced6598bc87cefb7720
|
|
BLAKE2b-256 checksum How to use checksums |
48f87ed3bd3ce54e32358c0767158f23c29fd57d937ee99b803d34451b5984b9
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |