miller/internal/pkg/climain
John Kerl 0493a0debd
Fatal-on-data-error mlr -x option (#1373)
* Fatal-on-data-error `mlr -x` option [WIP]

* arithmetic.go error-reason propagation

* more

* more

* more

* renames

* doc page

* namefix

* fix broken test

* make dev
2023-08-30 19:39:22 -04:00
..
doc.go Standardize Go-package structure (#746) 2021-11-11 14:15:13 -05:00
mlrcli_mlrrc.go More Go-package restructuring (#748) 2021-11-12 12:49:55 -05:00
mlrcli_parse.go Fatal-on-data-error mlr -x option (#1373) 2023-08-30 19:39:22 -04:00
mlrcli_shebang.go Support comments in mlr -s files (#1359) 2023-08-19 13:32:09 -04:00
README.md Standardize Go-package structure (#746) 2021-11-11 14:15:13 -05:00

Logic for parsing the Miller command line.

  • internal/pkg/climain is the flag-parsing logic for supporting Miller's command-line interface. When you type something like mlr --icsv --ojson put '$sum = $a + $b' then filter '$sum > 1000' myfile.csv, it's the CLI parser which makes it possible for Miller to construct a CSV record-reader, a transformer chain of put then filter, and a JSON record-writer.
  • internal/pkg/cli contains datatypes for the CLI-parser, which was split out to avoid a Go package-import cycle.
  • I don't use the Go flag package. The flag package is quite fine; Miller's command-line processing is multi-purpose between serving CLI needs per se as well as for manpage/docfile generation, and I found it simplest to roll my own command-line handling here. More importantly, some Miller verbs such as sort take flags more than once -- mlr sort -f field1 -n field2 -f field3 -- which is not supported by the flag package.