Struct Vm 

pub struct Vm { /* private fields */ }

The Harn bytecode virtual machine.

Implementations

impl Vm

pub fn new() -> Self

pub fn set_bridge(&mut self, bridge: Rc<HostBridge>)

Set the bridge for delegating unknown builtins in bridge mode.

pub fn set_source_info(&mut self, file: &str, text: &str)

Set source info for error reporting (file path and source text).

pub fn set_breakpoints(&mut self, lines: Vec<usize>)

Set breakpoints by source line number.

pub fn set_step_mode(&mut self, step: bool)

Enable step mode (stop at next line).

pub fn set_step_over(&mut self)

Enable step-over mode (stop at next line at same or lower frame depth).

pub fn set_step_out(&mut self)

Enable step-out mode (stop when returning from current frame).

pub fn is_stopped(&self) -> bool

Check if the VM is stopped at a debug point.

pub fn debug_state(&self) -> DebugState

Get the current debug state (variables, line, etc.).

pub fn debug_stack_frames(&self) -> Vec<(String, usize)>

Get all stack frames for the debugger.

pub async fn step_execute(&mut self) -> Result<Option<(VmValue, bool)>, VmError>

Execute one instruction, returning whether to stop (breakpoint/step). Returns Ok(None) to continue, Ok(Some(val)) on program end, Err on error.

pub fn start(&mut self, chunk: &Chunk)

Initialize execution (push the initial frame).

pub fn register_builtin<F>(&mut self, name: &str, f: F)

where F: Fn(&[VmValue], &mut String) -> Result<VmValue, VmError> + 'static,

Register a sync builtin function.

pub fn unregister_builtin(&mut self, name: &str)

Remove a sync builtin (so an async version can take precedence).

pub fn register_async_builtin<F, Fut>(&mut self, name: &str, f: F)

where F: Fn(Vec<VmValue>) -> Fut + 'static, Fut: Future<Output = Result<VmValue, VmError>> + 'static,

Register an async builtin function.

pub fn set_source_dir(&mut self, dir: &Path)

Set the source directory for import resolution.

pub fn set_global(&mut self, name: &str, value: VmValue)

Set a global variable in the VM’s environment.

pub fn output(&self) -> &str

Get the captured output.

pub async fn execute(&mut self, chunk: &Chunk) -> Result<VmValue, VmError>

Execute a compiled chunk.

pub fn format_runtime_error(&self, error: &VmError) -> String

Format a runtime error with stack trace and source context.

Produces rustc-style output with source context and caret highlighting:

error: Undefined variable: x
  --> file.harn:5:12
   |
 5 |     let y = x + 1
   |             ^
   = note: called from greet at file.harn:2:1

Trait Implementations

impl Default for Vm

fn default() -> Self

Returns the “default value” for a type.