crustimoney.combinators.experimental
Experimental combinators. These may get promoted, or changed, or dismissed.
These combinators are not available in the string- or data-driven grammar (yet). To use them with those, combine them in a larger grammar like so:
(require '[crustimoney.combinators.experimental :as e])
(grammar
(create-parser
"root= <- stream
expr= <- '{' [0-9]+ '}'")
{:stream (e/stream handle-expr
(e/recover (ref :expr) (regex ".*?}")))})
Experimental combinators. These may get promoted, or changed,
or dismissed.
These combinators are not available in the string- or data-driven
grammar (yet). To use them with those, combine them in a larger
grammar like so:
(require '[crustimoney.combinators.experimental :as e])
(grammar
(create-parser
"root= <- stream
expr= <- '{' [0-9]+ '}'")
{:stream (e/stream handle-expr
(e/recover (ref :expr) (regex ".*?}")))})rangeclj
(range parser min max)Like a repeat, but the times the wrapped parser is matched must lie
within the given range. It will not try to parse more than max
times.
Like a repeat, but the times the wrapped `parser` is matched must lie within the given range. It will not try to parse more than `max` times.
recoverclj
(recover parser recovery)Like a choice, capturing errors of the first choice, including
soft-cuts in its scope.
If the first parser fails, the recovery parser is tried. If it
succeeds, it results in a success node like this:
[:crusti/recovered {:start .., :end .., :errors #{..}}]
The errors are those of the first parser, and can be extracted using
success->recovered-errors. If recovery parser fails, the result
will also be the errors of first parser.
Example usage:
(repeat* (recover (with-name :content
(chain (literal "{")
(regex #"\d+")
(literal "}")))
(regex ".*?}")))
Parsing something like {42}{nan}{100} would result in:
[nil {:start 0, :end 14}
[:content {:start 0, :end 4}]
[:crusti/recovered {:start 4, :end 9, :errors #{{:key :expected-match, :at 5, ...}}}]
[:content {:start 9, :end 14}]]
Like a `choice`, capturing errors of the first choice, including
soft-cuts in its scope.
If the first `parser` fails, the `recovery` parser is tried. If it
succeeds, it results in a success node like this:
[:crusti/recovered {:start .., :end .., :errors #{..}}]
The errors are those of the first parser, and can be extracted using
`success->recovered-errors`. If recovery parser fails, the result
will also be the errors of first parser.
Example usage:
(repeat* (recover (with-name :content
(chain (literal "{")
(regex #"\d+")
(literal "}")))
(regex ".*?}")))
Parsing something like `{42}{nan}{100}` would result in:
[nil {:start 0, :end 14}
[:content {:start 0, :end 4}]
[:crusti/recovered {:start 4, :end 9, :errors #{{:key :expected-match, :at 5, ...}}}]
[:content {:start 9, :end 14}]]streamclj
(stream callback parser)Like repeat*, but pushes results to the callback function,
instead of returning them as children.
If callback is a symbol, it is resolved using requiring-resolve.
Like `repeat*`, but pushes results to the `callback` function, instead of returning them as children. If `callback` is a symbol, it is resolved using `requiring-resolve`.
success->recovered-errorsclj
(success->recovered-errors success)Returns the recovered errors from a result, as set by the
recover combinator parser.
Returns the recovered errors from a result, as set by the `recover` combinator parser.
cljdoc is a website building & hosting documentation for Clojure/Script libraries
× close