Crate yarpl

yarpl is Yet Another Parsing Library which uses declarative macros.

Each macro uses a modified function declaration syntax and will expand to a function with the type fn (&str, usize) -> Result<yarpl::core::Progress, yarpl::core::Done>.

Usage

yarpl macros will take an identifier, then a block containing that parser's one or more children.

For example to parse a simple terminal symbol you can use the just! macro:

use yarpl::just;

just!(pub fn plus { "+" } ); 

Then just call the function with a &str and an index as arguments.

assert!(plus("+", 0).is_ok());

Calling other parsers within a macro may be done with similarly Rust-like syntax:

use yarpl::and;

and!(pub fn plus_plus_plus {

	plus();
	plus();
	plus();

});

assert!(plus_plus_plus("+++", 0).is_ok());
assert!(plus_plus_plus("asdf", 0).is_err());

Modules

core
parsers

Macros

and	Calls a sequence of parsers, failing completely if one returns Err.
just	Tries to match the provided string to the current place in the input.
maybe	Will return Ok(Progress) whether or not its referenced parsing function is successful.
not	Will return the opposite result of some other parser.
or	Holds the result of the most successful symbol it parses, if there is one.
repeat	Repeatedly calls another parser the number of times specified.
same_as	An anonymous version of or! - renames its function's Result the name of its child parser.