cypress 0.3.0

Build simple yet expressive parsers
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
76
77
78
79
80

use std::marker::PhantomData;

use crate::prelude::{Error, PInput, PSuccess, Parser, ParserCore};

/// A combinator that runs two parsers sequentially,
/// discarding the result of the first (`ignore`) and keeping only the result of the second (`then`).
///
/// This is useful when you want to skip over some syntax (e.g. punctuation, keywords)
/// and keep only the meaningful result.
///
/// # Type Parameters
/// - `P1`: The parser whose result is ignored.
/// - `P2`: The parser whose result is kept.
/// - `OI`: The output type of the ignored parser (not used directly).
#[derive(Clone)]
pub struct PIgnoreThen<P1, P2, OI> {
    /// The parser whose result will be ignored.
    ignore: P1,
    /// The parser whose result will be returned.
    then: P2,
    /// Marker for the unused output type `OI`.
    _marker: PhantomData<OI>,
}

/// Constructs a [`PIgnoreThen`] combinator from two parsers.
///
/// This is a convenience function to create the combinator without needing to specify the generic types.
///
/// # Example
/// ```rust
/// use cypress::prelude::*;
///
/// let parser = just('(').ignore_then(pident("x"));
/// match parser.parse("(x".into_input()) {
///     Ok(PSuccess {val, rest: _ }) => assert_eq!(val, "x"),
///     Err(_) => assert!(false)
/// }
/// ```
///
/// # Parameters
/// - `ignore`: The parser to run first and discard its output.
/// - `then`: The parser to run second and return its output.
///
/// # Returns
/// A new parser that sequences the two parsers but only returns the second's result.
pub fn pignore_then<P1, P2, OI>(ignore: P1, then: P2) -> PIgnoreThen<P1, P2, OI> {
    PIgnoreThen {
        ignore,
        then,
        _marker: PhantomData,
    }
}

impl<'a, K, O, P1, P2, OI> ParserCore<'a, K, O> for PIgnoreThen<P1, P2, OI>
where
    K: PartialEq + Clone + 'a,
    O: Clone + 'a,
    OI: Clone + 'a,
    P1: Parser<'a, K, OI>,
    P2: Parser<'a, K, O>,
{
    fn parse(&self, i: PInput<'a, K>) -> Result<PSuccess<'a, K, O>, Error<'a, K>> {
        // First, parse using the `ignore` parser, but discard its result.
        let PSuccess { val: _, rest } = self.ignore.parse(i)?;
        // Then, parse the remaining input with the `then` parser and return its result.
        self.then.parse(rest)
    }
}

// Blanket implementation of `Parser` trait for `PIgnoreThen`.
// This allows it to be used anywhere a `Parser` is expected.
impl<'a, K, O, P1, P2, OI> Parser<'a, K, O> for PIgnoreThen<P1, P2, OI>
where
    K: PartialEq + Clone + 'a,
    O: Clone + 'a,
    OI: Clone + 'a,
    P1: Parser<'a, K, OI>,
    P2: Parser<'a, K, O>,
{
}