Skip to main content

Manage multiple git repos

Project description

PyPi version Build Status codecov

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 for the repos

gita screenshot

Here the colors 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 choice of purple for ahead and yellow for behind is motivated by blueshift and redshift, using green as baseline.

The additional status symbols have the following meaning:

  • +: staged change exists
  • *: unstaged change exists
  • _: untracked files/folders exist

The supported sub-commands for git delegation are

  • gita add <repo-path>: add repo to gita
  • 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 difftool <repo-name(s)>: show differences 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 ls: display the status of all repos
  • gita ls <repo-name>: display the absolute path of the specified repo
  • 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 rm <repo-name>: remove repo from gita (won't remove repo from disk)
  • gita stat <repo-name(s)>: show repo(s) edit statistics
  • gita status <repo-name(s)>: show repo(s) status

The git commands arguments can be found in the cmd.yaml file. The repo paths are saved in ~/.gita_path.

installation

To install the latest version,

pip3 install gita

Alternatively, you can download the source code and run pip3 install -e <gita source folder>. This is known as the development mode. In this case, calling gita in bash may not work, then you can put the following line in the .bashrc file

alias gita="python3 -m gita"

TODO

  • auto-completion

Project details


Release history Release notifications | RSS feed

This version

0.5.9

Download files

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

Source Distribution

gita-0.5.9.tar.gz (5.3 kB view hashes)

Uploaded Source

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page