[ANNOUNCE] git-related v1.0

From: Felipe Contreras <hidden>
Date: 2021-05-27 00:55:40

Hi,

git-related is a tool to find out people that might be interested in
your patch series.

It works by running `git blame` on every chunk your patches modify, and
then presents a summary showing the roles of each person:

  % git related --roles master..fc/asciidoctor/clean
  Junio C Hamano [off-list ref] (signer: 93%, author: 7%)
  brian m. carlson [off-list ref] (author: 20%, helper: 3%)
  Christian Couder [off-list ref] (author: 7%, mentor: 7%)
  Jeff King [off-list ref] (author: 10%)
  Johannes Schindelin [off-list ref] (author: 7%, signer: 3%)
  Martin Ågren [off-list ref] (author: 10%)

A lot of things have changed since v0.3, but the most important is the
addition of a completely new tool that does something similar: git-who.

Unlike git-related, git-who does not work on any particular patch
series, you can use any arguments `git log` accepts, and then presents a
similar output to git-related.

Therefore you can specify queries:

  % git who --roles -S'PERL_DEFINES' -- Makefile
  Junio C Hamano [off-list ref] (signer: 100%)
  Ævar Arnfjörð Bjarmason [off-list ref] (author: 75%, helper: 25%)
  Johannes Schindelin [off-list ref] (helper: 25%)
  Dan Jacques [off-list ref] (author: 25%)

We can find out a summary for the whole history of git.git:

  % git who --roles --since=2000 --threshold=1
  Junio C Hamano [off-list ref] (signer: 64%, author: 15%, helper: 1%)
  Junio C Hamano [off-list ref] (signer: 14%)
  Jeff King [off-list ref] (author: 8%, signer: 1%, reviewer: 1%)
  Johannes Schindelin [off-list ref] (author: 4%)
  Shawn Pearce [off-list ref] (author: 3%, signer: 1%)
  Nguyễn Thái Ngọc Duy [off-list ref] (author: 4%)
  Jonathan Nieder [off-list ref] (author: 2%, reviewer: 1%, signer: 1%)
  Linus Torvalds [off-list ref] (author: 2%)
  Michael Haggerty [off-list ref] (author: 2%)
  René Scharfe [off-list ref] (author: 2%)
  Ævar Arnfjörð Bjarmason [off-list ref] (author: 2%)
  brian m. carlson [off-list ref] (author: 2%)
  Stefan Beller [off-list ref] (signer: 1%)
  Eric Wong [off-list ref] (signer: 1%, acker: 1%)
  Elijah Newren [off-list ref] (author: 2%)
  Christian Couder [off-list ref] (author: 1%)
  Linus Torvalds [off-list ref] (signer: 1%)
  Derrick Stolee [off-list ref] (author: 1%)
  Jakub Narębski [off-list ref] (author: 1%)
  Johannes Sixt [off-list ref] (author: 1%)
  Eric Sunshine [off-list ref] (author: 1%)
  Stefan Beller [off-list ref] (author: 1%)
  Eric Wong [off-list ref] (author: 1%)
  SZEDER Gábor [off-list ref] (author: 1%)
  Paul Mackerras [off-list ref] (author: 1%, signer: 1%)
  Felipe Contreras [off-list ref] (author: 1%)
  Matthieu Moy [off-list ref] (signer: 1%)

git-related is similar to contrib/contacts/git-contacts, except with
many many more features, and less bugs. In fact, git-contacts is a
rewrite of git-related and it never achieved parity.

The v1.0 release consists of 81 commits, and here are some of the
important changes:

 * Make roles optional with --roles
 * Add new --files mode (much faster)
 * Fixed bug with boundary commits (present in git-contacts too)
 * Fixed bug with certain mailmaps
 * Parse many more roles (top 10%)
 * Completely revamped documentation
 * Add color
 * Improved performance
 * Improved tests
 * Code considerably simplified
 * Split option parsing into a new gem

To install them just:

  gem install parseopt
  make install

It's written in Ruby, so you need Ruby.

Cheers.

https://github.com/felipec/git-related

-- 
Felipe Contreras
Keyboard shortcuts
hback out one level
jnext message in thread
kprevious message in thread
ldrill in
Escclose help / fold thread tree
?toggle this help