Struct Compiler 

pub struct Compiler { /* private fields */ }

Compiler state for generating bytecode from AST nodes.

Implementations

impl Compiler

pub fn new() -> Self

Creates a new compiler with empty instruction stream and constant pool.

pub fn with_state(symbols_table: SymbolsTable, constants: Vec<Value>) -> Self

Creates a compiler with existing symbols table and constants.

This enables REPL sessions where variable definitions and constants persist across multiple compilation passes.

pub fn symbols_table_mut(&mut self) -> &mut SymbolsTable

Returns a mutable reference to the compiler’s symbols table.

Used by the module pipeline to define imported symbols before compilation, so that cross-module references resolve correctly.

pub fn register_type(&mut self, typedef: TypeDef)

Registers a type definition (struct or enum) in the type registry.

Used by the module pipeline to register imported type definitions so that construction and field access work across module boundaries.

pub fn bytecode(self) -> Result<Bytecode>

Extracts the compiled bytecode and constants.

Errors

Returns CompileError::ScopeUnderflow if the scope stack is empty, which indicates an internal compiler invariant violation.

pub fn symbols_table(&self) -> &SymbolsTable

Returns a reference to the compiler’s symbols table.

Used for state persistence in REPL sessions where symbol definitions must carry over across compilation passes.

pub fn compile(&mut self, node: &Node) -> Result<()>

Compiles an AST node into bytecode.

This recursively traverses the AST, emitting instructions for each node. Returns an error if an unsupported node type or operator is encountered.

pub fn compile_program(&mut self, program: &Program) -> Result<()>

Compiles a program node (list of statements).

Trait Implementations

impl Clone for Compiler

fn clone(&self) -> Compiler

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for Compiler

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl Default for Compiler

fn default() -> Self

Returns the “default value” for a type.