Link Search Menu Expand Document

ast

Provides interface for parsing Blade code into Abstract Syntax Trees

Properties


ast.NEWLINE
newline token
ast.LPAREN
left parenthesis (() token
ast.RPAREN
right parenthesis ()) token
ast.LBRACKET
left bracket ([) token
ast.RBRACKET
right bracket (]) token
ast.LBRACE
left brace ({) token
ast.RBRACE
right brace (}) token
ast.SEMICOLON
semicolon (;) token
ast.COMMA
comma (,) token
ast.BACKSLASH
backslash (\) token
ast.BANG
not (!) token
ast.BANG_EQ
not equal (!=) token
ast.COLON
colon (:) token
ast.AT
at (@) token
ast.DOT
dot (.) token
ast.RANGE
range (..) token
ast.TRI_DOT
tridot (...) token
ast.PLUS
plus (+) token
ast.PLUS_EQ
plus equal (+=) token
ast.INCREMENT
increment (++) token
ast.MINUS
minus (-) token
ast.MINUS_EQ
minus equal (-=) token
ast.DECREMENT
decrement (--) token
ast.MULTIPLY
multiply (*) token
ast.MULTIPLY_EQ
multiply equal (*=) token
ast.POW
pow (**) token
ast.POW_EQ
pow equal (**=) token
ast.DIVIDE
divide (/) token
ast.DIVIDE_EQ
divide equal (/=) token
ast.FLOOR
floor division (//) token
ast.FLOOR_EQ
floor divide equal (//=) token
ast.EQUAL
assignment (=) token
ast.EQUAL_EQ
equality (==) token
ast.LESS
less than (<) token
ast.LESS_EQ
less than or equal (<=) token
ast.LSHIFT
left shift (<<) token
ast.LSHIFT_EQ
left shift equal (<<=) token
ast.GREATER
greater than (>) token
ast.GREATER_EQ
greather than or equal (>=) token
ast.RSHIFT
right shift (>>) token
ast.RSHIFT_EQ
right shift equal (>>=) token
ast.PERCENT
modulous (%) token
ast.PERCENT_EQ
modulous equal (%=) token
ast.AMP
ampersand (&) token
ast.AMP_EQ
and equal (&=) token
ast.BAR
bar (|) token
ast.BAR_EQ
bar equal (|=) token
ast.TILDE
tilde/not (~) token
ast.TILDE_EQ
tilde equal (~=) token
ast.XOR
exclusive or (^) token
ast.XOR_EQ
exclusive or equal (^=) token
ast.QUESTION
question (?) token
ast.AND
and token
ast.AS
as token
ast.ASSERT
assert token
ast.BREAK
break token
ast.CATCH
catch token
ast.CLASS
class token
ast.CONTINUE
continue token
ast.DEF
def token
ast.DEFAULT
default token
ast.DIE
die token
ast.DO
do token
ast.ECHO
echo token
ast.ELSE
else token
ast.FALSE
false token
ast.FINALLY
finally token
ast.FOR
for token
ast.IF
if token
ast.IMPORT
import token
ast.IN
in token
ast.ITER
iter token
ast.NIL
nil token
ast.OR
or token
ast.PARENT
parent token
ast.RETURN
return token
ast.SELF
self token
ast.STATIC
static token
ast.TRUE
true token
ast.TRY
try token
ast.USING
using token
ast.VAR
var token
ast.WHEN
when token
ast.WHILE
while token
ast.LITERAL
string literal token
ast.REG_NUMBER
regular number token
ast.BIN_NUMBER
binary number token
ast.OCT_NUMBER
octal number token
ast.HEX_NUMBER
hexadecimal number token
ast.IDENTIFIER
identifier token
ast.DECORATOR
decorator token
ast.INTERPOLATION
interpolation token
ast.COMMENT
comment token
ast.DOC
doc block token
ast.EOF
eof token
ast.ERROR
error token
ast.EMPTY
empty token

Functions


ast.parse(source: string)
parses a given source code and outputs Blade AST objects.
return ParseResult
ast.json(source: string)
parses the give source code and outputs a JSON representation of it’s AST structure.
return string

Classes


class ParseResult


Represents the result of an ast parse operation @serializable @iterable

class ParseResult methods


append(item: any)
adds a new item to the parse result
length()
Returns the length of items in the parsed result.
returns number
get(index: int)
Returns the item at the given ParseResult index or throws exception if out of range.
returns Ast
to_list()
Returns the items in the ParseResult as a list object.
returns List</span></div>

class Scanner


Blade source code scanner

class Scanner properties


Scanner.has_error
reports if an error was encountered in the scaner

class Scanner methods


Scanner(source: string)
constructor
scan()
scans the source and returns a list of tokens
return list[Token]

class Token


Blade source code token @serializable @printable

class Token methods


Token(type: number, literal: string, line: number)
constructor

class ParseException < Exception


Exception raised for errors during parsing

class ParseException methods


ParseException(token: Token, message: string)
constructor

class Stmt


base Stmt class

class EchoStmt < Stmt


Echo Stmt representation @serializable

class EchoStmt methods


EchoStmt(value)
constructor

class ExprStmt < Stmt


Expr Stmt representation @serializable

class ExprStmt methods


ExprStmt(expr)
constructor

class IfStmt < Stmt


If Stmt representation @serializable

class IfStmt methods


IfStmt(condition, truth, falsy)
constructor

class IterStmt < Stmt


Iter Stmt representation @serializable

class IterStmt methods


IterStmt(declaration, condition, iterator, body)
constructor

class WhileStmt < Stmt


While Stmt representation @serializable

class WhileStmt methods


WhileStmt(condition, body)
constructor

class DoWhileStmt < Stmt


DoWhile Stmt representation @serializable

class DoWhileStmt methods


DoWhileStmt(body, condition)
constructor

class ForStmt < Stmt


For Stmt representation @serializable

class ForStmt methods


ForStmt(vars, iterable, body)
constructor

class ContinueStmt < Stmt


Continue Stmt representation @serializable

class BreakStmt < Stmt


Break Stmt representation @serializable

class DieStmt < Stmt


Die Stmt representation @serializable

class DieStmt methods


DieStmt(exception)
constructor

class ReturnStmt < Stmt


Return Stmt representation @serializable

class ReturnStmt methods


ReturnStmt(value)
constructor

class AssertStmt < Stmt


Assert Stmt representation @serializable

class AssertStmt methods


AssertStmt(expr, message)
constructor

class UsingStmt < Stmt


Using Stmt representation @serializable

class UsingStmt methods


UsingStmt(expr, cases, default_case)
constructor

class ImportStmt < Stmt


Import Stmt representation @serializable

class ImportStmt methods


ImportStmt(path, elements)
constructor

class CatchStmt < Stmt


Catch Stmt representation @serializable

class CatchStmt methods


CatchStmt(type, var_name, body)
constructor

class FinallyStmt < Stmt


Finally Stmt representation @serializable

class FinallyStmt methods


FinallyStmt(body)
constructor

class TryStmt < Stmt


Try Stmt representation @serializable

class TryStmt methods


TryStmt(body, catch_stmt, finally_stmt)
constructor

class CommentStmt < Stmt


Comment Stmt representation @serializable

class CommentStmt methods


CommentStmt(data)
constructor

class BlockStmt < Stmt


Block Stmt representation @serializable

class BlockStmt methods


BlockStmt(body)
constructor

class AssignStmt < Stmt


Assign Stmt representation @serializable

class AssignStmt methods


AssignStmt(expr, type, value)
constructor

class Defn


base Defn class

class DocDefn < Defn


Doc Defn representation @serializable

class DocDefn methods


DocDefn(data)
constructor

class Parser


Parses raw Blade tokens and produces an Abstract Syntax Tree

class Parser methods


Parser(tokens: []Token)
constructor
parse()
parses the raw source tokens passed into relevant class and outputs a stream of AST objects that can be one of Expr (expressions), Stmt (statements) or Decl (declarations)
return ParseResult

class Decl


base Decl class

class VarDecl < Decl


Var Decl representation @serializable

class VarDecl methods


VarDecl(name, value)
constructor

class FunctionDecl < Decl


Function Decl representation @serializable

class FunctionDecl methods


FunctionDecl(name, params, body)
constructor

class MethodDecl < Decl


Method Decl representation @serializable

class MethodDecl methods


MethodDecl(name, params, body, is_static)
constructor

class PropertyDecl < Decl


Property Decl representation @serializable

class PropertyDecl methods


PropertyDecl(name, value, is_static)
constructor

class ClassDecl < Decl


Class Decl representation @serializable

class ClassDecl methods


ClassDecl(name, superclass, properties, methods)
constructor

class Expr


base Expr class

class BinaryExpr < Expr


Binary Expr representation @serializable

class BinaryExpr methods


BinaryExpr(left, op, right)
constructor

class GroupExpr < Expr


Group Expr representation @serializable

class GroupExpr methods


GroupExpr(expression)
constructor

class LiteralExpr < Expr


Literal Expr representation @serializable

class LiteralExpr methods


LiteralExpr(value)
constructor

class IdentifierExpr < Expr


Identifier Expr representation @serializable

class IdentifierExpr methods


IdentifierExpr(value)
constructor

class UnaryExpr < Expr


Unary Expr representation @serializable

class UnaryExpr methods


UnaryExpr(op, right)
constructor

class ConditionExpr < Expr


Condition Expr representation @serializable

class ConditionExpr methods


ConditionExpr(expr, truth, falsy)
constructor

class CallExpr < Expr


Call Expr representation @serializable

class CallExpr methods


CallExpr(callee, args)
constructor

class GetExpr < Expr


Get Expr representation @serializable

class GetExpr methods


GetExpr(expr, name)
constructor

class SetExpr < Expr


Set Expr representation @serializable

class SetExpr methods


SetExpr(expr, name, value)
constructor

class IndexExpr < Expr


Index Expr representation @serializable

class IndexExpr methods


IndexExpr(args)
constructor

class ListExpr < Expr


List Expr representation @serializable

class ListExpr methods


ListExpr(items)
constructor

class DictExpr < Expr


Dict Expr representation @serializable

class DictExpr methods


DictExpr(keys, values)
constructor

class InterpolationExpr < Expr


Interpolation Expr representation @serializable

class InterpolationExpr methods


InterpolationExpr(data)
constructor

Back to top

Copyright © 2021 Ore Richard Muyiwa. Distributed under the MIT license.