Parser

Internal documentation for the amalgam.parser module.

class amalgam.parser.Parser

Class that serves as the frontend for parsing text.

parse_buffer

The text buffer used within Parser.repl_parse().

Type

StringIO

parse(text: str) → amalgam.amalgams.Amalgam

Facilitates regular parsing that can fail.

repl_parse(text: str) → Optional[amalgam.amalgams.Amalgam]

Facilitates multi-line parsing for the REPL.

Writes the given text string to the parse_buffer and attempts to parse text.

If MissingClosing is raised, returns None to allow for parsing to continue.

If another subclass of ParsingError is raised, clears the parse_buffer and re-raises the exception.

Otherwise, if parsing succeeds, clears the parse_buffer and returns the parsed expression.

class amalgam.parser.Expression(visit_tokens=True)

Transforms expressions in text into their respective amalgams.Amalgam representations.

atom(identifier: lark.lexer.Token) → amalgam.amalgams.Atom

floating(number: lark.lexer.Token) → amalgam.amalgams.Numeric

fraction(number: lark.lexer.Token) → amalgam.amalgams.Numeric

integral(number: lark.lexer.Token) → amalgam.amalgams.Numeric

quoted(expression: amalgam.amalgams.Amalgam) → amalgam.amalgams.Quoted

s_expression(*expressions: amalgam.amalgams.Amalgam) → amalgam.amalgams.SExpression

string(*values: lark.lexer.Token) → amalgam.amalgams.String

symbol(identifier: lark.lexer.Token) → amalgam.amalgams.Symbol

vector(*expressions: amalgam.amalgams.Amalgam) → amalgam.amalgams.Vector

class amalgam.parser.ParsingError(line: int, column: int)

Base exception for errors during parsing.

line

the line number nearest to the error

Type

int

column

the column number nearest to the error

Type

int

class amalgam.parser.ExpectedEOF(line: int, column: int)

Raised when multiple expressions are found.

class amalgam.parser.ExpectedExpression(line: int, column: int)

Raised when no expressions are found.

class amalgam.parser.MissingClosing(line: int, column: int)

Raised on missing closing parentheses or brackets.

class amalgam.parser.MissingOpening(line: int, column: int)

Raised on missing opening parentheses or brackets.