git-graph: add usage message

[u/fanf2/git-graph.git] / git-graph

diff --git a/git-graph b/git-graph
index d9bd62d..5e627af 100755 (executable)
--- a/git-graph
+++ b/git-graph
@@ -9,25 +9,32 @@ use Term::ReadKey;
 
 $0 =~ s{^.*/([^/]+)$}{$1};
 
-sub stop { exit 1; } # because 'die' uses a weird exit status
-sub wail { warn "$0: @_\n"; }
-sub fail { wail @_; stop; }
-sub fale { fail "@_: $!"; }
-
 my %opt;
 GetOptions(\%opt, qw{
        cancel|c
+       height|h=i
        overlay|o
        stack|s
-}) or stop;
+       width|w=i
+}) or do {
+       print STDERR <<END;
+usage: git-graph [options]
+       -c | --cancel   +/- counts cancel out
+       -o | --overlay  +/- counts are overlaid as # (default)
+       -s | --cancel   +/- counts are stacked
+       --height [n]    Set height of graph
+       -h [n]          (height of terminal is default)
+       --width [n]     Set horizontal scale
+       -w [n]          (fit to width of terminal by default)
+END
+       exit 1;
+};
 
-$opt{stack} = 1 unless $opt{cancel} or $opt{overlay};
+$opt{overlay} = 1 unless $opt{cancel} or $opt{stack};
 
 my @terminal = GetTerminalSize;
-my $width = $terminal[0] - 10;
-my $height = $terminal[1];
-
-my @log = qx{git log --pretty=format:%ct --no-merges --shortstat --since='$height days ago'};
+my $width = $terminal[0] - 11;
+my $height = $opt{height} // $terminal[1] - 2;
 
 my %add;
 my %del;
@@ -36,33 +43,29 @@ my $addmax = 0;
 my $delmax = 0;
 my $canmax = 0;
 
-while (@log) {
-       my $date = shift @log;
-       my $stat = shift @log;
-       my $blank = shift @log;
-       fail "bad blank line $blank"
-           unless not defined $blank or $blank eq "\n";
-       fail "truncated git log output"
-           unless defined $date and defined $stat;
-       chomp ($date, $stat);
-       $date =~ m{^[0-9]{10}$} or fail "bad timestamp $date";
-       $date = int ($date / 86400);
-       $stat =~ m{^\ \d+\ files?\ changed
-                  (?:,\ (\d+)\ insertion[s()+]+)?
-                  (?:,\ (\d+)\ deletion[s()-]+)?$}x
-           or fail "bad stats $stat";
+my $date;
+
+for (qx{git log --pretty=format:%ct --shortstat --since='$height days ago'}) {
+       next if m{^\s*$};
+       if (m{^(\d{10})\n$}) {
+               $date = int ($1 / 86400);
+               next;
+       }
+       m{^\ \d+\ files?\ changed
+         (?:,\ (\d+)\ insertion[s()+]+)?
+          (?:,\ (\d+)\ deletion[s()-]+)?$}x
+           or die "$0: bad stats $_";
        my ($add,$del) = ($1 || 0, $2 || 0);
        $add{$date} += $add;
        $del{$date} += $del;
        $addmax = $add{$date} if $addmax < $add{$date};
        $delmax = $del{$date} if $delmax < $del{$date};
-       my $can = $add{$date} > $del{$date} ?
-                 $add{$date} - $del{$date} :
-                 $del{$date} - $add{$date};
+       my $can = abs $add{$date} - $del{$date};
        $canmax = $can if $canmax < $can;
 }
 
-my $max = $opt{cancel} ? $canmax :
+my $max = $opt{width} ? $opt{width} :
+    $opt{cancel} ? $canmax :
     $opt{stack} ? $addmax + $delmax :
     $addmax > $delmax ? $addmax : $delmax;
 my $scale = $width / $max;
@@ -70,40 +73,38 @@ my $scale = $width / $max;
 my $today = int (time / 86400);
 
 for my $date ($today - $height .. $today) {
-       my $add;
-       my $del;
-       my $mod;
+       my $add = 0;
+       my $del = 0;
+       my $mod = 0;
        $add{$date} //= 0;
        $del{$date} //= 0;
-       if ($opt{cancel}) {
+       if ($opt{cancel} or $opt{overlay}) {
                if ($add{$date} > $del{$date}) {
                        $add = $add{$date} - $del{$date};
-                       $del = $mod = 0;
                } else {
                        $del = $del{$date} - $add{$date};
-                       $add = $mod = 0;
                }
        }
        if ($opt{overlay}) {
-               if ($add{$date} > $del{$date}) {
-                       $add = $add{$date} - $del{$date};
-                       $del = 0;
-                       $mod = $del{$date};
-               } else {
-                       $del = $del{$date} - $add{$date};
-                       $add = 0;
-                       $mod = $add{$date};
-               }
+               $mod = $add{$date} < $del{$date} ?
+                      $add{$date} : $del{$date};
        }
        if ($opt{stack}) {
                $add = $add{$date};
                $del = $del{$date};
-               $mod = 0;
        }
        my $greg = strftime "%b %d %w", localtime $date * 86400;
        $greg =~ s{(\d)$}{substr "sMTWTFs", $1, 1}e;
-       printf "$greg \e[33m%s\e[32m%s\e[31m%s\e[0m\n",
+       my $line = sprintf "$greg \e[33m%s\e[32m%s\e[31m%s\e[0m\n",
            "#" x ($mod && 1 + $mod * $scale),
            "+" x ($add && 1 + $add * $scale),
            "-" x ($del && 1 + $del * $scale);
+       if (length $line > $width) {
+               $line = sprintf "## %d ##\e[32m++ %d ++\e[31m-- %d --\e[0m\n",
+                   $mod, $add, $del;
+               $line = "$greg \e[33m" . "#"x($width + 16 - length $line) . $line;
+       }
+       print $line;
 }
+printf "         \e[33m#\e[0m <- %-8.1f %s %8d ->\n",
+    1/$scale, " " x ($width - 25), $max;