GetOptions(\my %opt,
'debug!',
+ '', # stdin
'count|c!',
'simplify|s:s',
'ignore-case|i!',
+ 'fuzzy!',
+ 'grep|S=s',
'min|min-count|unique|u:i',
'max|max-count|show|n:i',
+ 'hash|H!',
'version|V' => sub { Getopt::Long::VersionMessage() },
'usage|h' => sub { Getopt::Long::HelpMessage() },
'help|man|?' => sub { Getopt::Long::HelpMessage(-verbose => 2) },
) or exit 129;
+my $inputstream = $opt{''} ? \*ARGV : eval {
+ require Git;
+ Git::command_output_pipe('log', '-z', '--pretty=format:%h%n%b', @ARGV);
+} || die "Automatic git log failed: $@";
+
local $| = 1;
local $/ = "\0";
-my $HEADERMATCH = qr/ [a-z]+ (?: (?:-\w+)+ | \ by ) /ix;
+my $HEADERMATCH = qr/ [a-z]+ (?: (?:-\w+)+ | \ by ) | cc | reference /ix;
my (%headercount, @headercache);
-while (readline) {
- s/(.+)\n//m;
- my $hash = $1;
+while (readline $inputstream) {
+ s/^([0-9a-f]{4,40})\n//m;
+ my $hash = $opt{hash} ? $1 : undef;
# strip commit seperator
chomp;
# if invalid, assume it's latin1
$_ = decode(cp1252 => $_) if $@;
- my $prefix = 0;
- my %attr;
-
BLOCK:
for (reverse split /\n\n/) {
my @headers;
+ my $prefix = 0;
LINE:
for (split /\n/) {
push @header, $_ if defined $opt{max};
+ if ($opt{fuzzy}) {
+ for ($header[0]) {
+ tr/ _/-/;
+
+ state $BY = qr{ (?: -? b[yu] )? \Z }ix;
+ s{^ si (?:ge?n|n?g) (?:e?[dt])? -? (?:of+)? $BY}{Signed-off-by}ix;
+ s{^ ack (?:ed|de)? $BY}{Acked-by}ix;
+ s{^ review (?:e?d)? $BY}{Reviewed-by}ix;
+ s{^ teste[dt] $BY}{Tested-by}ix;
+ }
+ }
+
+ if (defined $opt{grep}) {
+ $_ ~~ qr/$opt{grep}/i or next LINE;
+ }
+
given ($opt{simplify} // 'none') {
when (['email', 'authors']) {
$header[1] =~ s{
}{<...>}imsx;
}
when (['var', 'vars', '']) {
- when ($header[0] =~ /[ _-] (?: by | to ) $/imsx) {
+ when ($header[0] =~ /[ _-] (?: by | to ) $ | ^cc$/imsx) {
$header[1] = undef;
}
for ($header[1]) {
next BLOCK if not @headers;
if ($opt{debug} and $prefix) {
- say "infix junk in commit $hash";
+ say sprintf ': invalid lines in %s (%s)', $hash // 'block', $prefix;
}
for (@headers) {
my $line = $_->[2] // join(': ', @$_);
- if (defined $opt{min} or $opt{max}) {
+ $line =~ s/^/$hash / if defined $hash;
+
+ if (defined $opt{min} or $opt{max} or $opt{count}) {
my $counter = \$headercount{ $_->[0] }->{ $_->[1] // '' };
my $excess = $$counter++ - ($opt{min} // 0);
next if $excess >= ($opt{max} || 1);
=head1 SYNOPSIS
-F<git> log --pretty=%b%x00 | F<git-grep-footer> [OPTIONS]
+F<git-grep-footer> [OPTIONS] [-- <git log options>]
+
+F<git> log -z --pretty=format:%b | F<git-grep-footer> [OPTIONS] -
=head1 DESCRIPTION
C<Signed-off-by> and C<Acked-by>.
Sections are identified by at least one leading keyword containing a dash
+(or exceptionally recognised)
followed by a colon.
=head1 OPTIONS
=back
+=item --grep=<pattern>
+
+Only include lines matching the specified regular expression.
+Case insensitivity can be disabled by prepending C<(?-i)>.
+
=item -u, --unique[=<threshold>]
Each match is only shown once,
but simplifications still apply for duplicate determination.
Additional samples are optionally given upto the given maximum.
+=item -c, --count
+
+Prefixes (unique) lines by the number of occurrences.
+Causes output to be buffered until all input has been read (obviously).
+
+=item -H, --hash
+
+Prefixes the SHA1 hash of the (or a) matching commit.
+
+=back
+
+=head1 EXAMPLES
+
+=over
+
+=item git-grep-footer --grep=^ack v2.6.32..v2.6.33
+
+Search for I<Acked-by> lines for version I<v2.6.33>.
+Append C<-uin> to skip reoccurrences.
+
+=item git-grep-footer -u --grep=junio
+
+Show distinct lines mentioning a specific author.
+
+=item git-grep-footer -c --simplify --grep=^si
+
+Compare various capitalisations and (mis)spellings of signoffs.
+
+=item git-grep-footer -c --simplify=all -i | sort -n -r | head -n10
+
+List the ten most frequently used attribute names.
+
+=item git-grep-footer -n2 -i -s --hash -- --reverse
+
+The earliest two usages of each distinct identifier.
+
=back
=head1 AUTHOR
=head1 LICENSE
-Copyright. All rights reserved.
+This software is free software;
+you can redistribute and/or modify it under the terms of the GNU GPL
+version 2 or later.