marser 0.1.1

Parser combinator toolkit with matcher-level backtracking and rich error reporting.
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40

pub mod eval;
pub mod grammar;

use marser::error::{FurthestFailError, ParserError};
use marser::parser::Parser;

use self::eval::{RuntimeError, Value, run_file};
use self::grammar::FunctionDef;
use self::grammar::get_mini_language_grammar;

// `RunError` is only surfaced through `run_source`; the example binary does not call `run_source`.
#[allow(dead_code)]
pub enum RunError {
    Parse(FurthestFailError),
    Runtime(RuntimeError),
}

pub fn parse_source<'src>(
    source: &'src str,
) -> Result<(Vec<FunctionDef<'src>>, Vec<ParserError>), FurthestFailError> {
    let grammar = get_mini_language_grammar();
    grammar.parse_str(source)
}

#[allow(dead_code)] // Example binary uses this; integration tests use `run_source` instead.
pub fn eval_parsed<'src>(functions: &'src [FunctionDef<'src>]) -> Result<Value, RuntimeError> {
    run_file(functions)
}

// Integration tests exercise this; the example binary uses `eval_parsed` only.
#[allow(dead_code)]
pub fn run_source(source: &str) -> Result<(Value, Vec<ParserError>), RunError> {
    let (functions, errors) = parse_source(source).map_err(RunError::Parse)?;
    if errors.is_empty() {
        let value = run_file(&functions).map_err(RunError::Runtime)?;
        Ok((value, errors))
    } else {
        Ok((Value::Unit, errors))
    }
}