mago-syntax 1.20.1

A correct, fast, and memory-efficient PHP syntax implementation, including Lexer, Parser, AST, and utilities for Mago.
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

use crate::T;
use crate::ast::ast::Declare;
use crate::ast::ast::DeclareBody;
use crate::ast::ast::DeclareColonDelimitedBody;
use crate::ast::ast::DeclareItem;
use crate::ast::sequence::Sequence;
use crate::ast::sequence::TokenSeparatedSequence;
use crate::error::ParseError;
use crate::parser::Parser;

impl<'input, 'arena> Parser<'input, 'arena> {
    pub(crate) fn parse_declare(&mut self) -> Result<Declare<'arena>, ParseError> {
        Ok(Declare {
            declare: self.expect_keyword(T!["declare"])?,
            left_parenthesis: self.stream.eat_span(T!["("])?,
            items: {
                let mut items = self.new_vec();
                let mut commas = self.new_vec();
                loop {
                    if let Some(T![")"]) = self.stream.peek_kind(0)? {
                        break;
                    }

                    items.push(self.parse_declare_item()?);

                    if let Some(T![","]) = self.stream.peek_kind(0)? {
                        commas.push(self.stream.consume()?);
                    } else {
                        break;
                    }
                }

                TokenSeparatedSequence::new(items, commas)
            },
            right_parenthesis: self.stream.eat_span(T![")"])?,
            body: self.parse_declare_body()?,
        })
    }

    pub(crate) fn parse_declare_item(&mut self) -> Result<DeclareItem<'arena>, ParseError> {
        Ok(DeclareItem {
            name: self.parse_local_identifier()?,
            equal: self.stream.eat_span(T!["="])?,
            value: self.parse_expression()?,
        })
    }

    pub(crate) fn parse_declare_body(&mut self) -> Result<DeclareBody<'arena>, ParseError> {
        let next = self.stream.lookahead(0)?;

        Ok(match next.map(|t| t.kind) {
            Some(T![":"]) => DeclareBody::ColonDelimited(self.parse_declare_colon_delimited_body()?),
            _ => DeclareBody::Statement(self.arena.alloc(self.parse_statement()?)),
        })
    }

    pub(crate) fn parse_declare_colon_delimited_body(
        &mut self,
    ) -> Result<DeclareColonDelimitedBody<'arena>, ParseError> {
        Ok(DeclareColonDelimitedBody {
            colon: self.stream.eat_span(T![":"])?,
            statements: {
                let mut statements = self.new_vec();
                loop {
                    if let Some(T!["enddeclare"]) = self.stream.peek_kind(0)? {
                        break;
                    }

                    let position_before = self.stream.current_position();
                    statements.push(self.parse_statement()?);
                    if self.stream.current_position() == position_before {
                        if let Ok(Some(token)) = self.stream.lookahead(0) {
                            self.errors.push(self.stream.unexpected(Some(token), &[]));
                            let _ = self.stream.consume();
                        } else {
                            break;
                        }
                    }
                }
                Sequence::new(statements)
            },
            end_declare: self.expect_keyword(T!["enddeclare"])?,
            terminator: self.parse_terminator()?,
        })
    }
}