Manage multiple git repos
Project description
Gita: a command-line tool to manage multiple git repos
This tool does two things
- display the status of multiple git repos such as branch, modification, commit message side by side
- delegate git commands/aliases from any working directory
If several repos need to be compiled against each other, it helps to see their status together. I also hated to change directories to execute git commands.
Here the colors denote the 5 situations between local and remote branches:
- white: local branch has no remote branch
- green: local branch is the same as remote branch
- red: local branch has diverged from remote branch
- purple: local branch is ahead of remote branch (good for push)
- yellow: local branch is behind remote branch (good for merge)
The choice of purple for ahead and yellow for behind is motivated by blueshift and redshift, using green as baseline.
The additional status symbols denote
+
: staged changes*
: unstaged changes_
: untracked files/folders
The bookkeeping sub-commands are
gita add <repo-path(s)>
: add repo(s) togita
gita rm <repo-name>
: remove repo fromgita
(won't remove repo from disk)gita ls
: display the status of all reposgita ls <repo-name>
: display the absolute path of one repogita -v
: display gita version
Repo paths are saved in $XDG_CONFIG_HOME/gita/repo_path
(most likely ~/.config/gita/repo_path
).
The delegated git sub-commands are
gita branch <repo-name(s)>
: show local branches for the specified repo(s)gita clean <repo-name(s)>
: remove untracked files/folders for the specified repo(s)gita diff <repo-name(s)>
: show differences for the specified repo(s)gita difftool <repo-name(s)>
: show differences with tool for the specified repo(s)gita fetch
: fetch remote updates for all reposgita fetch <repo-name(s)>
: fetch remote updates for the specified repo(s)gita log <repo-name(s)>
: show log of the specified repo(s)gita merge <repo-name(s)>
: merge remote updates for the specified repo(s)gita patch <repo-name(s)>
: make a patch for the specified repo(s)gita pull <repo-name(s)>
: pull remote updates for the specified repo(s)gita push <repo-name(s)>
: push local updates of the specified repo(s) to remotegita remote <repo-name(s)>
: show remote settings of the specified repo(s)gita reflog <repo-name(s)>
: show ref logs of the specified repo(s)gita stat <repo-name(s)>
: show repo(s) edit statisticsgita status <repo-name(s)>
: show repo(s) status
Delegation details are specified in
cmds.yml.
For example, gita stat <repo-name(s)>
is registered as
stat:
cmd: diff --stat
help: show edit statistics
which executes git diff --stat
.
Customization
Custom git commands/aliases can be placed in $XDG_CONFIG_HOME/gita/cmds.yml
(most likely ~/.config/gita/cmds.yml
).
And they shadow the default ones in the case of name clashes.
Superman mode
The superman mode delegates any git command/alias for specified or all repo(s). Usage:
gita super [repo-name(s)] <command/alias>
Here repo-name(s)
is optional. If absent, it applies to all repos.
For example,
gita super myrepo1 commit -am 'fix a bug'
executesgit commit -am 'fix a bug'
formyrepo1
gita super checkout master
puts all repos on the master branchgita super frontend_repo backend_repo checkout new-feature
puts the two chosen repos on thenew-feature
branch
Requirements
Gita requires Python 3.6 or higher (due to the use of f-string).
Installation
To install the latest version, run
pip3 install -U gita
If development mode is preferred,
download the source code and run pip3 install -e <gita-source-folder>
.
In either case, calling gita
in terminal may not work,
then you can put the following line in the .bashrc
file.
alias gita="python3 -m gita"
Contributing
To contribute, you can
- report/fix bugs
- request/implement features
- star/recommend this project
To run tests locally, simply pytest
, or make
.
TODO (not tracked by issues)
- auto-completion
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.