gitstats icon indicating copy to clipboard operation
gitstats copied to clipboard

Published 20 hours ago • verified publisher icon a-p-z
→

Metadata

simple statistical analysis tool for git repositories

gitstats

gitstats is a simple statistical analysis tool for git repositories written in python. It analyzes the history of the repository and shows general statistics per author. It was purely developed for fun, to create a little friendly competition among team members. Nevertheless, it calculates interesting timeline analysis and reports code changes over time for a high level overview over the repository.

Example outputs

gitstats is based on templates which can be customized according to your needs.

Markdown

Move to your project directory and execute gitstats with Markdown format:

$ cd $PROJECT_DIRECTORY
$ $GITSTATS_DIRECTORY/gitstats.py --format markdown

Open the output file gitstats.md with a markdown viewer.

CUMULATED COMMITS OVER TIME BY AUTHOR

date Romolo Numa Pompilio Tullo Ostilio Anco Marzio Tarquinio Prisco Servio Tullio Tarquinio il Superbo
2016-02 0 0 0 0 0 0 0
2016-03 5 5 0 0 0 0 0
2016-04 56 33 0 0 0 0 0
2016-05 112 45 0 0 0 0 0
2016-06 126 70 0 0 0 2 0
2016-07 128 84 19 4 0 2 0
2016-08 133 110 21 20 0 2 0
2016-09 136 117 43 28 0 2 0
2016-10 137 135 94 43 8 2 0
2016-11 137 159 109 56 23 2 0
2016-12 137 177 128 69 49 2 0
2017-01 137 183 145 75 62 2 0
2017-02 137 199 213 86 75 2 0
2017-03 137 216 250 104 95 2 0
2017-04 137 230 295 119 120 2 0
2017-05 137 233 338 130 128 2 12
2017-06 137 233 388 148 153 2 20
2017-07 137 233 400 158 161 2 29

[...]

COMMITS BY AUTHOR

author commits insertions deletions % of changes impact/commit
Tullo Ostilio 400 273229 239169 57 1280
Numa Pompilio 233 65995 27998 10 403
Tarquinio Prisco 161 73754 48478 13 759
Anco Marzio 158 83017 30135 12 716
Romolo 137 23831 14835 4 282
Tarquinio il Superbo 29 4609 833 0 187
Servio Tullio 2 28 18 0 23
total 1120 524463 361466

[...]

Confluence wiki

Move to your project directory and execute gitstats with confluencewiki format:

-[ ] TODO: implement a client to directly create/modify the page

$ cd $PROJECT_DIRECTORY
$ $GITSTATS_DIRECTORY/gitstats.py --format confluencewiki

Copy the content of gitstats.confluencewiki.txt in a Confluence page:

  1. Choose Insert > Markup
  2. Select Confluence wiki
  3. Paste your text - the preview will show you how it will appear on your page
  4. Choose Insert

See Confluence Wiki Markup

cumulated commits over time by authors impacts over time commits over time by authors commits by author files by extension edited lines of code by author

Some features

  • Cumulated commits over time by author
  • Impacts over time
  • Commits over time by authors
  • Authors not active for over a year
  • Commits by Author
  • Commits without ticket reference by author
  • Commits on behalf of
  • Reviews
  • Remote origin refs by author
  • Files by extension
  • Edited lines of code by author
  • Most impactful commits
  • Other statistics (global and of the month)

Resources

The resources directory contains two template you can use to define your own mail mapping and regexes:

  • in mailmap.yaml you can link multiple emails to the same author
  • regexes.yaml contains the regexes used to check the subject of the commit is compliant and to extract the reviewers

Requirements

  • Git
  • Python 3

Related projects

← Metadata

29
Stars
6
Forks
Watchers

Owner

verified publisher icon a-p-z

Metadata

simple statistical analysis tool for git repositories

Back