Struct Debugger 

pub struct Debugger {
    pub file: String,
    /* private fields */
}

Debugger state, shared between VM and interpreter.

Fields

file: String

Current source file name.

Implementations

impl Debugger

pub fn new() -> Self

pub fn add_breakpoint_line(&mut self, line: usize)

Add a line breakpoint programmatically (used by the DAP server before the VM starts). TTY users add via the b N command.

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

Add a function breakpoint programmatically.

pub fn clear_line_breakpoints(&mut self)

Clear every line breakpoint (the DAP server re-sends the full set on every setBreakpoints request).

pub fn set_line_breakpoints(&mut self, lines: &[usize])

Replace the entire line-breakpoint set in one shot.

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

Toggle step-mode (controls whether should_stop returns true on every new line). The DAP server flips this in response to next / stepIn.

pub fn request_step_over(&mut self)

Request a step-over from the next stop.

pub fn request_step_out(&mut self)

Request a step-out from the next stop.

pub fn set_dap_backend( &mut self, shared: Arc<DapShared>, bp_state: Arc<Mutex<BreakpointState>>, )

Install a DAP backend. After this call, prompt() will route through the DAP server instead of TTY.

pub fn is_dap(&self) -> bool

True when this debugger instance is wired to a DAP front-end.

pub fn breakpoint_lines(&self) -> Vec<usize>

Snapshot helper: current breakpoint lines, sorted.

pub fn load_source(&mut self, source: &str)

Load source for display in debugger.

pub fn set_file(&mut self, file: &str)

Set source file name.

pub fn should_stop(&mut self, line: usize) -> bool

Check if debugger should stop at this line.

pub fn should_stop_at_sub(&self, name: &str) -> bool

Check if we should stop at subroutine entry.

pub fn enter_sub(&mut self, _name: &str)

Notify debugger of subroutine call.

pub fn leave_sub(&mut self)

Notify debugger of subroutine return.

pub fn prompt( &mut self, line: usize, scope: &Scope, call_stack: &[(String, usize)], ) -> DebugAction

Interactive debugger prompt. Returns true to continue, false to quit.

Two paths:

• DAP — emit a stopped event with a snapshot, condvar-wait for the next resume command, apply step-mode flags from the shared breakpoint state, and return.
• TTY — original perl -d-style REPL on stdin/stderr.

Trait Implementations

impl Default for Debugger

fn default() -> Self

Returns the “default value” for a type.