Struct muse_lang::compiler::Compiler

pub struct Compiler { /* private fields */ }

A Muse compiler instance.

Implementations

impl Compiler

pub fn push<'a>(&mut self, source: impl Into<SourceCode<'a>>)

Pushes source into the list of sources to build.

pub fn with<'a>(self, source: impl Into<SourceCode<'a>>) -> Self

Adds source to this compiler, and returns self.

pub fn push_macro<M>(&mut self, name: impl Into<Symbol>, func: M)

where M: MacroFn + 'static,

Adds a macro to this compiler instance.

Macros are functions that accept a VecDeque<Ranged<Token>> and return a VecDeque<Ranged<Token>>.

pub fn with_macro<M>(self, name: impl Into<Symbol>, func: M) -> Self

where M: MacroFn + 'static,

Adds a macro to this compiler instance and returns self.

Macros are functions that accept a VecDeque<Ranged<Token>> and return a VecDeque<Ranged<Token>>.

pub fn push_infix_macro<M>(&mut self, name: impl Into<Symbol>, func: M)

where M: InfixMacroFn + 'static,

Adds an infix macro to this compiler instance.

Infix macros are functions that accept a Ranged<Expression> and a VecDeque<Ranged<Token>> and returns a VecDeque<Ranged<Token>>.

pub fn with_infix_macro<M>(self, name: impl Into<Symbol>, func: M) -> Self

where M: InfixMacroFn + 'static,

Adds an infix macro to this compiler instance, and returns self.

Infix macros are functions that accept a Ranged<Expression> and a VecDeque<Ranged<Token>> and returns a VecDeque<Ranged<Token>>.

pub fn compile<'a>( source: impl Into<SourceCode<'a>>, guard: &CollectionGuard<'_>, ) -> Result<Code, Vec<Ranged<Error>>>

Compile’s source.

pub fn build( &mut self, guard: &CollectionGuard<'_>, ) -> Result<Code, Vec<Ranged<Error>>>

Builds all of the sources added to this compiler into a single code block.

pub fn expand_macros(&mut self, expr: &mut Ranged<Expression>)

Perform macro expansion on expr.

After this function executions expr and all subexpressions will not contain any Expression::Macros.

Trait Implementations

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.