git-quick-stats
is a simple and efficient way to access various statistics in a git repository.Any git repository may contain tons of information about commits, contributors, and files. Extracting this information is not always trivial, mostly because there are a gadzillion options to a gadzillion git commands - I don't think there is a single person alive who knows them all. Probably not even Linus Torvalds himself :).
- Interactive
- Non-interactive
- Command-line arguments
- Git log since and until
- Git log limit
- Git log options
- Git pathspec
- Git merge view strategy
- Color themes
git-quick-stats
has a built-in interactive menu that can be executed as such:
git-quick-stats
Or
git quick-stats
For those who prefer to utilize command-line options, git-quick-stats
also has a non-interactive mode supporting both short and long options:
git-quick-stats <optional-command-to-execute-directly>
Or
git quick-stats <optional-command-to-execute-directly>
Possible arguments in short and long form:
GENERATE OPTIONS
-T, --detailed-git-stats
give a detailed list of git stats
-R, --git-stats-by-branch
see detailed list of git stats by branch
-c, --changelogs
see changelogs
-L, --changelogs-by-author
see changelogs by author
-S, --my-daily-stats
see your current daily stats
-V, --csv-output-by-branch
output daily stats by branch in CSV format
-j, --json-output
save git log as a JSON formatted file to a specified area
LIST OPTIONS
-b, --branch-tree
show an ASCII graph of the git repo branch history
-D, --branches-by-date
show branches by date
-C, --contributors
see a list of everyone who contributed to the repo
-n, --new-contributors
list everyone who made their first contribution since a specified date
-a, --commits-per-author
displays a list of commits per author
-d, --commits-per-day
displays a list of commits per day
-Y, --commits-by-year
displays a list of commits per year
-m, --commits-by-month
displays a list of commits per month
-w, --commits-by-weekday
displays a list of commits per weekday
-W, --commits-by-author-by-weekday
displays a list of commits per weekday by author
-o, --commits-by-hour
displays a list of commits per hour
-A, --commits-by-author-by-hour
displays a list of commits per hour by author
-z, --commits-by-timezone
displays a list of commits per timezone
-Z, --commits-by-author-by-timezone
displays a list of commits per timezone by author
SUGGEST OPTIONS
-r, --suggest-reviewers
show the best people to contact to review code
-h, -?, --help
display this help text in the terminal
You can set the variables _GIT_SINCE
and/or _GIT_UNTIL
before running git-quick-stats
to limit the git log. These work similar to git's built-in --since
and --until
log options.
export _GIT_SINCE="2017-01-20"
export _GIT_UNTIL="2017-01-22"
Once set, run git quick-stats
as normal. Note that this affects all stats that parse the git log history until unset.
You can set variable _GIT_LIMIT
for limited output. It will affect the "changelogs" and "branch tree" options. The default limit is 10
.
export _GIT_LIMIT=20
You can set _GIT_LOG_OPTIONS
for git log options:
export _GIT_LOG_OPTIONS="--ignore-all-space --ignore-blank-lines"
You can exclude a directory from the stats by using pathspec
export _GIT_PATHSPEC=':!directory'
You can also exclude files from the stats. Note that it works with any alphanumeric, glob, or regex that git respects.
export _GIT_PATHSPEC=':!package-lock.json'
You can set the variable _GIT_MERGE_VIEW
to enable merge commits to be part of the stats by setting _GIT_MERGE_VIEW
to enable
. You can also choose to only show merge commits by setting _GIT_MERGE_VIEW
to exclusive
. Default is to not show merge commits. These work similar to git's built-in --merges
and --no-merges
log options.
export _GIT_MERGE_VIEW="enable"
export _GIT_MERGE_VIEW="exclusive"
You can set the variable _GIT_BRANCH
to set the branch of the stats. Works with commands --git-stats-by-branch
and --csv-output-by-branch
.
export _GIT_BRANCH="master"
You can change to the legacy color scheme by toggling the variable _MENU_THEME
between default
and legacy
export _MENU_THEME="legacy"
If you are on at least Debian Bullseye or Ubuntu Focal you can use apt for installation:
apt install git-quick-stats
git clone https://github.com/arzzen/git-quick-stats.git && cd git-quick-stats
sudo make install
For uninstalling, open up the cloned directory and run
sudo make uninstall
For update/reinstall
sudo make reinstall
macOS requires GNU coreutils to be installed and for the non "g" aliased versions to be exported to your path. The following is an example of how to perform this if you are using Homebrew as your package manager.
brew install coreutils
export PATH="$HOMEBREW_PREFIX/opt/coreutils/libexec/gnubin:$PATH"
From there, you can install via Homebrew as follows:
brew install git-quick-stats
Or you can follow the UNIX and Linux instructions if you wish.
If you would like to default to using the GNU coreutils (recommended), then you
can add export PATH="$HOMEBREW_PREFIX/opt/coreutils/libexec/gnubin:$PATH"
to
your applicable ~/.bash_profile
, ~/.zprofile
, or other relevant profile
based on the shell of your choice.
If you are installing with Cygwin, use these scripts:
If you are wishing to use this with WSL, follow the UNIX and Linux instructions.
You can use the Docker image provided:
- Build:
docker build -t arzzen/git-quick-stats .
- Run interactive menu:
docker run --rm -it -v $(pwd):/git arzzen/git-quick-stats
- Docker pull command:
docker pull arzzen/git-quick-stats
docker repository
- An OS with a Bash shell
- Tools we use:
awk
basename
cat
column
date
echo
git
grep
head
printf
seq
sort
tput
tr
uniq
bsdextrautils
apt install bsdextrautils
coreutils
apt install coreutils
gawk
apt install gawk
grep
apt install grep
ncurses-bin
apt install ncurses-bin
Q: I get some errors after run git-quick-stats in cygwin like /usr/local/bin/git-quick-stats: line 2: $'\r': command not found
A: You can run the dos2unix app in cygwin as follows: /bin/dos2unix.exe /usr/local/bin/git-quick-stats
. This will convert the script from the CR-LF convention that Microsoft uses to the LF convention that UNIX, OS X, and Linux use. You should then should be able to run it as normal.
Q: How they could be used in a project with many git projects and statistics would show a summary of all git projects?
A: If you want to include submodule logs, you can try using the following: export _GIT_LOG_OPTIONS="-p --submodule=log"
(more info about git log --submodule)
Want to contribute? Great! First, read this page.
All submissions, including submissions by project members, require review.
We use GitHub pull requests for this purpose.
- Use our code
When in doubt, try to stay true to the existing code of the project. - Write a descriptive commit message. What problem are you solving and what are the consequences? Where and what did you test? Some good tips: here and here.
- If your PR consists of multiple commits which are successive improvements /
fixes to your first commit, consider squashing them into a single commit
(
git rebase -i
) such that your PR is a single commit on top of the current HEAD. This make reviewing the code so much easier, and our history more readable.
This documentation is written using standard markdown syntax. Please submit your changes using the same syntax.
make test
MIT see LICENSE for the full license text.
This project exists thanks to all the people who contribute.
Thank you to all our backers! 🙏 [Become a backer]
Support this project by becoming a sponsor. Your logo will show up here with a link to your website. [Become a sponsor]