git-heatmap

Readme

Display file/author heatmap in the console. e.g

┌───────┬───────────────────────────────────────┬────────┬────────┬──────────────────────────────────────────────────────────────────┐
│ Index │                                 Entry │ # file │ # line │ Wed Aug 31 2022                                  Tue Nov 01 2022 │
├───────┼───────────────────────────────────────┼────────┼────────┼──────────────────────────────────────────────────────────────────┤
│     1 │    ...MyTestProject/Code/TestFile1.ts │    129 │    494 │  ▨▨▨ ▨▨▩▨▨▩  ▨▩▩▨▨   ▨▩▨▨  ▨▨▨▨   ▨▨     ▨▨▩▨    ▨▨▩   ▨▨▨▨▨     │
│     2 │    ...MyTestProject/Code/TestFile2.ts │     70 │    268 │    ▨   ▨▨ ▨   ▨▩▨▨  ▨▨▩ ▨  ▨▨▩▨    ▨ ▨▨  ▩▩▩    ▨ ▨▩▩  ▩▨▨       │
└───────┴───────────────────────────────────────┴────────┴────────┴──────────────────────────────────────────────────────────────────┘

Options:

  -n, --numCommits <number>  number of commits to check (default: "1000")
  -s, --startDate <date>  start date of the commits to filter (e.g. 2022-01-01 default: "")
  -i, --ignore <filter>   ignore files types (glob patterns separated by space, default: "")
  -k, --topK <number>     Top k result to return (default: "20")
  -w, --weight <number>   the weight factor of line change (default: "0.5")
  -e, --email <email>        filter by author email
  -c, --commit <sha>         filter by commit sha hash
  -h, --help              display help for command

To install: npm i git-heatmap -g

To use this tool, cd to a git directory git-heatmap

Examples with filters

# Filter out all .json and .lock files
git-heatmap -i "**/*.json **/*.lock"

# Show author heatmap
git-heatmap -a

# Filter commits since 2022-01-01
git-heatmap -s 2022-01-01