Configuration

You can create a gitstats.conf file in the current directory to customize the configuration.

• max_domains - Maximum number of domains to display in “Domains by Commits”. Default: 10.

• max_ext_length - Maximum length of file extensions shown in statistics. Default: 10.

• style - CSS stylesheet for the generated report. Default: gitstats.css.

• max_authors - Maximum number of authors to list in “Authors”. Default: 20.

• authors_top - Number of top authors to highlight. Default: 5.

• commit_begin - Start of commit range (empty = include all commits). For example, 10 for last 10 commits. Default: "" (empty).

• commit_end - End of commit range. Default: HEAD.

• linear_linestats - Enable linear history for line statistics (1 = enabled, 0 = disabled). Default: 1.

• project_name - Project name to display (default: repository directory name). Default: "" (empty).

• processes - Number of parallel processes to use when gathering data. Default: 8.

• start_date - Starting date for commits, passed as –since to Git (optional). Format: YYYY-MM-DD. Default: "" (empty).

Here is an example gitstats.conf file:

[gitstats]
max_domains = 10
max_ext_length = 10
style = gitstats.css
max_authors = 20
authors_top = 5
commit_begin = 10
commit_end = HEAD
linear_linestats = 1
project_name =
processes = 8
start_date =

You can also override configuration values using the -c key=value option when running the gitstats command.

For example:

gitstats . report -c max_authors=10 -c authors_top=3

This command will generate a report with a maximum of 10 authors displayed and the top 3 authors shown.