prefer SIGINFO for statistics if available

A far more appropriate signal for non-quitting interrupts,
unfortunately only available on BSDs (bound to ctrl-T).

Keep fallback to SIGQUIT as support on linux does not seem imminent
:(http://lkml.iu.edu/hypermail/linux/kernel/1411.0/03374.html).

show statistics on SIGQUIT

Misuse this signal as it's the best suited on linux being usually bound to
ctrl-\.  The same behaviour can also be seen in at least ping from iputils.
GNU dd offers similar progress on SIGUSR1, but this cannot be bound by stty.

t: multiple command arguments

Worked around by bundling -t and -f in t1801, but will not always be
possible.

test for continuous progress option -t-1

graph-format option to change bar character

Set to # to revert back to v0.10 behaviour!

only ignore interrupt signal after input

Assume no input is an unpiped invocation a user tries to abort by ctrl-C.

progress after line count with negative --interval

respond to alarm signal regardless of interval

t: report missing output as TODO

TAP syntax to report expected failure.

t: replace shell scripts by pipe parameters in name

test unmarked, limits, stats, color

colored values in summary stats

increase value length for newline substitution

Off by one since inclusion of placeholders in commit v1.02-6-g05d1a75398
(2019-09-07) [value placeholder in contents].

t: colorize results on tty output

t: exit code reflects test failures

t: replace diff by comm for linewise comparison

Prevent skipped lines, assuming matching order is retained.
Similar output otherwise after prefix replacement.

test various formatting and options

documentation intro, info options

inline podexit code for --help, alias to -?

brief usage documentation reformatted from pod

Adjust pod text before and after rendering to better match other programs:
compact table of options described by only the first following line.

test inputless command behaviour

Start t00* by testing parameter handling.

test field selection and human readable output

test commands to compare usage output, prevent regeneration

Any corresponding *.sh is run for more complex tests, such as partial output
comparison for --usage results.  Does not have to be generated on -G, but
any existing files can be.

regenerate test output on regress.t -G option

parse options to regress.t

Reserve any parameters starting with a dash.
Show usage for unknown commands ie everything.

spaces and options in test file names

Replace underscores by spaces to facilitate human-readable titles in sane
file names, and apply parts following a space and dash ( -*) as command
parameters to allow testing of different options.

initial regression test suite

Simple script to run barcat with different input from *.in, comparing to
expected *.out files and returning results in TAP format.  Execution at
t/*.t for prove compatibility.

unmodified should avoid value alignment

customisable spark characters

Distributes over any number of unicode glyphs.  Hardcode interpreter for now
so -CA can be applied to easily decode arguments from UTF-8.

spark option to replace lines by single characters

Implement "sparklines" (one-line graph) by simply substituting Unicode block
elements U+2581-2588 relative to values.  Inspired by Zach Holman's `spark`
<https://github.com/holman/spark>.

earthquake feed example

As seen on <https://zachholman.com/spark/#cooler-usage>, but better suited
to demonstrate table markup.

date alternative on BSD variants including OSX

replace perl in example date parsing

Time::Piece was released with perl v5.8.9 but may not be installed on
restricted systems.  Hardcoding the number of days is less flexible but
"only" relies on a GNU date supporting -d.

Furthermore, git only supports date formatting since version 2.6.0,
so prefer an equivalent cut similar to earlier year selection.

additional git example for date history

Simplified version of a longtime alias of mine.

reset SIGINT after first ignoral

Ensure subsequent signals will break any unexpected hangs.

void color() shorthand to surround value

Include Term::ANSIColor::colored functionality.

color() function to prepare ansi escapes

Replace code for improved descriptiveness, identical output.  Minimal
implementation of Term::ANSIColor::color without various unwanted features.

shorten human-readable values to 2-3 digits

Similar to ls e.a.  Previously reserved 5 characters in order to align
decimal points, but this is pointless with mixed magnitudes.

fix sival log for negative/zero values

optional decimal point for human-readable integers

Retain input value precision.

declare pod encoding

Most renderers will output in the same encoding as the pod document,
which is ascii (causing an unaccented e for E<eacute>) or worse, latin1.
Best to explicitly use UTF-8 as all i/o should be.

escape unicode character in pod

Avoid perldoc error:

> Non-ASCII character seen before =encoding in 'Pokémon'. Assuming UTF-8

json example alternative without jq

External dependency not usually installed, so describe separately.

explain options introduced in examples

read utf-8 input in letter frequency example

reorder examples by complexity

Move snippets around to logically introduce different features.

do not trim valueless contents

omit empty value statistics

order incoming values before interval

If Tie::Array::Sorted is available, use it to insert input in order instead
of recalculating on every interval.  Assumes frequent refreshes of thousands
of lines, in which case it saves significantly, also slowing down less
exponentially (probably O(l) instead of O(t*l²)).

keep ordered values, only resort on interval

Massive speedup per calculation.

indicate limited results in stats

silence warnings on empty input

include total, min, avg, max in stat details

stat (-s) option to summarise totals at end

minor code cleanup for human formatting

align human values, reserve constant length

omit source code position in regex error message

compile regular expression to -f (without /x)

Reports syntax errors immediately.

support values with float suffixes e±N

prepare anchor match during option parsing

prepare regex to match values

Code cleanup, slight speedup.

exponent fallback in case of unit overflow

Guard against missing units.

move human formatting code into sival() function

decrease divider for small human numbers

human-readable (-H) option to abbreviate numbers

Retain 2-3 significant digits and letter n-T for size.  Similar to -h in
ls, du, df, free, rsync, sort; except forgoing byte-specific powers of 1024
in favour of actually _human_ SI powers of 1000.

Common option shorthand -h conflicts with help, but capital -H has a
precedent in df --si so may be more appropriate.

combined limit minimum-maximum

minimum limit to override start line number

Internal option --hidemin or by negative -L instead of maximum.

empty limit support (hidemax internally)

limit (-L) option to stop output

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.