simvx.ide.debug_session

Debug session — DAP client lifecycle, breakpoint sync, IDE menu actions.

Module Contents

Classes

DebugSession

Owns the active debug session and exposes IDE menu/run actions.

Data

log

API

simvx.ide.debug_session.log

‘getLogger(…)’

class simvx.ide.debug_session.DebugSession(state: simvx.ide.state.State, config: simvx.ide.config.Config, ide: simvx.ide.app.Root | None = None)

Owns the active debug session and exposes IDE menu/run actions.

Creates/destroys DAPClient instances per session, syncs breakpoints from State, caches thread/stack/scope/variable data for the UI, and provides the run/debug action handlers used by menu items and shortcuts.

Initialization

start_debug(path: str)

Start debugging a Python file.

stop_debug()

Stop the current debug session.

continue_execution()

step_over()

step_into()

step_out()

pause()

toggle_breakpoint(path: str, line: int)

evaluate(expr: str, callback=None)

Evaluate expression in the current frame context.

If callback is provided, the parsed result string (or dict on error) is forwarded to it instead of being emitted to debug_output.

set_breakpoint_condition(path: str, line: int, condition: str)

Set or clear a condition on a breakpoint.

get_breakpoint_condition(path: str, line: int) → str

Get the condition for a breakpoint, or empty string.

get_conditions_for_file(path: str) → dict[int, str]

Get all conditions for a file as {line: condition}.

select_frame(frame_index: int)

Select a stack frame by index, refreshing scopes and variables.

fetch_variables(variables_ref: int, callback=None)

Fetch variables for a scope or nested object.

property is_debugging: bool

property debug_state: str

property current_file: str

property current_line: int

property threads: list[dict[str, Any]]

property stack_frames: list[dict[str, Any]]

property scopes: list[dict[str, Any]]

property variables: dict[int, list[dict[str, Any]]]

on_run_file()

on_run_no_debug()

on_run_requested(path: str)

on_toggle_breakpoint()

on_step_over()

on_step_into()

on_step_out()

on_stop_debug()

on_restart_debug()

process(dt: float)

Tick the DAP client to poll subprocess I/O.