luau-parser 0.2.68

A blazingly fast Luau parser with robust error recovery.
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
81
82
83
84
85
86
87
88

//! Helper parsing macros.

/// Parse a [`Bracketed`](crate::types::Bracketed).
///
/// # Usage
///
/// ```ignore
///  parse_bracketed!(
///     lexer,
///     errors,
///     "<error message>",
///     TokenType::Symbol(Symbol::OpeningParenthesis), // opening token
///     Symbol::ClosingParenthesis, // closing token
/// )
/// ```
#[macro_export]
#[doc(hidden)]
macro_rules! parse_bracketed {
    (
        $lexer: ident,
        $errors: ident,
        $error_message: literal,
        $opening: pat,
        $closing: expr,
    ) => {{
        maybe_next_token!($lexer, __opening_bracket, $opening);

        if let Some(__opening_bracket) = __opening_bracket {
            $crate::types::Bracketed::<_>::parse_with(
                __opening_bracket,
                $lexer,
                $errors,
                ($error_message, $closing),
            )
        } else {
            None
        }
    }};
}

/// Force parse a [`Bracketed`](crate::types::Bracketed) by putting fake tokens
/// if it failed to actually parse it.
///
/// # Usage
///
/// ```ignore
///  parse_bracketed!(
///     lexer,
///     errors,
///     "<error message>",
///     (
///         TokenType::Symbol(Symbol::OpeningParenthesis), // opening token
///         TokenType::Symbol(Symbol::OpeningParenthesis), // replacement in case of failure
///     )
///     Symbol::ClosingParenthesis, // closing token
/// )
#[macro_export]
#[doc(hidden)]
macro_rules! force_parse_bracketed {
    (
        $lexer: ident,
        $errors: ident,
        $error_message: literal,
        ($opening: pat, $opening_replacement: expr),
        $closing: expr,
    ) => {{
        next_token_recoverable!(
            $lexer,
            __opening_bracket,
            $opening,
            $opening_replacement,
            $errors,
            $error_message
        );

        $crate::types::Bracketed::<_>::parse_with(
            __opening_bracket,
            $lexer,
            $errors,
            ($error_message, $closing),
        )
        .unwrap_or_else(|| $crate::types::Bracketed {
            opening_bracket: Token::empty($opening_replacement),
            item: Default::default(),
            closing_bracket: Token::empty($closing.into()),
        })
    }};
}