Adam's git configuration files and utilities

This is my collection of configuration files and utilities for git.

CONTENTS

Contents include:

Upstream branch status reporting / management

• git-upstream - obtain the upstream tracking branch (N.B. depends on git-head, git-root, and git-prefix)
• git-set-upstream - set the upstream tracking branch (N.B. depends on git-head and git-root)
• git-mixdown - mixdown multiple branches into a single working branch. Useful for testing a combination of bugfixes / features at once via a throw-away temporary working branch.
• git-mix - syntactic sugar for configuring git mixdown
• git-merged - show which branches are merged into upstream or the given commit-ish (N.B. depends on git-root and git-upstream)
• git-compare - compare two references to find out how far one is ahead/behind of the other
• git-compare-upstream - set the upstream tracking branch (N.B. depends on git-compare, git-head, and git-upstream, and hence also on git-root and and git-prefix)
• git-wip - returns true if the current repo has any work in progress, i.e. commits out of sync with upstream, or unmodified/untracked files
• git-rm-merged-orphan-branches - remove local branches which have been merged and are not in any other remote. Use with care!!
• git-icing - a tasty wrapper around git cherry which adds a splash of colour, and blacklisting of commits which should never be upstreamed.
• git-cherry-menu - an interactive wrapper around git icing and git notes which makes it easy to cherry-pick and/or blacklist non-upstreamed commits.
• git-rnotes - a wrapper around git notes which makes it easier to share notes to and from remote repositories
• git-deps - MOVED TO DEDICATED REPO automatically detect dependencies between commits
• git-tag-patchset - quick way of tagging patch sets as they get uploaded to Gerrit, to keep track of a review's history, e.g. git review && git tag-patchset.

History rewriting

• git-rewrite-author - rewrite the author for a range of commits
• git-rewrite-committer - rewrite the committer for a range of commits
• git-sed-range - run a sed script over every log message in a range of commits
• git-add-prefix - add a prefix string to every log message in a range of commits

Management of remotes

• git-url-rewrite - convenient interface for setting git URL rewrites via url.$url.insteadOf
• git-annex-clean-sync - a wrapper around git annex sync which avoids trying to touch ignored or unavailable remotes.

Mapping files/blobs back to commits

• git-ls-dir - list files in a git repo tree together with the commits which most recently touched them (see a screenshot)
• git-find-blob - find which commits contain a given (non-abbreviated) blob

Sanity-checking submodule references

• git-find-missing-submodule-commits - find dangling references to submodule commits

Helper scripts

Little shell wrappers to make the git porcelain and higher-level scripts a little more beautiful.

• git-head - obtain the current branch
• git-root - obtain the absolute path to the root (top-level) directory of the repository we're currently in
• git-prefix - obtain the current directory path relative to the root (top-level) directory of the repository
• git-cdup - obtain the relative path from the current directory to the root (top-level) directory of the repository
• gfind - like find(1), but only lists files tracked by git

Shorthand wrappers

• gg* - a whole bunch of wrappers around standard git commands to reduce the number of keystrokes required and add a little bit of polish to the interface here and there.

... and more!

Feel free to browse the bin/ directory :-)

INSTALLATION

This repository is designed to be stowed directly into your home directory:

git clone git://github.com/aspiers/git-config.git
stow -d . -t ~ git-config

However if you only want to cherry-pick bits and pieces then you can easily just copy or symlink them in manually. Just be aware that some of the files depend on other files, some of which are in this repository, some of which are in other repositories such as https://github.com/aspiers/shell-env.

LICENSE

The software in this repository is free software: you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version.

This software is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.

You should have received a copy of the GNU General Public License along with this program. If not, see http://www.gnu.org/licenses/.