git-tt2 v1.0.0

git-tt2

git commit log parser and hours extractor

Required Format

Developers must specify duration in commit messages in order to accrue hours.

Duration must be specified within brackets, like so:

To see what can be between the brackets, see: https://www.npmjs.com/package/duration-parser

Making multiple brackets or putting non-duration-parser input into the brackets are unhandled edge cases that will not be handled in this module.

Some examples of valid commit messages that will parse successfully:

• "2h5m did stuff"
• "here are things i did\n\n.5h"
• "more things i did 25min"

Install

npm install -g git-tt2

Usage Examples

git tt2

git tt2 --since 07/23/2015

git tt2 --since 07/23/2015 --until 07/24/2015

Example Procedure

• Developers commits to any branch, ensuring to tag commits with time tracking data
• Merging commits from other branches into a time-tracked branch (e.g. master) qualifies good commits. Unmerged/abandoned commits, having not been value-adding, are justifiably not used.
• Someone/thing runs git-tt2 to harvest time entries and generate appropriate invoices and/or payroll artifacts for master branch.

Conflict Resolution

If developers forget to add hours or make a mistake, they can always do amendments and rebases, in other words, it's just git.