caelum-git-reports

Summary

caelum-git-reports is a statistics generator for git repositories. Given a base directory containing a set of git repositories, it will generate a summary of recent activity and impact statistics for each developer and project.

Features

• Summary of recent activity
• Impact statistics for committers (discriminated by repository) and for repository (discriminated by committer)
• User-defined considered date interval
• Optional, user-defined, translation of committer names (defined in a YAML file)
• HTML output

Installation

To install caelum-git-reports, just execute the following line on your terminal:

sudo gem install caelum-git-reports -s http://gems.github.com

Usage

Command line usage:

git-report.rb <path to repositories> <number of days to look back>

git-report.rb <path to repositories> <number of days to look back> <number of commits in summary>

git-report.rb <path to repositories> <number of days to look back> <number of commits in summary> <yaml file for committer name translation>

Committer name translation

It’s possible that the same developer has commits under different names. This often happens when he codes from different machines and they have different git configurations. To concentrate different names into one, just create a YAML file specifying the desired translations.

An example:

translations.yml:

john.doe: John Doe
john doe: John Doe

This will attribute to John Doe all commits made by john.doe and john doe.