test color output

test more sine wave input

Longer range generated by perl -E 'say cos($_/8) for -3..96';

renumber first tests

integer sinewave test data input

Keep potential floating point complications for later tests.

width option fallback to tput

Environment variable is not exported on some systems.

extended palettes for 88-256 color terminals

Preset options for 88-color urxvt or 256-color xterm ea:
instead of 3 shades of whites, offers 12 in ramp88 and 23 in greys;
similarly increases 7 values of fire to 11 for fire88 and 17 for fire256.

named palette presets fire, whites

Inspired by <https://github.com/sindresorhus/sparkly>, a js spark port.
Different from its {style:'fire'} in being 16-color compatible and having
red at the lower end (matching lower temperature to low values).

distribute palette parameters over value range

test combined modifiers on currency input

test download examples (currency, earthquakes, pokemon)

minval/maxval options to override bar range

customizable format for markers option

palette option to customize value colors

colored header like values

header option to prepend value scale

Single top line to indicate minimum and maximum values, similar to scale in
common-lisp vspark <https://github.com/tkych/cl-spark>.

override version option to only show main program

Default Getopt::Long results include environment-specific details unlike
most other programs, maybe enforcing minimal details in some bug reports,
but making test output non-portable.

explain spark option parameters

document spark option

Added in commit v1.04-17-gf4423db967 (2019-09-10).

remove lower scan line from spark default

Unlike other spark implementations, an additional -lowest- character U+23BD
was added accidentally, which fits perfectly in Unifont, but may be very
unreliable in other fonts.

force exit on interrupt signal

Display everything even if pipe does not abort.

signal-stat option to override signal name

Try to please everybody (or in case of unknown environment differences).

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.