devstats

Devstats

A tool for groking Github PR statistics that gives users better visibility into PR velocity.

Calculates mean/median/median absolute deviation for the following:

• Merge time: how long it takes for a PR to be merged.
• Commits: number of commits per PR.
• Comments: number of comments per PR.
• Change size (+/-) : total number of line changes per PR.

Sum:

• PRs: total number of PRs merged by from date.

Installation

go install github.com/jtsiros/devstats@latest

Usage

devstats pr [flags]

• Flags
  • -a or --author stringArray authors to calculate PR open time
  • -f or --from string from date to generate PR stats from
  • -r or --repo string repository to fetch PRs from (default "cockroachdb/cockroach")
  • -h or --help help for pr
• Global ---config string config file (default is $HOME/.devstats.yaml)

Configuration

devstats requires a Github personal access token. Instructions to generate one are here.

Once your token is created, you'll want to create your configuration file in the the default location ($HOME/.devstats.yaml), or provide a location of your choice using --config.

GITHUB_TOKEN: xxx_xxxxxxxxxx