Parser

Internal documentation for the amalgam.parser module.

amalgam.parser.parse(text: str, source: str = '<unknown>') → amalgam.amalgams.Amalgam

Facilitates regular parsing that can fail.

class amalgam.parser.Expression(visit_tokens=True)

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

atom(colon, identifier)

floating(number)

fraction(number)

integral(number)

quoted(quote, expression)

s_expression(*values)

string(*values)

symbol(identifier)

vector(*values)

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

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

text

the original text being parsed

Type

str

source

the source of the original text

Type

str

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

Raised when multiple expressions are found.

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

Raised when no expressions are found.

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

Raised on missing closing parentheses or brackets.

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

Raised on missing opening parentheses or brackets.