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.
- --jobs
[auto|max|INTEGER]
- Number of parallel jobs. Accepts an integer, 'auto' (one fewer than the
host's logical CPUs) or 'max' (all logical CPUs). 0 runs
sequentially.
- -h / --help
- 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' (one fewer than the
host's logical CPUs) or 'max' (all logical CPUs). 0 runs
sequentially.
- TRAIL_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.