Keyboard shortcuts

Press ← or → to navigate between chapters

Press S or / to search in the book

Press ? to show this help

Press Esc to hide this help

Terminal presentation

Fastmash makes terminal results easier to scan with purple headings, blue result values, green completion marks, amber advisories and red failures. Secondary metadata uses gray. All styles use your terminal’s default background.

Ordinary calculations and Top-N selection show labeled, aligned fields and a ✔ Completed footer after successful processing. Headers appear even without --header-out. Automatic headers use positional labels such as sum(field-1). Use -H or --header-out to request labels from an input header. Results still stream as they become available. Alignment uses at most 32 columns per field, while labels and values are always printed in full. A failure can leave earlier results visible, followed by a diagnostic. It does not receive a completion mark. Numerical values and their formatting are unchanged.

Readable table-health reports put the outcome and findings ahead of input metadata. ⚠ identifies advisory findings, and ✗ identifies violations of supplied expectations. Successful validation uses ✔ and explicitly refers to the supplied expectations. Inferred findings remain advisory even when validation passes. Field counts, examples, omissions and interpretation details remain in the report.

Files, pipes and explicit formats

Output sent to a file or another program keeps its existing plain format, including readable health reports. It gains no headings, padding, symbols or color codes, even with --color=always. Examples that write a report file show its data format.

Explicit CSV output, NUL-terminated output, an explicit output delimiter, vnlog, crosstab, dataset comparison, field and table transformations, health TSV and version output retain their data formats on terminals too. This lets you inspect those formats directly without a presentation layer changing their structure.

Controls

fastmash --color=auto sum 1
fastmash --no-color sum 1
fastmash --color=always --help

auto is the default. Each destination is checked separately. Redirecting stdout does not disable colored diagnostics on a terminal. TERM=dumb, a nonempty NO_COLOR, or failed terminal detection disables automatic styling. An empty NO_COLOR permits it. never and --no-color disable the terminal presentation, including bold, added headers and completion marks.

always overrides environment suppression on a terminal. It can also force color in redirected help and diagnostics, but never decorates redirected results or health reports. Diagnostics style only their program prefix and failure mark, leaving the explanation, hints and input bytes in the default foreground.

Repeated controls follow the last one reached by ordinary option scanning. -- ends scanning, and POSIXLY_CORRECT stops it at the first operand. Help and version stop scanning immediately, so put color controls before them.