diff options
| author | Onur Gündüz <ogunduz@gmail.com> | 2026-09-29 14:34:42 +0200 |
|---|---|---|
| committer | Onur Gündüz <ogunduz@gmail.com> | 2026-09-29 14:34:42 +0200 |
| commit | 0ebdd46766744d649c93f4023d7f20cbfde51c1e (patch) | |
| tree | c1ce87732fa766b591e380e1fb0b0a3f86d77807 /README.md | |
| parent | 66e86c9693a7184944cdd2a0dbf1514e9d0125dc (diff) | |
| download | ele-0ebdd46766744d649c93f4023d7f20cbfde51c1e.tar.gz ele-0ebdd46766744d649c93f4023d7f20cbfde51c1e.zip | |
Implement map-key presence and repeated has traversal
Diffstat (limited to 'README.md')
| -rw-r--r-- | README.md | 4 |
1 files changed, 3 insertions, 1 deletions
@@ -29,7 +29,9 @@ usage: aip-filter [-p|--print] [--max-record-bytes N] [--] <expr> [file...] * Bare literals search values recursively, including nested objects and arrays, but not object keys. String searches are case-insensitive substrings. * An unquoted boolean field name evaluates that field. A dotted name resolves a field path first and otherwise becomes a global literal. Quote a search term to prevent field lookup, for example `'"active"'` or `'"example.com"'`. * String `=` and `!=` ignore ASCII case and support one leading or trailing `*`. The two operators are opposites. -* String `:` matches words or phrases bounded by whitespace or ASCII punctuation, or a leading/trailing wildcard. Lists match any element; maps match keys. `field:*` tests for a non-default value, including a nonempty list or map. +* String `:` matches words or phrases bounded by whitespace or ASCII punctuation, or a leading/trailing wildcard. Lists match any element; maps match keys. +* Top-level `field:*` tests for a non-default value, including a nonempty list or map. For a map entry, `m.foo:*` tests whether the key exists, even when its value is zero, false, empty, or null. JSON objects and `Value::Map` use map semantics; custom message paths use non-default presence. +* The `:` operator can traverse repeated values: `r.foo:42` matches if an element has a matching `foo` value. A grouped right-hand side applies to one resolved element. Ordinary comparisons do not traverse arrays, and numeric path segments are never array indices. * Functions can be parsed and printed, but evaluation rejects the entire filter if any function is present, including inside a negation or unused branch. * The CLI compiles filters before reading records. Regexes, numeric literals, and field paths are reused across records. Filters can contain at most 32 regexes; each regex has a 1 MiB compiled-size limit and a 256 KiB DFA cache limit. * Filters are limited to 64 KiB, 512 non-whitespace tokens, 64 recursive parser calls, and an expression tree of at most 128 levels and 512 nodes. Excessive filters return errors instead of recursing without a bound. |
