Struct Compiler 

pub struct Compiler {
    pub program_name: Option<String>,
    pub statements_before_dce: u32,
    pub statements_after_dce: u32,
    /* private fields */
}

The primary entry point of the Leo compiler.

Fields

program_name: Option<String>

The program name,

statements_before_dce: u32

How many statements were in the AST before DCE?

statements_after_dce: u32

How many statements were in the AST after DCE?

Implementations

impl Compiler

pub fn parse( &mut self, source: &str, filename: FileName, modules: &[(&str, FileName)], ) -> Result<()>

pub fn parse_and_return_ast( &mut self, source: &str, filename: FileName, modules: &[(&str, FileName)], ) -> Result<Program>

Simple wrapper around parse that also returns the AST.

pub fn new( expected_program_name: Option<String>, is_test: bool, handler: Handler, node_builder: Rc<NodeBuilder>, output_directory: PathBuf, compiler_options: Option<CompilerOptions>, import_stubs: IndexMap<Symbol, Stub>, network: NetworkName, ) -> Self

Returns a new Leo compiler.

pub fn intermediate_passes( &mut self, ) -> Result<(Program, IndexMap<String, Program>)>

Runs the compiler stages.

Returns the generated ABIs (primary and imports), which are captured immediately after monomorphisation to ensure all types are resolved, but not yet lowered.

pub fn compile( &mut self, source: &str, filename: FileName, modules: &Vec<(&str, FileName)>, ) -> Result<Compiled>

Compiles a program from a given source string and a list of module sources.

Arguments

• source - The main source code as a string slice.
• filename - The name of the main source file.
• modules - A vector of tuples where each tuple contains:
  • A module source as a string slice.
  • Its associated FileName.

Returns

• Ok(CompiledPrograms) containing the generated bytecode and ABI if compilation succeeds.
• Err(CompilerError) if any stage of the pipeline fails.

pub fn compile_from_directory( &mut self, entry_file_path: impl AsRef<Path>, source_directory: impl AsRef<Path>, ) -> Result<Compiled>

Compiles a program from a source file and its associated module files in the same directory tree.

pub fn parse_from_directory( &mut self, entry_file_path: impl AsRef<Path>, source_directory: impl AsRef<Path>, ) -> Result<Program>

Parses a program from a source file and its associated module files in the same directory tree.

pub fn add_import_stubs(&mut self) -> Result<()>

Resolves and registers all import stubs for the current program.

This method performs a graph traversal over the program’s import relationships to:

1. Establish parent–child relationships between stubs based on imports.
2. Collect all reachable stubs in traversal order.
3. Store the explored stubs back into self.state.ast.ast.stubs.

The traversal starts from the imports of the main program and recursively follows their transitive dependencies. Any missing stub during traversal results in an error.

Returns

• Ok(()) if all imports are successfully resolved and stubs are collected.
• Err(CompilerError) if any imported program cannot be found.