Scope

These scripts can be used to run git commands over multiple repos. When you have cross repo branches and you want to check out branches simultaneous.

Usage

Either have a .reporc in the root folder of the gittools where git repo directories are listed (see the .reporc.example) or run commands with --repository=<file|relative/path/to/repodir>.

Install

$ git clone git@github.com:hwdegroot/gittools.git

Add the following part to your .bashrc or .bash_profile

if [ -f <gittoolslocation>/.gittoolsrc ]; then
    export GITTOOLS="<gittoolslocation>"
    source $GITTOOLS/.gittoolsrc
fi

Change the <gittoolslocation> with the location where you installed the tools.

Autocompletion

Currently available for (a subset of)

• gprune
• gfetch
• gclean-branches
• gcheckout
• gdiff
• gpull
• greset
• gstatus
• ginfo

To have autocompletion

$ [sudo] cp <gittools dir>/autocompletion/* /etc/bash_completion.d/

or

$ [sudo] ln -s <gittools dir>/autocompletion/* /etc/bash_completion.d/

And make sure autocompletion is enabled in ~/.bashrc. Look for the lines:

if [ -f /etc/bash_completion ] && ! shopt -oq posix; then
    . /etc/bash_completion
fi

Usage

The tools will allow you to define a file with locations of checked out git repos. The tools will default look to <gittoolslocation>/.reporc

The tools will expose the following aliases:

• gprune
• gfetch
• gclean-branches
• gcheckout
• gdiff
• gpull
• greset
• gstatus
• ginfo

type command --help to see for more help.

Environment variables

Set the following

$PRUNE_REMOTE=1: Always prune remote origin after a checkout. Same as gcheckout [...] --prune-remote

$PRE_FETCH=1: Always fetch before checking out. Same as gcheckout [...] --pre-fetch

$POST_PULL=1: Always pull after checking out. Same as gcheckout [...] --post-pull

$DEFAULT_BRANCH=branch_name: Checkout this branch if gcheckout is called without a branch (usually this will be master)

Contributing

• Fork repo
• Ninja some code
• Pull request
• Wait
• Profit

To add any commands you can start from the template/template.sh For autocompletion add

complete -o nospace -F _gdefault gmyawesomecommand

to autocompletion/gittools.autocompletion

or create a new function there if more than default autocompletion wanted

NOTE: if you are using .reporc files, make sure the repository directories are relative to the file, or just abs paths.