NAME

Math::Histo::CLI - In-Process CLI Toolkit Execution for Math::Histo

SYNOPSIS

use Math::Histo::CLI;

# Execute the multi-call CLI dispatcher in-process
my $status = Math::Histo::CLI->run('plot', 'data.histo', '--style=shaded');

# Pipe/fill data directly
my $status = Math::Histo::CLI->run('fill', '--bins=50', '--min=0', '--max=100', 'samples.txt');

DESCRIPTION

Math::Histo::CLI exposes the modular C99 CLI and terminal visualization toolkit (libhistocli) directly to Perl in-process without spawning subprocesses or requiring external executable binary lookups.

Available Subcommands: - fill: Stream data in, aggregate into 1D/2D histogram, and emit serialized output. - plot: Render histogram as ASCII, Unicode blocks, shaded bars, or sparklines. - stats: Display comprehensive statistical summary, moments, and quantiles. - fit: Fit parametric models (Gaussian, Exponential, Polynomial, Breit-Wigner). - cmp: Compare two histograms and compute statistical distance metrics.

METHODS

run(@args)

Executes the CLI dispatcher with the given command-line argument list. Returns integer exit status code (0 for success).

run_raw(@argv)

Executes the CLI dispatcher where $argv[0] is the program invocation name.

SEE ALSO

• Math::Histo

• Alien::libhisto

AUTHOR

Steffen Mueller <cpan@steffen-mueller.net>

LICENSE

MIT License. Copyright (c) 2026 Steffen Mueller and libhisto contributors.