Crate transduce

Zero-copy isomorphic parsing: your code should look like what it parses.

Examples

Want to parse something in parentheses? Surround it in parentheses:

use transduce::base::*;
let parser = exact(&b'(') >> anything() << exact(&b')') << end();
let input = b"(*)";
assert_eq!(
    parser.parse(input),
    Ok(&b'*'), // Reference to the region of input inside parentheses
);

Modules

• base
  Common functions to drop in instead of reinventing the wheel.
• print_error
  Trait for pretty-printing parse errors.

Macros

• bail
  Immediately return with an error. The second argument requests the slice of input after this error, so we can deduce where it happened.
• format_if_alloc
  Heap-allocated custom formatting if alloc is enabled; otherwise, use the first, non-heap argument.

Structs

• Both
  Perform two actions in order and return both of their results as a tuple.
• DiscardLeft
  Perform two actions in order and discard the result of the first, returning the result of the second.
• DiscardRight
  Perform two actions in order and discard the result of the second, returning the result of the first.
• Either
  Perform two actions in order and return the first one to succeed, or the second error if neither succeed.
• ParseError
  Parsing error: both a message and where it was, via accepting the length of input after the error.
• Parser
  Wrapper around a parser to work with the orphan rule.
• Pipe
  Perform a parsing action then pipe its output into a non-parsing function.

Traits

• Parse
  Parse a slice of Inputs into an Output.
• Read
  Read a series of items (of generic type Input) into this type.