Struct ScriptDebugger 

pub struct ScriptDebugger { /* private fields */ }

Stable facade used by debugger scripting integrations.

Implementations

impl ScriptDebugger

pub fn new(config: Box<DebuggerConfig>) -> Result<Self, Report>

Create a script debugger from the same configuration used by the REPL.

pub fn from_config(config: Box<DebuggerConfig>) -> Result<Self, Report>

Create a script debugger from a debugger configuration.

pub fn from_masm_source(source: &str, args: Vec<Felt>) -> Result<Self, Report>

Create a script debugger from inline MASM source.

This is useful for tests and small programmatic debugging harnesses.

pub fn handle_command(&self, command: &str) -> Result<String, String>

Execute a debugger command and capture its textual output.

pub fn cycle(&self) -> usize

Current VM cycle.

pub fn stopped(&self) -> bool

Whether execution is currently stopped at a debugger stop point.

pub fn terminated(&self) -> bool

Whether the debuggee has terminated.

pub fn stack(&self) -> Vec<u64>

Current operand stack snapshot, in debugger display order.

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

Source path prefix mappings currently configured for this debugger.

pub fn frame(&self) -> ScriptFrame

Current frame snapshot.

pub fn frame_with_variables(&self, show_all: bool) -> ScriptFrame

Current frame snapshot with either source-visible or all debug variables.

pub fn execution_context(&self) -> ScriptExecutionContext

Current execution context snapshot.

pub fn breakpoints(&self) -> Vec<ScriptBreakpoint>

Current user-visible breakpoints.

pub fn hit_breakpoints(&self) -> Vec<ScriptBreakpoint>

Breakpoints hit at the current stop.

pub fn clear_hit_breakpoints(&self)

Clear the current hit-breakpoint list.

pub fn set_breakpoint(&self, spec: &str) -> Result<ScriptBreakpoint, String>

Set a breakpoint from the normal debugger breakpoint grammar.

pub fn delete_breakpoint(&self, id: Option<u8>) -> Result<(), String>

Delete one breakpoint by id, or all user breakpoints if id is None.

pub fn read_memory(&self, expression: &str) -> Result<String, String>

Read memory using the debugger memory expression grammar.

pub fn step(&self, count: usize) -> Result<String, String>

Step one or more VM cycles.

pub fn next(&self) -> Result<String, String>

Step to the next instruction boundary.

pub fn next_line(&self) -> Result<String, String>

Step to the next source line.

pub fn continue_(&self) -> Result<String, String>

Continue execution until the next breakpoint or termination.

pub fn finish(&self) -> Result<String, String>

Continue execution until the current frame returns.

pub fn reload(&self) -> Result<String, String>

Reload the debuggee.

Trait Implementations

impl Clone for ScriptDebugger

fn clone(&self) -> ScriptDebugger

Returns a duplicate of the value.

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

Performs copy-assignment from source.