Struct rune::Runtime

pub struct Runtime { /* fields omitted */ }

A rune runtime, which simplifies embedding and using rune.

Implementations

impl Runtime

pub fn new() -> Result<Self, ContextError>

Construct a new runtime with the default context.

pub fn with_default_context() -> Result<Self, ContextError>

Construct a runtime with a default context.

If built with the modules feature, this includes all available native modules.

pub fn with_context(context: Context) -> Self

Construct a new runtime with a custom context.

pub fn disable_linking(&mut self)

Disable linking, which will otherwise check that all function signatures exist for all function calls at compile time.

pub fn has_issues(&self) -> bool

Indicate that the runtime has issues it can report with emit_diagnostics.

pub fn context(&self) -> &Context

Access the underlying context of the runtime.

pub fn unit_vm(&self, file_id: usize) -> Option<Vm>

Get the unit associated with the given file id.

pub fn register_vm_error(
    &mut self,
    top_ip: usize,
    file_id: usize,
    error: VmError
) -> Result<(), VmError>

Register the runtime error.

If we don't have debuginfo, returns Err with the passed in error.

pub fn parse_optimization<I>(
    &mut self,
    options: I
) -> Result<(), ConfigurationError> where
    I: IntoIterator,
    I::Item: AsRef<str>, 

Prase the given optimization options.

pub fn load(&mut self, path: &Path) -> Result<usize, LoadError>

Load the given path into the runtime.

The name of the loaded source will be the path as a string.

pub fn load_source(
    &mut self,
    name: String,
    source: String
) -> Result<usize, LoadError>

Load the given source and return a number corresponding to its file id.

Use the provided name when generating diagnostics to reference the file.

pub fn emit_diagnostics<O>(
    &mut self,
    out: &mut O
) -> Result<(), DiagnosticsError> where
    O: WriteColor, 

Emit diagnostics about the last error we encountered.