Struct DebugAdapter 

pub struct DebugAdapter { /* private fields */ }

A state-machine-based DAP client that manages a debug adapter process.

Handles spawning the debug adapter, performing the DAP initialize and launch/attach handshakes, sending requests, and processing responses. All state transitions are validated to maintain the lifecycle invariant.

Concurrency

Same as LspClient – state in Arc<Mutex<>>, separate from process/writer. Lock ordering: state -> process -> writer -> pending_responses.

Implementations

impl DebugAdapter

pub fn new( session: DebugSession, adapter_command: String, adapter_args: Vec<String>, ) -> Self

Creates a new debug adapter in the Stopped state.

• session — The debug session this adapter belongs to.
• adapter_command — The command to spawn the debug adapter (e.g., “/usr/bin/gdb”).
• adapter_args — Arguments to pass to the adapter command.

pub async fn get_state(&self) -> DebugAdapterState

Returns the current state of the debug adapter.

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

Spawns the debug adapter process and begins the initialization sequence.

Transitions from Stopped to Starting to Initializing. If spawning fails, transitions to Crashed. A background task is spawned to read responses from the adapter’s stdout.

Returns Ok(()) if the process was spawned successfully, or an error describing the failure.

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

pub async fn is_running(&self) -> bool

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

Examples found in repository

examples/gdb_session.rs (line 28)

async fn main() -> Result<(), Box<dyn std::error::Error>> {
    // Register the debug adapter
    let pool = DebugAdapterPool::new();
    pool
        .register_adapter(
            "cppdbg".to_string(),
            "/usr/bin/gdb".to_string(),
            vec!["--interpreter=dap".to_string()],
        )
        .await;

    // Create a debug session
    let manager = DebugManager::new();
    let session_id = manager.create_session("main".to_string(), "cppdbg".to_string())?;
    let session = manager.get_session(&session_id).unwrap();

    // Start the adapter
    let adapter = pool.create_session(session).await?;

    // Initialize and set breakpoints
    adapter.initialize().await?;
    adapter
        .set_breakpoints(
            serde_json::json!({ "path": "/path/to/source.cpp" }),
            vec![SourceBreakpoint {
                line: 10,
                column: None,
                condition: None,
                hit_condition: None,
                log_message: None,
            }],
        )
        .await?;

    println!("Debug session initialized with breakpoints.");
    Ok(())
}

pub async fn launch(&self, configuration: Value) -> Result<(), String>

pub async fn attach(&self, configuration: Value) -> Result<(), String>

pub async fn set_breakpoints( &self, source: Value, breakpoints: Vec<SourceBreakpoint>, ) -> Result<Vec<Breakpoint>, String>

Examples found in repository

examples/gdb_session.rs (lines 30-39)

async fn main() -> Result<(), Box<dyn std::error::Error>> {
    // Register the debug adapter
    let pool = DebugAdapterPool::new();
    pool
        .register_adapter(
            "cppdbg".to_string(),
            "/usr/bin/gdb".to_string(),
            vec!["--interpreter=dap".to_string()],
        )
        .await;

    // Create a debug session
    let manager = DebugManager::new();
    let session_id = manager.create_session("main".to_string(), "cppdbg".to_string())?;
    let session = manager.get_session(&session_id).unwrap();

    // Start the adapter
    let adapter = pool.create_session(session).await?;

    // Initialize and set breakpoints
    adapter.initialize().await?;
    adapter
        .set_breakpoints(
            serde_json::json!({ "path": "/path/to/source.cpp" }),
            vec![SourceBreakpoint {
                line: 10,
                column: None,
                condition: None,
                hit_condition: None,
                log_message: None,
            }],
        )
        .await?;

    println!("Debug session initialized with breakpoints.");
    Ok(())
}

pub async fn continue_execution(&self, thread_id: i32) -> Result<(), String>

pub async fn pause(&self, thread_id: i32) -> Result<(), String>

pub async fn next(&self, thread_id: i32) -> Result<(), String>

pub async fn step_in(&self, thread_id: i32) -> Result<(), String>

pub async fn step_out(&self, thread_id: i32) -> Result<(), String>

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

Trait Implementations

impl Debug for DebugAdapter

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

Formats the value using the given formatter.

impl Drop for DebugAdapter

fn drop(&mut self)

Executes the destructor for this type.

fn pin_drop(self: Pin<&mut Self>)

🔬This is a nightly-only experimental API. (pin_ergonomics)

Execute the destructor for this type, but different to Drop::drop, it requires self to be pinned.