Struct DapClient 

pub struct DapClient { /* private fields */ }

High-level DAP client managing a single debug session.

Wraps DapTransport and tracks session state, capabilities, and active breakpoints.

Implementations

impl DapClient

pub fn start( config: &DapAdapterConfig, event_handler: EventHandler, ) -> Result<Self, DapError>

Spawn an adapter process and create a new client.

This only starts the child process. Call initialize afterwards to perform the DAP handshake.

Errors

Returns DapError::BinaryNotFound if the command is not on PATH, or DapError::Io if the process fails to spawn.

pub async fn initialize(&self) -> Result<(), DapError>

Perform the DAP initialize handshake.

Sends initialize, stores the adapter’s capabilities, then sends configurationDone.

Errors

Returns DapError::InitializationFailed if the handshake fails.

pub async fn launch(&self, config: Value) -> Result<(), DapError>

Launch a program under the debugger.

The adapter must have been initialized first. Sends launch followed by configurationDone.

Errors

Returns DapError if the request fails.

pub async fn attach(&self, config: Value) -> Result<(), DapError>

Attach to a running process.

Errors

Returns DapError if the request fails.

pub async fn disconnect(&self) -> Result<(), DapError>

Disconnect from the debug session.

Errors

Returns DapError if the request fails.

pub async fn terminate(&self) -> Result<(), DapError>

Terminate the debuggee.

Errors

Returns DapError if the request fails.

pub async fn set_breakpoints( &self, source_path: &str, lines: &[i64], ) -> Result<Vec<Value>, DapError>

Set breakpoints for a source file.

Returns the list of verified breakpoint objects from the adapter.

Errors

Returns DapError if the request fails.

pub async fn set_function_breakpoints( &self, names: &[String], ) -> Result<Vec<Value>, DapError>

Set function breakpoints by name.

Errors

Returns DapError if the request fails.

pub async fn set_exception_breakpoints( &self, filters: &[String], ) -> Result<(), DapError>

Set exception breakpoints by filter ID.

Errors

Returns DapError if the request fails.

pub async fn continue_execution(&self, thread_id: i64) -> Result<(), DapError>

Continue execution of the specified thread.

Errors

Returns DapError if the request fails.

pub async fn next(&self, thread_id: i64) -> Result<(), DapError>

Step over (next) for the specified thread.

Errors

Returns DapError if the request fails.

pub async fn step_in(&self, thread_id: i64) -> Result<(), DapError>

Step into for the specified thread.

Errors

Returns DapError if the request fails.

pub async fn step_out(&self, thread_id: i64) -> Result<(), DapError>

Step out for the specified thread.

Errors

Returns DapError if the request fails.

pub async fn pause(&self, thread_id: i64) -> Result<(), DapError>

Pause the specified thread.

Errors

Returns DapError if the request fails.

pub async fn threads(&self) -> Result<Vec<Value>, DapError>

List all threads in the debuggee.

Errors

Returns DapError if the request fails.

pub async fn stack_trace(&self, thread_id: i64) -> Result<Vec<Value>, DapError>

Get the stack trace for a thread.

Errors

Returns DapError if the request fails.

pub async fn scopes(&self, frame_id: i64) -> Result<Vec<Value>, DapError>

Get scopes for a stack frame.

Errors

Returns DapError if the request fails.

pub async fn variables( &self, variables_ref: i64, ) -> Result<Vec<Value>, DapError>

Get variables for a variables reference (from a scope or structured variable).

Errors

Returns DapError if the request fails.

pub async fn evaluate( &self, expression: &str, frame_id: Option<i64>, ) -> Result<Value, DapError>

Evaluate an expression in the debuggee context.

Errors

Returns DapError if the request fails.

pub async fn status(&self) -> DapSessionState

Return the current session state.

pub async fn capabilities(&self) -> Option<Value>

Return the adapter capabilities received during initialization.

pub const fn transport(&self) -> &Arc<DapTransport>

Return a reference to the underlying transport.

pub async fn active_breakpoints(&self) -> HashMap<String, Vec<Value>>

Return active breakpoints keyed by source path.