miller/pkg/transformers
John Kerl 570fcf0de4
Remove os.Exit callsites below the entrypoint: phase 3 (plans/exit.md) (#2204)
Phase 3 of plans/exit.md: the streaming-interface change, the load-bearing
piece for #341 (DSL exit statement) and #440 (strict mode).

- RecordTransformer.Transform and RecordTransformerFunc now return error.
  All 69 Transform implementations and their dispatch helpers updated
  (mechanical rewrite, compiler- and errcheck-verified).
- runSingleTransformerBatch, on a Transform error, forwards any output
  produced before the failure plus an end-of-stream marker downstream, so
  the rest of the chain and the record-writer drain and finish cleanly;
  runSingleTransformer then surfaces the error to stream.Stream's select
  loop (non-blocking send; first error wins) and signals upstream-done so
  the record-reader stops. This is exactly the flush-then-exit sequencing a
  future DSL 'exit N' needs.
- dataProcessingErrorChannel and FileOutputHandler.recordErroredChannel are
  now chan error instead of chan bool; ChannelWriter still prints write-
  error details at the site and sends the 'exiting due to data error'
  sentinel, preserving the exact stderr shape pinned by regression cases.
- Mid-stream os.Exit sites converted to returned errors: put/filter DSL
  begin/main/end-block errors and the non-boolean filter-expression case,
  tee write/close failures, split write/open/close failures, join left-file
  ingest failures (both half-streaming and sorted paths, with full error
  plumbing through JoinBucketKeeper), histogram/stats2 ingest errors, surv
  fit errors, and step stepper allocation (tStepperAllocator now returns
  (tStepper, error); bad EWMA coefficients propagate; negative slwin
  parameters are reported by the CLI parser via the existing
  bad-stepper-name pattern).
- The two genuinely internal join-bucket-keeper states now use
  lib.InternalCodingErrorWithMessageIf instead of hand-rolled print+exit.
- pkg/transformers is now os.Exit-free.

Behavior notes: the non-boolean filter message gains the standard 'mlr: '
prefix and a newline (it previously printed with neither); tee errors now
include the underlying cause. All 4779 regression cases pass unchanged;
mlr head early-out latency is unaffected (0.02s over 50M records).

Co-authored-by: Claude Fable 5 <noreply@anthropic.com>
2026-07-15 15:07:09 -04:00
..
utils Remove os.Exit callsites below the entrypoint: phase 3 (plans/exit.md) (#2204) 2026-07-15 15:07:09 -04:00
aaa_chain_transformer.go Remove os.Exit callsites below the entrypoint: phase 3 (plans/exit.md) (#2204) 2026-07-15 15:07:09 -04:00
aaa_record_transformer.go Remove os.Exit callsites below the entrypoint: phase 3 (plans/exit.md) (#2204) 2026-07-15 15:07:09 -04:00
aaa_transformer_json.go Tier-2 structured verb options: OptionSpec, initial migration (#2098) (#2111) 2026-07-03 14:27:23 -04:00
aaa_transformer_json_test.go Tier-2 structured verb options: OptionSpec, initial migration (#2098) (#2111) 2026-07-03 14:27:23 -04:00
aaa_transformer_table.go Add bootstrap-ci verb for bootstrap-resampling confidence intervals (#1670) (#2189) 2026-07-14 17:00:34 -04:00
aaa_verb_usage.go Tier-2 structured verb options: OptionSpec, initial migration (#2098) (#2111) 2026-07-03 14:27:23 -04:00
altkv.go Remove os.Exit callsites below the entrypoint: phase 3 (plans/exit.md) (#2204) 2026-07-15 15:07:09 -04:00
bar.go Remove os.Exit callsites below the entrypoint: phase 3 (plans/exit.md) (#2204) 2026-07-15 15:07:09 -04:00
bootstrap.go Remove os.Exit callsites below the entrypoint: phase 3 (plans/exit.md) (#2204) 2026-07-15 15:07:09 -04:00
bootstrap_ci.go Remove os.Exit callsites below the entrypoint: phase 3 (plans/exit.md) (#2204) 2026-07-15 15:07:09 -04:00
bootstrap_ci_test.go Remove os.Exit callsites below the entrypoint: phase 3 (plans/exit.md) (#2204) 2026-07-15 15:07:09 -04:00
case.go Remove os.Exit callsites below the entrypoint: phase 3 (plans/exit.md) (#2204) 2026-07-15 15:07:09 -04:00
cat.go Remove os.Exit callsites below the entrypoint: phase 3 (plans/exit.md) (#2204) 2026-07-15 15:07:09 -04:00
check.go Remove os.Exit callsites below the entrypoint: phase 3 (plans/exit.md) (#2204) 2026-07-15 15:07:09 -04:00
clean_whitespace.go Remove os.Exit callsites below the entrypoint: phase 3 (plans/exit.md) (#2204) 2026-07-15 15:07:09 -04:00
count.go Remove os.Exit callsites below the entrypoint: phase 3 (plans/exit.md) (#2204) 2026-07-15 15:07:09 -04:00
count_similar.go Remove os.Exit callsites below the entrypoint: phase 3 (plans/exit.md) (#2204) 2026-07-15 15:07:09 -04:00
cut.go Remove os.Exit callsites below the entrypoint: phase 3 (plans/exit.md) (#2204) 2026-07-15 15:07:09 -04:00
decimate.go Remove os.Exit callsites below the entrypoint: phase 3 (plans/exit.md) (#2204) 2026-07-15 15:07:09 -04:00
describe.go Remove os.Exit callsites below the entrypoint: phase 3 (plans/exit.md) (#2204) 2026-07-15 15:07:09 -04:00
doc.go
fill_down.go Remove os.Exit callsites below the entrypoint: phase 3 (plans/exit.md) (#2204) 2026-07-15 15:07:09 -04:00
fill_empty.go Remove os.Exit callsites below the entrypoint: phase 3 (plans/exit.md) (#2204) 2026-07-15 15:07:09 -04:00
flatten.go Remove os.Exit callsites below the entrypoint: phase 3 (plans/exit.md) (#2204) 2026-07-15 15:07:09 -04:00
format_values.go Remove os.Exit callsites below the entrypoint: phase 3 (plans/exit.md) (#2204) 2026-07-15 15:07:09 -04:00
fraction.go Remove os.Exit callsites below the entrypoint: phase 3 (plans/exit.md) (#2204) 2026-07-15 15:07:09 -04:00
gap.go Remove os.Exit callsites below the entrypoint: phase 3 (plans/exit.md) (#2204) 2026-07-15 15:07:09 -04:00
grep.go Remove os.Exit callsites below the entrypoint: phase 3 (plans/exit.md) (#2204) 2026-07-15 15:07:09 -04:00
group_by.go Remove os.Exit callsites below the entrypoint: phase 3 (plans/exit.md) (#2204) 2026-07-15 15:07:09 -04:00
group_like.go Remove os.Exit callsites below the entrypoint: phase 3 (plans/exit.md) (#2204) 2026-07-15 15:07:09 -04:00
having_fields.go Remove os.Exit callsites below the entrypoint: phase 3 (plans/exit.md) (#2204) 2026-07-15 15:07:09 -04:00
head.go Remove os.Exit callsites below the entrypoint: phase 3 (plans/exit.md) (#2204) 2026-07-15 15:07:09 -04:00
histogram.go Remove os.Exit callsites below the entrypoint: phase 3 (plans/exit.md) (#2204) 2026-07-15 15:07:09 -04:00
join.go Remove os.Exit callsites below the entrypoint: phase 3 (plans/exit.md) (#2204) 2026-07-15 15:07:09 -04:00
json_parse.go Remove os.Exit callsites below the entrypoint: phase 3 (plans/exit.md) (#2204) 2026-07-15 15:07:09 -04:00
json_stringify.go Remove os.Exit callsites below the entrypoint: phase 3 (plans/exit.md) (#2204) 2026-07-15 15:07:09 -04:00
label.go Remove os.Exit callsites below the entrypoint: phase 3 (plans/exit.md) (#2204) 2026-07-15 15:07:09 -04:00
latin1_to_utf8.go Remove os.Exit callsites below the entrypoint: phase 3 (plans/exit.md) (#2204) 2026-07-15 15:07:09 -04:00
merge_fields.go Remove os.Exit callsites below the entrypoint: phase 3 (plans/exit.md) (#2204) 2026-07-15 15:07:09 -04:00
most_or_least_frequent.go Remove os.Exit callsites below the entrypoint: phase 3 (plans/exit.md) (#2204) 2026-07-15 15:07:09 -04:00
nest.go Remove os.Exit callsites below the entrypoint: phase 3 (plans/exit.md) (#2204) 2026-07-15 15:07:09 -04:00
nothing.go Remove os.Exit callsites below the entrypoint: phase 3 (plans/exit.md) (#2204) 2026-07-15 15:07:09 -04:00
put_or_filter.go Remove os.Exit callsites below the entrypoint: phase 3 (plans/exit.md) (#2204) 2026-07-15 15:07:09 -04:00
rank.go Remove os.Exit callsites below the entrypoint: phase 3 (plans/exit.md) (#2204) 2026-07-15 15:07:09 -04:00
README.md
regularize.go Remove os.Exit callsites below the entrypoint: phase 3 (plans/exit.md) (#2204) 2026-07-15 15:07:09 -04:00
remove_empty_columns.go Remove os.Exit callsites below the entrypoint: phase 3 (plans/exit.md) (#2204) 2026-07-15 15:07:09 -04:00
rename.go Remove os.Exit callsites below the entrypoint: phase 3 (plans/exit.md) (#2204) 2026-07-15 15:07:09 -04:00
reorder.go Remove os.Exit callsites below the entrypoint: phase 3 (plans/exit.md) (#2204) 2026-07-15 15:07:09 -04:00
repeat.go Remove os.Exit callsites below the entrypoint: phase 3 (plans/exit.md) (#2204) 2026-07-15 15:07:09 -04:00
reshape.go Remove os.Exit callsites below the entrypoint: phase 3 (plans/exit.md) (#2204) 2026-07-15 15:07:09 -04:00
sample.go Remove os.Exit callsites below the entrypoint: phase 3 (plans/exit.md) (#2204) 2026-07-15 15:07:09 -04:00
sec2gmt.go Remove os.Exit callsites below the entrypoint: phase 3 (plans/exit.md) (#2204) 2026-07-15 15:07:09 -04:00
sec2gmtdate.go Remove os.Exit callsites below the entrypoint: phase 3 (plans/exit.md) (#2204) 2026-07-15 15:07:09 -04:00
seqgen.go Remove os.Exit callsites below the entrypoint: phase 3 (plans/exit.md) (#2204) 2026-07-15 15:07:09 -04:00
shuffle.go Remove os.Exit callsites below the entrypoint: phase 3 (plans/exit.md) (#2204) 2026-07-15 15:07:09 -04:00
skip_trivial_records.go Remove os.Exit callsites below the entrypoint: phase 3 (plans/exit.md) (#2204) 2026-07-15 15:07:09 -04:00
sort.go Remove os.Exit callsites below the entrypoint: phase 3 (plans/exit.md) (#2204) 2026-07-15 15:07:09 -04:00
sort_within_records.go Remove os.Exit callsites below the entrypoint: phase 3 (plans/exit.md) (#2204) 2026-07-15 15:07:09 -04:00
sparkline.go Remove os.Exit callsites below the entrypoint: phase 3 (plans/exit.md) (#2204) 2026-07-15 15:07:09 -04:00
sparsify.go Remove os.Exit callsites below the entrypoint: phase 3 (plans/exit.md) (#2204) 2026-07-15 15:07:09 -04:00
split.go Remove os.Exit callsites below the entrypoint: phase 3 (plans/exit.md) (#2204) 2026-07-15 15:07:09 -04:00
stats1.go Remove os.Exit callsites below the entrypoint: phase 3 (plans/exit.md) (#2204) 2026-07-15 15:07:09 -04:00
stats1_test.go Remove os.Exit callsites below the entrypoint: phase 3 (plans/exit.md) (#2204) 2026-07-15 15:07:09 -04:00
stats2.go Remove os.Exit callsites below the entrypoint: phase 3 (plans/exit.md) (#2204) 2026-07-15 15:07:09 -04:00
step.go Remove os.Exit callsites below the entrypoint: phase 3 (plans/exit.md) (#2204) 2026-07-15 15:07:09 -04:00
step_test.go Remove os.Exit callsites below the entrypoint: phase 3 (plans/exit.md) (#2204) 2026-07-15 15:07:09 -04:00
subs.go Remove os.Exit callsites below the entrypoint: phase 3 (plans/exit.md) (#2204) 2026-07-15 15:07:09 -04:00
summary.go Remove os.Exit callsites below the entrypoint: phase 3 (plans/exit.md) (#2204) 2026-07-15 15:07:09 -04:00
surv.go Remove os.Exit callsites below the entrypoint: phase 3 (plans/exit.md) (#2204) 2026-07-15 15:07:09 -04:00
tac.go Remove os.Exit callsites below the entrypoint: phase 3 (plans/exit.md) (#2204) 2026-07-15 15:07:09 -04:00
tail.go Remove os.Exit callsites below the entrypoint: phase 3 (plans/exit.md) (#2204) 2026-07-15 15:07:09 -04:00
tee.go Remove os.Exit callsites below the entrypoint: phase 3 (plans/exit.md) (#2204) 2026-07-15 15:07:09 -04:00
template.go Remove os.Exit callsites below the entrypoint: phase 3 (plans/exit.md) (#2204) 2026-07-15 15:07:09 -04:00
top.go Remove os.Exit callsites below the entrypoint: phase 3 (plans/exit.md) (#2204) 2026-07-15 15:07:09 -04:00
unflatten.go Remove os.Exit callsites below the entrypoint: phase 3 (plans/exit.md) (#2204) 2026-07-15 15:07:09 -04:00
uniq.go Remove os.Exit callsites below the entrypoint: phase 3 (plans/exit.md) (#2204) 2026-07-15 15:07:09 -04:00
unspace.go Remove os.Exit callsites below the entrypoint: phase 3 (plans/exit.md) (#2204) 2026-07-15 15:07:09 -04:00
unsparsify.go Remove os.Exit callsites below the entrypoint: phase 3 (plans/exit.md) (#2204) 2026-07-15 15:07:09 -04:00
utf8_to_latin1.go Remove os.Exit callsites below the entrypoint: phase 3 (plans/exit.md) (#2204) 2026-07-15 15:07:09 -04:00

Logic for transforming input records into output records as requested by the user (sort, filter, etc.).:

  • The IRecordTransformer abstract record-transformer interface datatype, as well as the ChainTransformer Go-channel chaining mechanism for piping one transformer into the next.
  • The transformer lookup table, used for Miller command-line parsing, verb construction, and online help.
  • All the concrete record-transformers such as cat, tac, sort, put, and so on.