Struct BreakpointStore 

pub struct BreakpointStore { /* private fields */ }

Thread-safe breakpoint storage

Stores breakpoints indexed by source file path. Provides methods for setting, clearing, and retrieving breakpoints with REPLACE semantics.

Implementations

impl BreakpointStore

pub fn new() -> Self

Create a new empty breakpoint store

Examples

use perl_dap::breakpoints::BreakpointStore;

let store = BreakpointStore::new();

pub fn set_breakpoints(&self, args: &SetBreakpointsArguments) -> Vec<Breakpoint>

Set breakpoints for a source file (REPLACE semantics)

This method clears all existing breakpoints for the source file and sets the new breakpoints from the request. Each breakpoint is assigned a unique ID and verified status.

Arguments

• args - SetBreakpoints request arguments containing source and breakpoint list

Returns

Array of verified breakpoints in SAME ORDER as the request.

Examples

use perl_dap::breakpoints::BreakpointStore;
use perl_dap::protocol::{SetBreakpointsArguments, Source, SourceBreakpoint};

let store = BreakpointStore::new();
let args = SetBreakpointsArguments {
    source: Source {
        path: Some("/workspace/script.pl".to_string()),
        name: Some("script.pl".to_string()),
    },
    breakpoints: Some(vec![
        SourceBreakpoint { line: 10, column: None, condition: None, hit_condition: None, log_message: None },
        SourceBreakpoint { line: 25, column: None, condition: None, hit_condition: None, log_message: None },
    ]),
    source_modified: None,
};

let breakpoints = store.set_breakpoints(&args);
assert_eq!(breakpoints.len(), 2);

pub fn get_breakpoints(&self, source_path: &str) -> Vec<BreakpointRecord>

Get all breakpoints for a source file

Arguments

• source_path - Absolute path to source file

Returns

Array of breakpoint records for the source, or empty if none exist.

pub fn clear_breakpoints(&self, source_path: &str)

Clear all breakpoints for a source file

Arguments

• source_path - Absolute path to source file

pub fn clear_all(&self)

Clear all breakpoints in all source files

pub fn is_empty(&self) -> bool

Check if the store is empty

pub fn get_breakpoint_by_id(&self, id: i64) -> Option<BreakpointRecord>

Get breakpoint by ID across all sources

Arguments

• id - Unique breakpoint identifier

Returns

Breakpoint record if found, None otherwise.

pub fn register_breakpoint_hit( &self, source_path: &str, line: i64, ) -> BreakpointHitOutcome

Register a runtime breakpoint hit and return stop/logpoint behavior.

This method updates per-breakpoint hit counters and evaluates DAP hit conditions. For logpoints, execution continues after emitting output.

pub fn register_breakpoint_hit_with_variables( &self, source_path: &str, line: i64, variables: Option<&HashMap<String, String>>, ) -> BreakpointHitOutcome

Register a breakpoint hit with optional variable interpolation.

Similar to register_breakpoint_hit, but accepts optional variable values for logpoint message interpolation. If variables are provided, logpoint messages with {$variable} expressions will be interpolated.

Arguments

• source_path - Path to the source file
• line - Line number where the breakpoint was hit (1-based)
• variables - Optional map of variable names to their string values

Returns

BreakpointHitOutcome with interpolated log messages if variables provided

pub fn adjust_breakpoints_for_edit( &self, source_path: &str, start_line: i64, lines_delta: i64, )

AC7.4: Adjust breakpoints for a file edit

This method shifts breakpoint lines based on content changes. It provides <1ms performance by avoiding full AST re-parsing.

Arguments

• source_path - Path to the modified file
• start_line - Line where the edit started (1-based)
• lines_delta - Number of lines added (positive) or removed (negative)

Trait Implementations

impl Clone for BreakpointStore

fn clone(&self) -> BreakpointStore

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for BreakpointStore

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

Formats the value using the given formatter.

impl Default for BreakpointStore

fn default() -> Self

Returns the “default value” for a type.