All notable changes to this project will be documented in this file.
The format is based on Keep a Changelog, and this project adheres to Semantic Versioning.
then_with
combinator to allow limited support for parsing nested patterns- impl From<&[T; N]> for Stream
SkipUntil/SkipThenRetryUntil::skip_start/consume_end
for more precise control over skip-based recovery
- Allowed
Validate
to map the output type - Switched to zero-size End Of Input spans for default implementations of
Stream
- Made
delimited_by
take combinators instead of specific tokens - Minor optimisations
- Documentation improvements
- Compilation error with
--no-default-features
- Made default behaviour of
skip_until
more sensible
-
A new tutorial to help new users
-
select
macro, a wrapper overfilter_map
that makes extracting data from specific tokens easy -
choice
parser, a better alternative to longor
chains (which sometimes have poor compilation performance) -
todo
parser, that panics when used (but not when created) (akin to Rust'stodo!
macro, but for parsers) -
keyword
parser, that parses exact identifiers -
from_str
combinator to allow converting a pattern to a value inline, usingstd::str::FromStr
-
unwrapped
combinator, to automatically unwrap an output value inline -
rewind
combinator, that allows reverting the input stream on success. It's most useful when requiring that a pattern is followed by some terminating pattern without the first parser greedily consuming it -
map_err_with_span
combinator, to allow fetching the span of the input that was parsed by a parser before an error was encountered -
or_else
combinator, to allow processing and potentially recovering from a parser error -
SeparatedBy::at_most
to require that a separated pattern appear at most a specific number of times -
SeparatedBy::exactly
to require that a separated pattern be repeated exactly a specific number of times -
Repeated::exactly
to require that a pattern be repeated exactly a specific number of times -
More trait implementations for various things, making the crate more useful
- Made
just
,one_of
, andnone_of
significant more useful. They can now accept strings, arrays, slices, vectors, sets, or just single tokens as before - Added the return type of each parser to its documentation
- More explicit documentation of parser behaviour
- More doc examples
- Deprecated
seq
(just
has been generalised and can now be used to parse specific input sequences) - Sealed the
Character
trait so that future changes are not breaking - Sealed the
Chain
trait and made it more powerful - Moved trait constraints on
Parser
to where clauses for improved readability
- Fixed a subtle bug that allowed
separated_by
to parse an extra trailing separator when it shouldn't - Filled a 'hole' in the
Error
trait's API that conflated a lack of expected tokens with expectation of end of input - Made recursive parsers use weak reference-counting to avoid memory leaks
skip_until
error recovery strategySeparatedBy::at_least
andSeparatedBy::at_most
for parsing a specific number of separated itemsParser::validate
for integrated AST validationRecursive::declare
andRecursive::define
for more precise control over recursive declarations
- Improved
separated_by
error messages - Improved documentation
- Hid a new (probably) unused implementation details
take_until
primitive
- Added span to fallback output function in
nested_delimiters
- Support for LL(k) parsing
- Custom error recovery strategies
- Debug mode
- Nested input flattening
- Radically improved error quality