Crate parser_compose

See the README.md for a crash course in parser combinators.

The crate is logically organized into two parts

Parsers

Any rust items that implement the Parser trait can parse input by calling try_parse()

• &str
• slices
• chars
• u8
• any_char
• any_byte

Additionally, any function with the right signature automatically becomes a parser.

Parser combinators

The associated methods on the Parser trait are used to combine with other parsers.

• or()
• when()
• repeated()
• map()
• map_err()
• peeked()
• and_then()
• optional()

The sequence combinator is so common that it has a special form. Tuples of parsers implement Parser such that the tuple parser succeeds if all its parsers succeed.

Structs

• Map
  A parser that applies a function to the successful result of its inner parser
• Or
  A parser that tries both inner parsers in turn, returning the result of the first one that succeeds
• Predicate
  A parser that succeeds if the result of parsing the inner parser causes the predicate to pass
• Repeat
  A parser that succeeds if inner parser repeatedly matches a specified number of times

Enums

• Error
  The error type for parsers and their combinators

Traits

• Parser
  A trait for parsers
• RepetitionArgument
  Trait used to accept the different argument forms we allow for the repeated combinator

Functions

• any_byte
  A parser that matches the first byte in a byte slice.
• any_char
  A parser that matches the first char at the start of the string slice.

Type Aliases

• Res
  The return value of this crate’s parsers