gitstats is a statistics generator for git repositories. It examines the repository and produces some interesting statistics from the history of it.

It is mostly intended for developers, as a way to check some development statistics for a project.

Currently it produces only HTML output with tables and graphs.

Here is a list of some statistics generated currently:

• General statistics: total files, lines, commits, authors.
• Activity: commits by hour of day, day of week, hour of week, month of year, year and month, and year.
• Authors: list of authors (name, commits (%), first commit date, last commit date, age), author of month, author of year.
• Files: file count by date, extensions
• Lines: Lines of Code by date

• Python 3.9+
• Gnuplot (http://www.gnuplot.info/)

# since I gitstats is used by other projects
# so right now I don't publish it on pypi and please install from source

pip install git+https://github.com/shenxianpeng/gitstats.git@main

gitstats --help

Usage: gitstats [options] <gitpath..> <outputpath>

Options:
-c key=value     Override configuration value

Default config values:
{'max_domains': 10, 'max_ext_length': 10, 'style': 'gitstats.css', 'max_authors': 20, 'authors_top': 5, 'commit_begin': '', 'commit_end': 'HEAD', 'linear_linestats': 1, 'project_name': '', 'processes': 8, 'start_date': ''}

Please see the manual page for more details.

gitstats your-awesome-project ~/public_html

The output will be generated in the given directory.

Both the code and the web site are licensed under GPLv2/GPLv3.