click-extra trail - Trace a simulated batch of operations behind
an operation trail.
click-extra trail [OPTIONS]
Trace a simulated batch of operations behind an operation
trail.
Roasts a handful of make-believe vegetables (each a short pause,
the leeks scorching) and reports them as they land. The display follows the
batch: with --jobs 1 each outcome echoes as a plain line; with two or more
jobs a spinner carries the running tally while outcomes stream above it;
--progress-bar swaps that spinner for a determinate progress bar. Add --time
to append each vegetable's roast time and the batch total; --elapsed and
--eta turn that on too, counting up from zero or down as an estimate. Honors
--progress / --no-progress and stays silent off an interactive terminal.
- --progress-bar
- Drive the batch with a determinate progress bar instead of a spinner.
- --eta /
--elapsed
- For --progress-bar, show the time remaining (--eta) or elapsed
(--elapsed); either one turns timing on, like --time. A spinner always
shows elapsed time.
- --spinner
NAME
- Aggregate spinner animation for concurrent runs (see the spinner command
for names). Defaults to the built-in spinner; ignored with --progress-bar.
[values: aesthetic, arc, arrow, arrow2, arrow3, balloon, balloon2,
beta-wave, binary, blue-pulse, bounce, bouncing-ball, bouncing-bar,
box-bounce, box-bounce2, christmas, circle, circle-halves,
circle-quarters, clock, dots, dots-8bit, dots-circle, dots10, dots11,
dots12, dots13, dots14, dots2, dots3, dots4, dots5, dots6, dots7, dots8,
dots9, dqpb, dwarf-fortress, earth, finger-dance, fish, fist-bump, flip,
grenade, grow-horizontal, grow-vertical, hamburger, hearts, layer, line,
line2, material, mindblown, monkey, moon, noise, orange-blue-pulse,
orange-pulse, pipe, point, pong, rolling-line, runner, sand, shark,
simple-dots, simple-dots-scrolling, smiley, soccer-header, speaker,
square-corners, squish, star, star2, toggle, toggle10, toggle11, toggle12,
toggle13, toggle2, toggle3, toggle4, toggle5, toggle6, toggle7, toggle8,
toggle9, triangle, weather]
- --jobs
[auto|max|INTEGER]
- Number of parallel jobs. Accepts an integer, auto (the host's logical CPUs
minus one) or max (all logical CPUs). --jobs 0 runs sequentially.
- --help /
-h
- Show this message and exit.
- TRAIL_USE_BAR
- Drive the batch with a determinate progress bar instead of a spinner.
- TRAIL_ETA
- For --progress-bar, show the time remaining (--eta) or elapsed
(--elapsed); either one turns timing on, like --time. A spinner always
shows elapsed time.
- TRAIL_SPINNER_NAME
- Aggregate spinner animation for concurrent runs (see the spinner command
for names). Defaults to the built-in spinner; ignored with
--progress-bar.
- TRAIL_JOBS
- Number of parallel jobs. Accepts an integer, auto (the host's logical CPUs
minus one) or max (all logical CPUs). --jobs 0 runs sequentially.
- TRAIL__CLICK_DEFAULT_HELP
- Show this message and exit.
- 0
- Success.
- 1
- A runtime error, or an aborted prompt (Ctrl-C, a declined
confirmation).
- 2
- A usage error: unknown option, invalid value, missing operand, or an
unparsable configuration file.