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

use crate::T;
use crate::ast::ast::Namespace;
use crate::ast::ast::NamespaceBody;
use crate::ast::ast::NamespaceImplicitBody;
use crate::ast::sequence::Sequence;
use crate::error::ParseError;
use crate::parser::Parser;

impl<'input, 'arena> Parser<'input, 'arena> {
    pub(crate) fn parse_namespace(&mut self) -> Result<Namespace<'arena>, ParseError> {
        let namespace = self.expect_keyword(T!["namespace"])?;
        let name = match self.stream.peek_kind(0)? {
            Some(T![";" | "?>" | "{"]) => None,
            _ => Some(self.parse_identifier()?),
        };
        let body = self.parse_namespace_body()?;

        Ok(Namespace { namespace, name, body })
    }

    pub(crate) fn parse_namespace_body(&mut self) -> Result<NamespaceBody<'arena>, ParseError> {
        match self.stream.peek_kind(0)? {
            Some(T!["{"]) => Ok(NamespaceBody::BraceDelimited(self.parse_block()?)),
            _ => Ok(NamespaceBody::Implicit(self.parse_namespace_implicit_body()?)),
        }
    }

    pub(crate) fn parse_namespace_implicit_body(&mut self) -> Result<NamespaceImplicitBody<'arena>, ParseError> {
        let terminator = self.parse_terminator()?;
        let mut statements = self.new_vec();
        loop {
            let next = self.stream.peek_kind(0)?;
            if matches!(next, None | Some(T!["namespace"])) {
                break;
            }

            let position_before = self.stream.current_position();
            match self.parse_statement() {
                Ok(statement) => statements.push(statement),
                Err(err) => self.errors.push(err),
            }
            // Safety: prevent infinite loop
            if self.stream.current_position() == position_before {
                if let Ok(Some(token)) = self.stream.lookahead(0) {
                    if token.kind == T!["namespace"] {
                        break;
                    }
                    self.errors.push(self.stream.unexpected(Some(token), &[]));
                    let _ = self.stream.consume();
                } else {
                    break;
                }
            }
        }

        Ok(NamespaceImplicitBody { terminator, statements: Sequence::new(statements) })
    }
}