Struct Context 

pub struct Context {
    pub module_loader: Rc<RefCell<dyn ModuleLoader>>,
    pub cwd: PathBuf,
}

Struct to interact with the runtime.

Example

let ctx = Context::new();
let src_code = r#"
use { println, eprintln } from "std::io";

fn add(a: float, b: float) -> float {
    return a + b;
}

fn main() -> int {
    let i = 3.14;
    let j = true;

    if j {
        i = add(i, 2.0);
    } else {
        eprintln("Goodbye, world!");
    }

    return 0;
}

main();
"#;

let source = Source::from_string(src_code);
let module = Module::from_source(source, ctx)?;

let result = ctx.eval(module);

assert_eq!(result, Ok(Value::Int(3)));

Fields

module_loader: Rc<RefCell<dyn ModuleLoader>>

cwd: PathBuf

Implementations

impl Context

pub fn builder() -> ContextBuilder

Create a new context.

impl Context

pub fn eval(&mut self, module: &mut Module, vm: &mut VM) -> Result<()>

Evaluate a module by parsing and interpreting it.

Arguments

• module - The module to evaluate.
• vm - The virtual machine instance.

Returns

The result of the evaluation.

pub fn parse(&mut self, module: &mut Module) -> Result<()>

Parse a module to prepare it for interpretation.

Arguments

• module - The module to parse.

Returns

An empty result if successful, otherwise returns an error.

pub fn interpret(&mut self, module: &mut Module, vm: &mut VM) -> Result<()>

Interpret a parsed module in the virtual machine.

Arguments

• module - The module to interpret.
• vm - The virtual machine instance.

Returns

An empty result if successful, otherwise returns an error.

pub fn insert_module(&mut self, name: String, module: Module)

Insert a module into the context.

Arguments

• name - The name of the module.
• module - The module to insert.

pub fn query_module(&self, name: &str) -> Option<Module>

Query a module from the context.

Arguments

• name - The name of the module to query.

pub fn load_module(&mut self, referrer: &Module, spec: &str) -> Result<Module>

Load a module from the context.

This function is different from query_module in that it will attempt to load the module from the cache if it is not found it will try to resolve the path and load the module.

Arguments

• referrer - The module that is requesting the module.
• spec - The name of the module to load.

pub fn module_keys(&self) -> Vec<String>

pub fn upsert_module(&mut self, name: String, module: Module)

Inserts or updates a module in the context.

Trait Implementations

impl Clone for Context

fn clone(&self) -> Context

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for Context

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

Formats the value using the given formatter.