A collection of Python and Bash scripts to add functionality to git.
- git-alias
- git-authors
- git-branches
- git-commands
- git-dirs
- git-fileage
- git-history
- git-listsubmodules
- git-modified
- git-pkg
- git-remotes
- git-size-diff
- git-tagversion
Symlink each script to somewhere in $PATH, with no extension. I've included
a small script (makelinks.sh) that will do this for you in the safest way
possible.
This script will create symlinks to these git-commands in one of your bin
directories found in $PATH.
It will let you select a known $PATH directory, and confirm
the directory is okay to use before creating any symlinks. It will not
overwrite anything, and makes double sure that it is working with the correct
files/paths before doing anything.
Make sure the script is executable (chmod +x makelinks.sh).
You can run it like this to see what's going to happen:
./makelinks.sh -dAnd then to create the symlinks just run it with no arguments:
./makelinks.shMake sure you have permissions to write to the directory you choose.
sudo may be needed if you are installing in /usr/bin or /usr/local/bin.
If you change your mind, you can remove the links it created:
./makelinks.sh --removeIt will give you a chance to confirm removal of any symlinks that match the git-* file names in this directory.
This script is optionally sourced by some git-commands scripts. If it is found in the same directory as the git-commands scripts it will be used. Otherwise, the commands will have no color output, but should still function normally.
When I say "same directory", I mean the same directory as the original script, not the same directory as the symlink.
It exports a colr function, and a map of colr/style names to escape codes
(fore, back, style).
You can run ./colr.sh --help to see how this might be used as a command
line utility.
The latest version of colr.sh is available at
github.com/welbornprod/colr.sh
All of these commands can be invoked normally (git-authors), or as a
git subcommand (git authors).
There are no man pages for these commands, so running something like
git authors --help may produce weird output. You can use git authors -h
or git-authors --help instead.
Replacement for git-alias from the git-extras package. It provides color
output when listing aliases. You can also list both global and local aliases
by matching against a text or regex pattern.
Usage:
git-alias -h | -v
git-alias [-l] [PATTERN]
git-alias [-l] NAME VALUE
git-alias [-l] -r NAME
Options:
NAME : Name of alias for setting or removing.
VALUE : Value for alias.
PATTERN : A regex/text pattern to search for.
-h,--help : Show this message.
-l,--local : Do not use global config, use local.
-r,--remove : Remove an alias.
-v,--version : Show git-alias version and exit.
git alias
git alias -l
git alias whatever
git alias mything '!echo "okay"'
git alias -r mything
Lists all authors (with email addresses) from all commits in a repo.
Usage:
git-authorz [-h | -v]
git-authorz [DIR]
git-authorz -g [-H header] [-u name] [-r name] [DIR]
Options:
DIR : Repo directory to use.
-g,--github : Get authors from github repo.
-H txt,--header txt : Markdown header for output, like:
git-authorz -g -H "# Contributors"
-h,--help : Show this help message.
-r name,--repo name : Name of github repo, if not the same as CWD.
-u name,--user name : Owner of github repo, if not set in config.
-v,--version : Show git-authorz version and exit.
List branches, unmerged branches/commits.
Usage:
git-branches -h | -v
git-branches [-D] [-a | -r]
git-branches [-D] (-c | -C) [BRANCH] [CURRENT_BRANCH]
git-branches [-D] -m [BRANCH]
Options:
BRANCH : Branch to compare against.
Default: master
CURRENT_BRANCH : Branch to check for unmerged commits.
Default: <current branch>
-a,--all : List remote branches and local branches.
-C,--cherry : Show unmerged commits that are actually relevant.
-c,--commits : Show unmerged commits.
-D,--debug : Show the actual commands that are being executed.
-h,--help : Show this message.
-m,--unmerged : List unmerged branches.
-r,--remotes : List remote branches.
-v,--version : Show git-branches version and exit.
List all git subcommands that can be used, optionally filtering by local/system command or by text/regex pattern.
Usage:
git-commands -h | -v
git-commands [-D] [-l] [PATTERN]
Options:
PATTERN : Only show subcommands with a file path matching
PATTERN (a text or regex pattern).
-D,--debug : Print some debugging info while running.
-d,--duplicates : Show duplicate command names.
-h,--help : Show this message.
-l,--local : Show local git subcommands only, not builtin.
-v,--version : Show git-commands version and exit.
List all sub directories that are git repos. You can optionally filter results based on whether a repo has committed or uncommitted files, pushed or unpushed commits, or whether a repo has a remote counterpart, or is local only.
Usage:
git-dirs -h | -v
git-dirs [-b BRANCH] [-c | -C] [-l | -r] [-p | -P]
[-q] [DIR...] [-D] ([-- REPO_CMD])
Options:
DIR : One or more directories to look for git repos.
Default: /home/cj/scripts/git-commands
-- REPO_CMD : A shell command to run inside of the repo dir.
You must single quote characters such
as $, ;, |, etc.
They will be evaluated after switching to the
repo dir.
-b name,--branch name : Checkout a specific branch when checking.
The branch must exist.
-c,--committed : Only show repos without uncommitted changes.
-C,--uncommitted : Only show repos with uncommitted changes.
-D,--debug : Print some debugging info while running.
-h,--help : Show this message.
-l,--local : Only show repos without a remote.
-p,--pushed : Only show repos with all commits pushed to
remote.
-P,--unpushed : Only show repos with commits unpushed to
remote.
-q,--quiet : Quiet error messages.
-r,--remote : Only show repos with a remote.
-v,--version : Show git-dirs version and exit.
Notes:
-- REPO_CMD :
REPO_CMD is a BASH command, and is evaluated after switching to
the repo dir. If the `cd` command fails, nothing is done.
You must put -- before the command.
To git a list of modified files in uncommitted repos:
git dirs -C -- 'echo -e "\n$PWD"; git stat | grep modified'
* Notice the single quotes around $PWD, ;, and |.
git dirs -P
git dirs -l -C
...you get the idea.
Shows the age of a file in the repo, or shows the very first commit info. There may be more than one "first" commit, if histories were merged.
Usage:
git-fileage -h | -v
git-fileage -f | -F [GIT_SHOW_ARGS...]
git-fileage [-c] [-t] [-z] FILE...
Options:
FILE : One or more file names to get the initial commit
date for.
GIT_SHOW_ARGS : Extra arguments for `git show <commit_id>`.
-c,--commit : Show the first commit for the file.
-F,--firstfull : Show the first commit(s) in this repo, with full diff.
-f,--first : Alias for `git-fileage -F --no-patch`.
Only the commit header is shown, not the diff.
-h,--help : Show this message.
-t,--timestamp : Use the raw timestamp.
-v,--version : Show git-fileage version and exit.
-z,--timezone : Show the committer timezone also.
A shortcut to git log --follow -p -- FILE. It displays every commit where
a certain file has been modified.
Usage:
git-history -h | -v
git-history [-c] [GIT_LOG_ARGS...] FILE
git-history [GIT_LOG_ARGS...] -f FUNCTION FILE
Options:
GIT_LOG_ARGS : Any extra arguments to pass to `git log`.
FILE : File name to get history for, or '.' for all files.
Must be the last argument.
FUNCTION : Function name to view history for.
-c,--commits : Show commits instead of diffs.
-f,--function : View history for a specific function.
-h,--help : Show this message.
-v,--version : Show git-filehistory version and exit.
The -f/--function option is best used with a .gitattributes file set up
for your programming language. If it's not set up, git doesn't know how to
find your functions in a diff. git-history will try to use regex to find
the functions if .gitattributes is not working, but the whole experience is
better if you do set it up. It works best on committed changes, but again,
git-history will try to use regex to find your functions in a diff of the
working tree against the last commit.
To learn more about setting this up, visit: https://git-scm.com/docs/gitattributes/#_generating_diff_text
The basic gist is, you create a .gitattributes file with entries like this:
*.cpp diff=cpp
*.py diff=python
..where the diff attribute is set to a known language (known to git).
There are many builtin languages that you can use without writing a regex
pattern to find function names. If you do have to write a regex pattern, the
link above will show you where to put it (in .gitconfig).
Point .gitconfig at it (if you want the file to work globally), by adding
this to .gitconfig:
[core]
attributesfile=/my/path/to/.gitattributes
List submodule paths and urls for a repo.
Usage:
git-listsubmodules -h | -v
git-listsubmodules [PATTERN...]
Options:
PATTERN : Only list submodules with names matching PATTERN.
PATTERN can be a text or regex pattern.
The submodule name only needs to match one pattern.
-h,--help : Show this message.
-v,--version : Show git-listsubmodules version and exit.
A mixture of git stat and git diff-tree. If there are local changes in
the repo, this command will list all files that were modified. With no
local changes, it will list all files modified in the last commit. You can
also list modified files for one or more commit ids.
Usage:
git-modified -h | -l | -v
git-modified [-l] [COMMIT...]
Options:
COMMIT : One or more commit id's to show modified files for.
-h,--help : Show this message.
-l,--last : Use the last commit's id.
-v,--version : Show git-modified version and exit.
The default action is to show locally modified files.
If no files have been modified, the last commit is used.
Like git-archive, this creates a .tar.gz file from a git repo.
Usage:
git-pkg -h | -v
git-pkg FILE [REPO] [-e excludepattern] [-i includepattern] [-d]
git-pkg -l [-e excludepattern] [-i includepattern] [REPO]
Options:
FILE : Resulting package name.
'.tar.gz' is appended if not given.
REPO : Directory for git repo.
Default: ./
-d,--dryrun : Show what would've been added,
don't create a package.
-e pat,--exclude pat : Regex or text for filtering,
if found in a file name the file is excluded.
-i pat,--include pat : Regex or text for filtering,
if found in a file name the file is included,
otherwise the file is excluded.
The exclude flag overrides this.
-h,--help : Show this message.
-l,--list : List files that would be packaged.
-v,--version : Show version.
List remote urls, branches, unpushed/unpulled commits, and delete remote branches.
Usage:
git-remotes -h | -v
git-remotes -b | -B
git-remotes (-u | -U) [ORIGIN/BRANCH]
git-remotes -d [BRANCH] [ORIGIN]
Options:
BRANCH : Remote branch name.
You may also use the 'origin/branch' format.
ORIGIN : Origin to work with.
-b,--branches : Show remote branches.
-B,--allbranches : Show all branches.
-d,--delete : Delete a remote branch.
-h,--help : Show this message.
-u,--unpushed : Show unpushed commits.
-U,--unpulled : Show unpulled commits.
-v,--version : Show git-remotes version and exit.
Compare file sizes between branches/trees with diff-tree, or check file
sizes based on diff-index. The output is formatted with colors, and for
diff-tree the size changes are shown.
Usage:
git-size-diff -h | -v
git-size-diff [-D] DIFF_TREE_ARGS...
git-size-diff [-D] -c [DIFF_INDEX_ARGS...] TREEISH [PATH...]
Options:
DIFF_TREE_ARGS : Branches, or other options for `diff-tree`.
DIFF_INDEX_ARGS : Extra options for `diff-index`.
TREEISH : Tree-like arg for `diff-index`.
PATH : Extra path option for `diff-index`.
-c,--cached : Use local cached information.
-D,--debug : Debug mode, print some more info.
-h,--help : Show this message.
-v,--version : Show git-size-diff version and exit.
A shortcut to git tag -a, specifically for making version tags (vX.X.X).
Usage:
git-tagversion -h | -v
git-tagversion VERSION [MESSAGE...]
Options:
MESSAGE : Messages for this tag.
VERSION : Version number to use (in the X.X.X form).
-h,--help : Show this message.
-v,--version : Show git-tagversion version and exit.