git-reporter
A command line tool for contribution reporting on git projects. The committers will be sorted based on contributions, taking into account commits, files changed, insertions and deletions.
Usage
You can see the commits uploaded on different branches and projects for a period of time. Run the command with followed by the relative path to the different projects you want to check separated by spaces. For example:
git-reporter ./node ./lodash
Other way to use the package is using -a
option followed by the directory
where you have all git projects you want to analyze. In this way the script
will check all git projects inside the directory (only first level, it
doesn't work recursively). Furthermore, this option ignore the paths passed
as arguments.
git-reporter -a projects
Command line options:
Initializing git reporter 3.1.0
A command line tool for contribution reporting on git projects.
The committers will be sorted based on contributions, taking into account commits,
files changed, insertions and deletions.
USAGE
$ git-reporter
OPTIONS
-a, --anonymize Anonymize author names and emails.
-d, --directory=directory Search for all git projects in a directory.
-f, --forceUpdate Update git projects before generating report.
-h, --help show CLI help
-s, --slackUrl=slackUrl Slack url for publishing report.
-v, --version show CLI version
-w, --weeks=weeks [default: 4] Number of weeks in the past to look for commits.
--verbose Set multiline committer contribution info displaying total insertions and
deletions. Otherwise the committer contribution info is display in one
line with total commits and total files changed.
Verbose mode
Using git-reporter with --verbose
option will display all the report available info:
⚠️ Things to bear in mind with --forceUpdate option
- If any of the directories to analyze has uncommitted changes, the script will fail.
- For performing the git log across branches the script will perform a
git fetch
andgit pull
right before reading the git log on each directory.
Publishing on Slack
Create a Slack app and add a webhook. Use that url with -s
or --slack
option.