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
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75

use crate::{
    error::{MatcherRunError, error_handler::ErrorHandler},
    input::{Input, InputStream},
    matcher::{Matcher, MatcherCombinator, internal::MatcherImpl, runner::MatchRunner},
    parser::capture::MatchResult,
};

use super::{bound::BoundValue, property::Property};

/// Runs `matcher`, then records the span `(start, end)` byte/char indices via `property`.
#[derive(Clone)]
pub struct SpanBinder<Match, Prop> {
    pub(super) matcher: Match,
    pub(super) property: Prop,
}

impl<Match, Prop> std::fmt::Debug for SpanBinder<Match, Prop>
where
    Match: std::fmt::Debug,
{
    fn fmt(&self, f: &mut std::fmt::Formatter<'_>) -> std::fmt::Result {
        f.debug_struct("SpanBinder")
            .field("matcher", &self.matcher)
            .finish()
    }
}

impl<Match, Prop> SpanBinder<Match, Prop> {
    /// See [`bind_span`].
    pub fn new(matcher: Match, property: Prop) -> Self {
        Self { matcher, property }
    }
}

impl<Match, Prop> MatcherCombinator for SpanBinder<Match, Prop> where Match: MatcherCombinator {}

/// Convenience constructor for [`SpanBinder`].
pub fn bind_span<Match, Prop>(matcher: Match, property: Prop) -> SpanBinder<Match, Prop> {
    SpanBinder::new(matcher, property)
}

impl<'src, Inp: Input<'src>, MRes, Match, Prop> MatcherImpl<'src, Inp, MRes>
    for SpanBinder<Match, Prop>
where
    Match: Matcher<'src, Inp, MRes>,
    Inp: Input<'src>,
    MRes: MatchResult,
    Prop: Property<(Inp::Pos, Inp::Pos), MRes> + Clone + 'src,
{
    const CAN_MATCH_DIRECTLY: bool = Match::CAN_MATCH_DIRECTLY;
    const HAS_PROPERTY: bool = true;
    const CAN_FAIL: bool = Match::CAN_FAIL;

    #[inline]
    fn match_with_runner<'a, Runner>(
        &'a self,
        runner: &mut Runner,
        error_handler: &mut impl ErrorHandler,
        input: &mut InputStream<'src, Inp>,
    ) -> Result<bool, MatcherRunError>
    where
        Runner: MatchRunner<'a, 'src, Inp, MRes = MRes>,
        'src: 'a,
    {
        let start_pos = input.get_pos();
        if !runner.run_match(&self.matcher, error_handler, input)? {
            return Ok(false);
        }
        let end_pos = input.get_pos();
        let bound: BoundValue<(Inp::Pos, Inp::Pos), _> =
            self.property.bind_result((start_pos, end_pos));
        runner.register_result(bound);
        Ok(true)
    }
}