emmylua_parser 0.25.0

A parser for EmmyLua and luals
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
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130

mod tag;
mod test;
mod types;

use tag::{parse_long_tag, parse_tag};

use crate::{
    kind::{LuaSyntaxKind, LuaTokenKind},
    lexer::LuaDocLexerState,
    parser::{LuaDocParser, MarkerEventContainer},
    parser_error::LuaParseError,
};

pub fn parse_comment(p: &mut LuaDocParser) {
    let m = p.mark(LuaSyntaxKind::Comment);

    parse_docs(p);

    m.complete(p);
}

fn parse_docs(p: &mut LuaDocParser) {
    while p.current_token() != LuaTokenKind::TkEof {
        match p.current_token() {
            LuaTokenKind::TkDocStart => {
                p.set_lexer_state(LuaDocLexerState::Tag);
                p.bump();
                parse_tag(p);
            }
            LuaTokenKind::TkDocLongStart => {
                p.set_lexer_state(LuaDocLexerState::Tag);
                p.bump();
                parse_long_tag(p);
            }
            LuaTokenKind::TkNormalStart => {
                p.set_lexer_state(LuaDocLexerState::NormalDescription);
                let mut m = p.mark(LuaSyntaxKind::DocDescription);

                p.bump();

                if_token_bump(p, LuaTokenKind::TkWhitespace);

                if matches!(
                    p.current_token(),
                    LuaTokenKind::TkDocRegion | LuaTokenKind::TkDocEndRegion
                ) {
                    m.undo(p);
                    p.bump();
                    m = p.mark(LuaSyntaxKind::DocDescription);
                }

                while let LuaTokenKind::TkDocDetail
                | LuaTokenKind::TkEndOfLine
                | LuaTokenKind::TkWhitespace
                | LuaTokenKind::TkDocContinue
                | LuaTokenKind::TkNormalStart = p.current_token()
                {
                    p.bump();
                }

                m.complete(p);
            }
            LuaTokenKind::TkLongCommentStart => {
                p.set_lexer_state(LuaDocLexerState::LongDescription);
                p.bump();

                parse_description(p);
            }
            LuaTokenKind::TKDocTriviaStart => {
                p.bump();
            }
            _ => {
                p.bump();
            }
        }

        if let Some(reader) = &p.lexer.reader
            && !reader.is_eof()
            && !matches!(
                p.current_token(),
                LuaTokenKind::TkDocStart | LuaTokenKind::TkDocLongStart
            )
        {
            p.bump_to_end();
            continue;
        }

        p.set_lexer_state(LuaDocLexerState::Init);
    }
}

fn parse_description(p: &mut LuaDocParser) {
    let m = p.mark(LuaSyntaxKind::DocDescription);

    while let LuaTokenKind::TkDocDetail
    | LuaTokenKind::TkEndOfLine
    | LuaTokenKind::TkWhitespace
    | LuaTokenKind::TkDocContinue
    | LuaTokenKind::TkNormalStart = p.current_token()
    {
        p.bump();
    }

    m.complete(p);
}

fn expect_token(p: &mut LuaDocParser, token: LuaTokenKind) -> Result<(), LuaParseError> {
    if p.current_token() == token {
        p.bump();
        Ok(())
    } else {
        Err(LuaParseError::syntax_error_from(
            &t!(
                "expected %{token}, but get %{current}",
                token = token,
                current = p.current_token()
            ),
            p.current_token_range(),
        ))
    }
}

fn if_token_bump(p: &mut LuaDocParser, token: LuaTokenKind) -> bool {
    if p.current_token() == token {
        p.bump();
        true
    } else {
        false
    }
}