hello barcat =^.^=

Everybody loves cats!

rename program to barcat

English word `graph` is too common and indistinct for general distribution,
already conflicting with /usr/bin/graph from plotutils (Debian bug #61319).

graph length rounded to nearest integer

Even distribution, and fixes unexpected overflows due to inexact float
representation after size calculation (round decimals being decremented).

value-length option to override $lenval

field selection by regex anchor

Backwards-compatible with field numbers as digits should not be number
delimiters, or could be queried like -f'(?:0)'.

retain unsubstituted line contents

Fix length recalculation after interval.

field (-f) option to select later values

value placeholder in contents

Replace original position to support later occurrences.

ignore length of valueless lines in padding

Excluded from graph, so do not pad other contents to align.

shorthand -C to disable color

There is precedent for capitalisation to negate, along with +c which is not
supported by Getopt::Long.

rename follow option to --interval or -t

Initially copied f(ollow) from tail, but that letter will be better suited
for field selection, and the function is only similar.

Alternatives include -s (closer equivalent to tail, also in free --seconds),
-i as in ping --interval (best match, but should be reserved for interactive
or ignore-case), -n like watch --interval, and -v as verbose interpretation.
Settle on -t for best mnemonics; common for time(out) and found in preferred
longhand of inTerval.

another json example with multiple columns

Also found this API with the same results (and more), but needs separate
queries which is slow and unwanted so unsuitable as a fun snippet:

curl -s https://pokeapi.co/api/v2/pokemon/{1..151} |
jq -r '[.height/10,.id,.name|tostring] | join(" ")' | graph

examples with csv, xml, and json data

Practical usage with most common file types.

calculate length percentages of width

Shorthand to facilitate relative sizes without manual preparation.
Allow strings so trailing % can be accepted.

enable lexical subs before perl v5.26

Introduced in perl v5.18 and experimental until recently.

skip recalculation of unprogressed data

strip trailing carriage returns

Support CRLF line termination regardless of system record separator,
preventing mangled output due to column returns before appended graphs.
Besides Windows files, \r is also added by unbuffer -p for some reason.

describe -u, rename to --unmodified

unclean (-u) option to keep leading whitespace

man page rendering of --help pod

Emulate git --help including terminal escapes.

transition bar to visualise changed scale

Indicate increased maximum with --follow.

ignore SIGINT so partial input is shown

Assume interrupt stops pipes and we can continue.  Subsequent signals will
then be reset so calculation can still be killed.

color default depends on stdout being isatty

follow (-f) option to output partial results

Calculate and display on every SIGALRM, with scale and statistics upto that
point.  Named like equivalent tail -f.

parse values while reading lines

Manipulate input as it comes in, spreading the load and having values ready
for upcoming interrupts without a separate phase to repeat.

separate project repository

Commits moved out of home and cleaned for public distribution.
Version bump to celebrate.

avoid drawing empty graph

markers < > at standard deviation offsets

disable markers without graph

Avoid error "Modification of non-creatable array value attempted"
trying to access unallocated positions.

cut after assumed delimiter on --trim=0

omit abbreviation mark on --trim=1

The first character should be whitespace or another delimiter to be kept.
Contents can be assumed cut and does not need an indicator.

include value delimiter in trim length

trim maximum unless negative

trim (-l) option to abbreviate contents

markers (-m) option to omit statistical markers

Support leaving bars untouched for either aesthetical reasons or to avoid
calculation (which may yet be(come) costly or buggy).

String argument is only checked for emptiness, otherwise all positions are
enabled.  Effectively boolean but with future compatibility for more
detailed customisation.

negative values less than positive

Extend graph to the lowest value, with axis marked by |.

pass through numberless lines

Ignore in statistics, and silence perl warnings about arguments not being
numeric.

floating point value support

Include numbers after decimal point; perl will handle it no problem.
Replace stupid digit calculation without number reformatting by simple
string length, also fixing log error on 0 values.

negative value support

Include integers less than zero; treat as positive for bar sizes.

assume standard input/output is utf8

Fixes length calculation of unicode data.

color option to disable formatting codes

document practical example oneliners

Some shell commands adapted from personal history.  After pictures,
code should also be worth quite some words.

short and long help options

Emulate git commands in having -h for usage distinct from --help for full
documentation.

minimal documentation and help options

parse options to override width

indicate average value in bar

coloured bar markers

prepare to facilitate other distribution markers

prepare bar positions of (mean) indicators

indicate mean value in bar position

Better visual, and accurate in case of split middle.

distinguish median value

Greater number in case of even lines.

minimum and maximum values in red and green

reformat and colourise numbers

Replace captured values in dark grey, with minimal padding
(uniq adds at least 6 spaces we can use for graphing).

write out script, enable warnings

Mostly the same code but more readable and maintainable.
Integers are captured and bars enlarged to fill screen width.

draw bar graph for input values

Written as one-liner to visualise output from uniq -c (i.e. git history).