disable markers without graph
[barcat.git] / graph
diff --git a/graph b/graph
index 20ce299d1121162cbcfdd480da2975d8ddb398a4..0d9db2e51c4aa110a11dabedb1219db7c3107f9b 100755 (executable)
--- a/graph
+++ b/graph
@@ -1,15 +1,18 @@
 #!/usr/bin/env perl
 use 5.014;
 use warnings;
-use List::Util qw( max sum );
+use utf8;
+use List::Util qw( min max sum );
 use open qw( :std :utf8 );
 
 our $VERSION = '1.00';
 
-use Getopt::Long '2.33';
+use Getopt::Long '2.33', qw( :config gnu_getopt );
 sub podexit { require Pod::Usage; Pod::Usage::pod2usage(-exitval => 0, @_) }
 GetOptions(\my %opt,
        'color|c!',
+       'trim|length|l=i',
+       'markers|m=s',
        'width|w=i',
        'usage|h' => sub { podexit() },
        'help'    => sub { podexit(-verbose => 2) },
@@ -21,20 +24,28 @@ my @lines = readline or exit;
 chomp for @lines;
 my @values = map { s/^\h* ( -? [0-9]* (?:\.[0-9]+)? )//x and $1 } @lines;
 my @order  = sort { $b <=> $a } grep { length } @values;
+if (defined $opt{trim}) {
+       my $trimpos = abs $opt{trim};
+       $trimpos <= 1 ? ($_ = substr($_, 0, 1)) :
+       (length > $trimpos and substr($_, $trimpos - 1) = '…') for @lines;
+}
+
 my $maxval = $order[0];
 my $minval = min $order[-1], 0;
-
 my $lenval = max map { length } @order;
-my $len    = 1 + max map { length } @lines;  # left padding
+my $len    = defined $opt{trim} && $opt{trim} <= 0 ? -$opt{trim} + 1 :
+       1 + max map { length } @lines;  # left padding
 my $size   = ($maxval - $minval) &&
        ($opt{width} - $lenval - $len) / ($maxval - $minval);  # bar multiplication
 
-sub orderpos { (($order[$_[0]] + $order[$_[0] + .5]) / 2 - $minval) * $size }
 my @barmark;
-$barmark[ (sum(@order) / @order - $minval) * $size ] = '=';  # average
-$barmark[ orderpos($#order / 2) ] = '+';  # mean
-$barmark[ -$minval * $size ] = '|' if $minval < 0;  # zero
-defined and $opt{color} and $_ = "\e[36m$_\e[0m" for @barmark;
+if ($opt{markers} // 1 and $size > 0) {
+       sub orderpos { (($order[$_[0]] + $order[$_[0] + .5]) / 2 - $minval) * $size }
+       $barmark[ (sum(@order) / @order - $minval) * $size ] = '=';  # average
+       $barmark[ orderpos($#order / 2) ] = '+';  # mean
+       $barmark[ -$minval * $size ] = '|' if $minval < 0;  # zero
+       defined and $opt{color} and $_ = "\e[36m$_\e[0m" for @barmark;
+}
 
 for my $nr (0 .. $#lines) {
        my $val = $values[$nr];
@@ -74,6 +85,38 @@ Each line starting with a number is given a bar to visualise relative sizes.
 
 Disable colored output of values and bar markers.
 
+=item -l, --length=[-]<size>
+
+Trim line contents (between number and bars)
+to a maximum number of characters.
+The exceeding part is replaced by an abbreviation sign,
+unless C<--length=0>.
+
+Prepend a dash (i.e. make negative) to enforce padding
+regardless of encountered contents.
+
+=item -m, --markers=
+
+Statistical positions to indicate on bars.
+Cannot be customized yet,
+only disabled by providing an empty argument.
+
+Any value enables all marker characters:
+
+=over 2
+
+=item B<=>
+
+Average:
+the sum of all values divided by the number of counted lines.
+
+=item B<+>
+
+Median:
+the middle value or average between middle values.
+
+=back
+
 =item -w, --width=<columns>
 
 Override the maximum number of columns to use.