diff options
Diffstat (limited to 'README.md')
| -rw-r--r-- | README.md | 4 |
1 files changed, 3 insertions, 1 deletions
@@ -13,7 +13,7 @@ cargo install --path . ## CLI usage ```bash -usage: aip-filter [-p|--print] <expr> [file...] +usage: aip-filter [-p|--print] [--max-record-bytes N] [--] <expr> [file...] ``` * `--print` prints the parsed expression instead of evaluating it. @@ -21,6 +21,8 @@ usage: aip-filter [-p|--print] <expr> [file...] * Input is newline-delimited JSON, with one value per line. Matching lines are preserved. * An empty filter copies the selected input unchanged; `--print` with an empty filter prints nothing. * Invalid JSON lines are reported and skipped. Any invalid JSON or input/output error causes a nonzero exit status. +* Records are limited to 8 MiB by default, including the newline. `--max-record-bytes N` sets a positive byte limit. Oversized records are reported and skipped without buffering the rest of the line; later records are still processed and the exit status indicates failure. The limit does not apply to an empty filter, which copies bytes directly. +* Memory depends on the largest allowed record and its parsed JSON values, not on the total number of records. The record limit is not a process-memory limit. ### Matching rules |
