Skip to main content

Manage multiple git repos

Project description

PyPi version Build Status codecov licence

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 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 for the execution of simple git commands.

gita screenshot

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) to gita
  • gita rm <repo-name>: remove repo from gita (won't remove repo from disk)
  • gita ls: display the status of all repos
  • gita ls <repo-name>: display the absolute path of one repo
  • gita -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 repos
  • gita 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 remote
  • gita 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 statistics
  • gita 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

and the delegated command is 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 one repo. Usage:

gita super <repo-name> <command/alias>

For example, gita -s myrepo1 commit -am 'fix a bug'.

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

  • report/fix bugs
  • request/implement features
  • star/recommend this repo

To run tests locally, simply do make.

TODO (not tracked by issues)

  • auto-completion

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Files for gita, version 0.7.0
Filename, size File type Python version Upload date Hashes
Filename, size gita-0.7.0.tar.gz (6.7 kB) File type Source Python version None Upload date Hashes View

Supported by

Pingdom Pingdom Monitoring Google Google Object Storage and Download Analytics Sentry Sentry Error logging AWS AWS Cloud computing DataDog DataDog Monitoring Fastly Fastly CDN DigiCert DigiCert EV certificate StatusPage StatusPage Status page