Skip to content
This repository has been archived by the owner on Sep 27, 2022. It is now read-only.

mezis/git-heroes

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

27 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Git Heroes

Ever wanted to know your your team's top contributors are?

git heroes will tell you, based on their Github activity (pull requests, comments, and merges).

Caveat Emptor: no hard metric that measures individuals is reliable. Please do not use this to estimate someone's productivity. In combination with other tools, it can be effectivee to detect trends, though.

Installation

$ gem install git-heroes

To preserve your Github API usage limit, the tool requires locally running Redis instance for caching.

Usage

$ git heroes -r <your-organization> -t <github-token>

Outputs two files, report-timing.csv (time taken to merge pull requests) and report-points.csv (contribution points per user).

You'll probably want to pivot this in a spreadsheet application to get meaningful results; if you want a template for that just email me.

Details:

Usage: bin/git-heroes [options]
    -r, --organization ORG   Progress organization ORG (required)
    -o, --output FILE        Save report to FILE
    -t, --token TOKEN        A Github authentication token (defaults to GITHUB_TOKEN)
    -w, --weeks WEEKS        Report on the last WEEKS weeks (default 12).
    -v, --verbose            Run verbosely
    -h, --help               Show this message

Example reports

Contributing

  1. Fork it
  2. Create your feature branch (git checkout -b my-new-feature)
  3. Commit your changes (git commit -am 'Add some feature')
  4. Push to the branch (git push origin my-new-feature)
  5. Create new Pull Request

About

A leaderboard for your Github organisation

Resources

License

Stars

Watchers

Forks

Packages

No packages published

Languages