Track developers' contributions to one or more git repositories within a particular time range.
Project description
Git Developer Contributions Analysis
This repository contains a command-line tool, gitlogstats
, written in python
, to track developers' contributions to one or more Git repositories within a particular time range. GitHub's Insights tools and charts are not extremely useful, and often omit contributors or give misleading statistics.
This script calculates the following, for each developer in each repository:
- number of commits
- number of lines added
- number of lines deleted
- number of files changed
The results can be formatted as csv
, json
, or markdown
.
Install
gitlogstats
can be installed with a package manager such as pip
e.g. pip install gitlogstats
, pip3 install gitlogstats
, depending on your environment.
Usage
The command gitlogstats --help
shows the usage instructions:
usage: gitlogstats [-h] (-r REPOSITORY | -rf REPOFILE) [-u USER] [-s START] [-e END] [-x EXCLUSIONS] [-f {csv,json,markdown}] [-v]
optional arguments:
-h, --help show this help message and exit
-r REPOSITORY, --repository REPOSITORY
the public URL of the repository whose logs to parse
-rf REPOFILE, --repofile REPOFILE
the path to simple text file with a list of repository URLs to parse
-u USER, --user USER The git username to report. Default is all contributing users
-s START, --start START
Start date in mm/dd/yyyy format
-e END, --end END End date in mm/dd/yyyy format
-x EXCLUSIONS, --exclusions EXCLUSIONS
A comma-separated string of files to exclude, e.g. --excusions "foo.zip, *.jpg, *.json"
-f {csv,json,markdown}, --format {csv,json,markdown}
The format in which to output the results
-v, --verbose Whether to output debugging info
-c, --clean Remove contributors without any contribuition
In case gitlogstats
is not found as a command, even after installing, try python -m gitlogstats
or python3 -m gitlogstats
instead.
Example usage
Single versus multiple repository analytics
The -r
and -rf
flags control whether the script looks at a single repository, or a batch of repositories stored in a simple text file.
Output the contributions of all developers to a single repository:
gitlogstats -r https://github.com/bloombar/git-developer-contribution-analysis.git
Output the contributions of all developers to a set of repositories stored in a file named repos.txt
(see example file):
gitlogstats -rf repos.txt
Individual contributor versus all contributors
By default, the statistics of all contributors are calculated. The -u
flag can be used to limit the analysis to just a single contributor by referencing their git username.
Output the contributions of only the contributor named bloombar
to a single repository:
gitlogstats -u bloombar -r https://github.com/bloombar/git-developer-contribution-analysis.git
The same, but to a batch of repositories listed in the repos.txt
file:
gitlogstats -u bloombar -rf repos.txt
Custom date range
By default, contributions from a year ago until today are analyzed. Use the -s
and -e
flags to specify a different start and end date, respectively.
Output the contributions to a single repository for a specific date range, inclusive.
gitlogstats -s 11/15/2021 -e 12/15/2021 -r https://github.com/bloombar/git-developer-contribution-analysis.git
The same, but to a batch of repositories listed in the repos.txt
file:
gitlogstats -s 11/15/2021 -e 12/15/2021 -rf repos.txt
Filter Contributors
Results can be filtered to show only contributors with activity. Use the -c
to file the result.
gitlogstats -rf repos.txt -c
Formatting the results
The results can be formatted as csv
, json
, or a markdown
table. The default is csv
. Use the -f
flag to control the output format.
gitlogstats -s 11/15/2021 -e 12/15/2021 -rf repos.txt -f markdown
Combinations
Flags can be combined to provide more targeted analysis, e.g. a specific contributor over a specific date range
gitlogstats -u bloombar -s 11/15/2021 -e 12/15/2021 -r https://github.com/bloombar/git-developer-contribution-analysis.git -f json
The same, but to a batch of repositories listed in the repos.txt
file:
gitlogstats -u bloombar -s 11/15/2021 -e 12/15/2021 -rf repos.txt -f json
Words of caution
Large numbers of additions or deletions
If a particular contricutor shows a very large number of additions or deletions, typically on the order of many hundreds or thousands, this could be a sign of poor usage of version control.
Most likely, the contributor has failed to update their version control settings to ignore platform or 3rd party code to (i.e. has not updated their .gitignore
file prior to adding such code), and is therefore tracking additions/deletions of code that is not theirs. The entire contribution for that user during this date range should be ignored in this case until the developer fixes this problem.
Redundant usernames
The output of the script sometimes lists the same individual contributor under more than one git username... This is most likely due to different username settings for various git and GitHub clients.
If a single developer has multiple usernames that all show the same statistics, then only count those stats once. Otherwise, if a single developer has multiple usernames that show different statistics, then add them together to come up with the total for that developer.
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Hashes for gitlogstats-1.0.0-py3-none-any.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | bb851fc535a501f42949e6b362ce2d7b9b5b64d547e6028c9ccaf96c9d5f3720 |
|
MD5 | e598f354cf92a971a3ed64129229601e |
|
BLAKE2b-256 | a4cbc276bbf0930221eb5f57b58da3bf34c2920960878232719590b4d57b6978 |