Struct Compiler 

pub struct Compiler<'a> { /* private fields */ }

Compiles Do source to bytecode.

Implementations

impl<'a> Compiler<'a>

pub fn new(path: &'a Path, content: &'a [u8]) -> Self

Create new compiler instance

Arguments

• path: The path of the source file; used in backtraces
• content: The source as a byte slice

pub fn mode(&mut self, mode: Mode<'a>) -> &mut Self

Change compilation mode

Default: Mode::Script

pub fn prelude(&mut self) -> Prelude<'a, '_>

Configure a prelude, a collection of standard imports which are injected into the code.

Note that prelude imports which are not referenced by the code are omitted from compilation, even if importing them would have side effects.

pub fn analyze<D: EmitDiag, T: EmitToken<Break = D::Break>>( self, diags: &mut D, tokens: &mut T, ) -> Result<(), Error<D::Break>>

Analyze source code, generating diagnostics and semantic tokens. Ignores errors to the greatest extent possible, other than a request by either emitter to stop analysis. The two emitters must share a common Break type.

The precise order of emitted tokens is not specified, but will be approximately in textual order. The precise interleaving of diagnostics and tokens is not specified.

Arguments

• diags: Where to send generated diagnostics.
• tokens: Where to send semantic tokens.

Errors

• ErrorKind::Fail: Compilation failed due to at least one fatal error. This should nearly never occur unless the source code is too severely malformed to process.
• ErrorKind::Break: Compilation was stopped by the diagnostic emitter.

pub fn compile<E: EmitDiag>( self, write: &mut impl Write, diags: &mut E, ) -> Result<(), Error<E::Break>>

Compile the source

Arguments

• write: Where to write bytecode.
• diags: Where to send generated diagnostics.

Errors

• ErrorKind::Fail: Compilation failed due to at least one fatal error.
• ErrorKind::Break: Compilation was stopped by the diagnostic emitter.
• ErrorKind::Io: Writing bytecode failed with an io::Error.