Project

git_fame

0.35
There's a lot of open issues
A long-lived project that still receives updates
A command-line tool that helps you summarize and pretty-print collaborators in a git repository based on contributions Generates stats like: - Number of files changed by a user - Number of commits by user - Lines of code by a user'
2005
2006
2007
2008
2009
2010
2011
2012
2013
2014
2015
2016
2017
2018
2019
2020
2021
2022
2023
2024
 Dependencies

Runtime

>= 7, < 9
~> 1.0
~> 0.9
~> 1.0
~> 0.5
<= 0.10.0, ~> 0.9
~> 2.0
 Project Readme

git-fame git-fame Gem Test Coverage Maintainability

git-fame

git-fame is a command-line tool that helps you summarize and pretty-print collaborators, based on the number of contributions.

The statistics are mostly based on the output of git blame on the current branch. git fame counts the total number of current lines of code (and files) that were last touched by each author, and prints out these totals, along with the number of commits per author, as a sorted table.

Installation

gem install git_fame

Usage

Usage: git fame [OPTIONS] [PATH]

GitFame is a tool to generate a contributor list from git history

Arguments:
  PATH  Path or sub path to the git repository

Options:
  -A, --after [DATE]       Only changes made after this date
  -B, --before [DATE]      Only changes made before this date
      --branch [NAME]      Branch to be used as starting point (default
                           "HEAD")
  -E, --exclude [GLOB]     Exclude files matching the given glob pattern
  -e, --extensions [EXT]   File extensions to be included starting with a
                           period
  -h, --help               Print usage
  -I, --include [GLOB]     Include files matching the given glob pattern
      --log-level [LEVEL]  Log level (permitted: debug,info,warn,error,fatal)

Examples:
  Include commits made since 2010
  git fame --after 2010-01-01

  Include commits made before 2015
  git fame --before 2015-01-01

  Include commits made since 2010 and before 2015
  git fame --after 2010-01-01 --before 2015-01-01

  Only changes made to the main branch
  git fame --branch main

  Only ruby and javascript files
  git fame --extensions .rb .js

  Exclude spec files and the README
  git fame --exclude */**/*_spec.rb README.md

  Only spec files and markdown files
  git fame --include */**/*_spec.rb */**/*.md

  A parent directory of the current directory
  git fame ../other/git/repo

Development

  1. git clone https://github.com/oleander/git-fame-rb.git
  2. docker build -t git-fame -f .devcontainer/Dockerfile .
  3. docker run -it -v $(pwd):/workspace git-fame bundle exec rspec

Have a look at .devcontainer/Dockerfile and .github/workflows/main.yml for more information.

New release

  1. Update version in lib/git_fame/version.rb
  2. bundle exec rake release
  3. Done!