Story Line Counter

Description

This utility analyzes a git repo’s commit messages for Version1 or Jira story numbers and gets the total number of changed lines associated with a story.

Installation

This utility is built in Rust. Is this your first time? It is mine @_@

• You have Rust installed, preferably via rustup
• You have ~/.cargo/bin added to your PATH variable
• Build and install the program with

$ cargo install story-line-counter
  ... builds in a few minutes ...
$ which story-line-counter
  /home/you/.cargo/bin/story-line-counter

Usage

$ story-line-counter --help

story-line-counter 1.0.1
Lea Fairbanks <[email protected]>

USAGE:
    story-line-counter [SUBCOMMAND]

FLAGS:
    -h, --help       Prints help information
    -V, --version    Prints version information

SUBCOMMANDS:
    collect    Parses a git repo and outputs DiffCollection objects.
    help       Prints this message or the help of the given subcommand(s)
    run        Opens a repo and outputs a DiffTotalCollection.
    total      Loads a DiffCollection file and outputs a DiffTotalCollection.

You may collect and total a repository in one step.

$ story-line-counter run -p /path/to/points.json /path/to/repo

Or you may split it into two steps, to total multiple repos together.

$ story-line-counter collect /path/to/repo1 > repo1.json
$ story-line-counter collect /path/to/repo2 > repo2.json
$ story-line-counter total -p /path/to/points.json repo1.json repo2.json

Including a points file is optional, but you must generate your own to match story numbers with point values. An example points.json file is included in this repo here. It may be pretty-printed or not.

Contributing

Pull requests are welcome!