git-standup - Man Page
Recall the commit history
Examples (TL;DR)
- Show a given author's commits from the last 10 days:
git standup -a name|email -d 10
- Show a given author's commits from the last 10 days and whether they are GPG signed:
git standup -a name|email -d 10 -g
- Show all the commits from all contributors for the last 10 days:
git standup -a all -d 10
- Display help:
git standup -h
Synopsis
git-standup [-a author] [-w weekstart-weekend|-d days-ago] [-m depth] [-D date format] [-L] [-f] [-B] [-n number of commits] [-F gpg|authordate]
git-standup -h
Description
Recall what you did on the last working day ..or be nosy and find what someone else did.
Options
- -a author
- The author of commits. Use "all" means specifying "all authors". Defaults to $(git config user.name).
- -m depth
- The depth of recursive directory search. Defaults to 1.
- -L
- Enable the inclusion of symbolic links in recursive directory search.
- -d days-ago
- The start of commit history. Defaults to 1, means "1 days ago".
- -w weekstart-weekend
- Limit the search range to weekdays. If weekstart and/or weekend are missing they default to Mon and Fri. If the current day is weekstart, commits made on weekend will be included. I.e. calling git standup -w - on a Monday will include commits made on the last Friday.
- -D relative
- The date format displayed in commit history. Defaults to "relative".
- -h
- Display help message.
- -f
- Fetch the latest commits before showing commit history.
The former version of git standup accepted <author> <since> <until> as options. This interface is deprecated now, and please avoid to use it!
- -B
- Display the commits in branch groups.
- -n number-of-commits
- Limit the number of commits displayed per group. By default, the limitation is applied in the repository level. For example, if you have 3 repositories under the current directory, git standup ... -n 1 will show you 3 commits at most. When -B is specific, the limitation is applied in the branch level. For instance, if each of your 3 repositories have 2 branches, git standup ... -B -n 1 will display 6 commits at most.
- -F gpg|authordate
- Change how the commits are formatted. Takes an argument, can be specified multiple times.
Git Configs
You can configure a implicit -w weekstart-weekend, which is superseded if -w or -d is given on the command line. Note that the weekstart-weekend must be specified, they don´t have any default values as the -w flag has.
$ git config --global git-extras.standup.implicit-week "Mon-Fri"
Examples
This shows your commits since yesterday:
$ git standup a26d1f9 - add profile hook (69 minutes ago) <spacewander>
This shows the author´s commits since last week:
$ git standup -a spacewander -d 7 a26d1f9 - add profile hook (70 minutes ago) <spacewander> 4e19859 - fix getTotalSize return value error (6 days ago) <spacewander> 36da84e - fix rename over bound (7 days ago) <spacewander> 8e4182a - add watermark.png (7 days ago) <spacewander> 46fef1d - use tinyXML to configure (7 days ago) <spacewander>
If current directory is not a git repo, git-standup will fetch data from all top-level git repos under it:
$ cd .. $ git standup -a spacewander -d 7 someProject/ 4e19859 - fix getTotalSize return value error (6 days ago) <spacewander> 36da84e - fix rename over bound (7 days ago) <spacewander> 8e4182a - add watermark.png (7 days ago) <spacewander> 46fef1d - use tinyXML to configure (7 days ago) <spacewander>
By specifying the -B option, git-standuo will group the commits in branches:
$ git standup -B -a spacewander -d 7 git-summary-cleanup f788c78 - git-summary: clean up other shellcheck warnings (23 hours ago) <spacewander> 3e8c3ab - git-summary: fix incorrect active days when commits range is given (23 hours ago) <spacewander> ff991ac - git-summary: remove useless result function. (23 hours ago) <spacewander> 203f5b4 - git-summary: add --dedup-by-email to remove duplicate users (5 days ago) <spacewander> master 203f5b4 - git-summary: add --dedup-by-email to remove duplicate users (5 days ago) <spacewander>
Note that the same commit can be seen in different branches.
Author
Originally from https://github.com/kamranahmedse/git-standup