Struct Evaluator 

pub struct Evaluator { /* private fields */ }

Evaluator for Aether programs

Implementations

impl Evaluator

pub fn new() -> Self

Create a new evaluator (默认禁用IO)

pub fn with_permissions(permissions: IOPermissions) -> Self

Create a new evaluator with custom IO permissions

pub fn with_env(env: Rc<RefCell<Environment>>) -> Self

Create evaluator with custom environment

pub fn set_module_resolver(&mut self, resolver: Box<dyn ModuleResolver>)

Configure the module resolver used for Import/Export.

pub fn push_import_base(&mut self, module_id: String, base_dir: Option<PathBuf>)

Push a base directory context for resolving relative imports.

This is typically used by CLI eval_file() wrappers.

pub fn pop_import_base(&mut self)

Pop the most recent base directory context.

pub fn trace_push(&mut self, msg: String)

Append a trace entry (host-readable; no IO side effects).

pub fn take_trace(&mut self) -> Vec<String>

Drain the trace buffer.

pub fn clear_trace(&mut self)

Clear the trace buffer.

pub fn reset_env(&mut self)

Reset the environment (clear all variables and re-register built-ins)

This is useful for engine pooling and global singleton patterns where you want to reuse an engine instance but ensure isolation.

pub fn set_global(&mut self, name: impl Into<String>, value: Value)

Set a global variable from the host (without requiring eval).

pub fn enter_child_scope(&mut self) -> Rc<RefCell<Environment>>

Enter a child scope (new environment whose parent is the current env).

Returns the previous environment handle; pass it back to restore_env().

pub fn restore_env(&mut self, prev: Rc<RefCell<Environment>>)

Restore a previously saved environment handle (typically from enter_child_scope()).

pub fn eval_program(&mut self, program: &Program) -> EvalResult

Evaluate a program

pub fn eval_statement(&mut self, stmt: &Stmt) -> EvalResult

Evaluate a statement

pub fn eval_expression(&mut self, expr: &Expr) -> EvalResult

Evaluate an expression

Trait Implementations

impl Default for Evaluator

fn default() -> Self

Returns the “default value” for a type.