### DISCLAIMER > As of 6th March 2025, debugger is still in development. We plan to merge it behind a staff-only feature flag for staff use only, followed by non-public release and then finally a public one (akin to how Git panel release was handled). This is done to ensure the best experience when it gets released. ### END OF DISCLAIMER **The current state of the debugger implementation:** https://github.com/user-attachments/assets/c4deff07-80dd-4dc6-ad2e-0c252a478fe9 https://github.com/user-attachments/assets/e1ed2345-b750-4bb6-9c97-50961b76904f ---- All the todo's are in the following channel, so it's easier to work on this together: https://zed.dev/channel/zed-debugger-11370 If you are on Linux, you can use the following command to join the channel: ```cli zed https://zed.dev/channel/zed-debugger-11370 ``` ## Current Features - Collab - Breakpoints - Sync when you (re)join a project - Sync when you add/remove a breakpoint - Sync active debug line - Stack frames - Click on stack frame - View variables that belong to the stack frame - Visit the source file - Restart stack frame (if adapter supports this) - Variables - Loaded sources - Modules - Controls - Continue - Step back - Stepping granularity (configurable) - Step into - Stepping granularity (configurable) - Step over - Stepping granularity (configurable) - Step out - Stepping granularity (configurable) - Debug console - Breakpoints - Log breakpoints - line breakpoints - Persistent between zed sessions (configurable) - Multi buffer support - Toggle disable/enable all breakpoints - Stack frames - Click on stack frame - View variables that belong to the stack frame - Visit the source file - Show collapsed stack frames - Restart stack frame (if adapter supports this) - Loaded sources - View all used loaded sources if supported by adapter. - Modules - View all used modules (if adapter supports this) - Variables - Copy value - Copy name - Copy memory reference - Set value (if adapter supports this) - keyboard navigation - Debug Console - See logs - View output that was sent from debug adapter - Output grouping - Evaluate code - Updates the variable list - Auto completion - If not supported by adapter, we will show auto-completion for existing variables - Debug Terminal - Run custom commands and change env values right inside your Zed terminal - Attach to process (if adapter supports this) - Process picker - Controls - Continue - Step back - Stepping granularity (configurable) - Step into - Stepping granularity (configurable) - Step over - Stepping granularity (configurable) - Step out - Stepping granularity (configurable) - Disconnect - Restart - Stop - Warning when a debug session exited without hitting any breakpoint - Debug view to see Adapter/RPC log messages - Testing - Fake debug adapter - Fake requests & events --- Release Notes: - N/A --------- Co-authored-by: Piotr Osiewicz <24362066+osiewicz@users.noreply.github.com> Co-authored-by: Anthony Eid <hello@anthonyeid.me> Co-authored-by: Anthony <anthony@zed.dev> Co-authored-by: Piotr Osiewicz <peterosiewicz@gmail.com> Co-authored-by: Piotr <piotr@zed.dev>
294 lines
9.2 KiB
Rust
294 lines
9.2 KiB
Rust
use dap::DebugRequestType;
|
|
use fuzzy::{StringMatch, StringMatchCandidate};
|
|
use gpui::Subscription;
|
|
use gpui::{DismissEvent, Entity, EventEmitter, Focusable, Render};
|
|
use picker::{Picker, PickerDelegate};
|
|
use project::debugger::attach_processes;
|
|
|
|
use std::sync::Arc;
|
|
use sysinfo::System;
|
|
use ui::{prelude::*, Context, Tooltip};
|
|
use ui::{ListItem, ListItemSpacing};
|
|
use util::debug_panic;
|
|
use workspace::ModalView;
|
|
|
|
#[derive(Debug, Clone)]
|
|
struct Candidate {
|
|
pid: u32,
|
|
name: String,
|
|
command: Vec<String>,
|
|
}
|
|
|
|
pub(crate) struct AttachModalDelegate {
|
|
selected_index: usize,
|
|
matches: Vec<StringMatch>,
|
|
placeholder_text: Arc<str>,
|
|
project: Entity<project::Project>,
|
|
debug_config: task::DebugAdapterConfig,
|
|
candidates: Option<Vec<Candidate>>,
|
|
}
|
|
|
|
impl AttachModalDelegate {
|
|
pub fn new(project: Entity<project::Project>, debug_config: task::DebugAdapterConfig) -> Self {
|
|
Self {
|
|
project,
|
|
debug_config,
|
|
candidates: None,
|
|
selected_index: 0,
|
|
matches: Vec::default(),
|
|
placeholder_text: Arc::from("Select the process you want to attach the debugger to"),
|
|
}
|
|
}
|
|
}
|
|
|
|
pub struct AttachModal {
|
|
_subscription: Subscription,
|
|
pub(crate) picker: Entity<Picker<AttachModalDelegate>>,
|
|
}
|
|
|
|
impl AttachModal {
|
|
pub fn new(
|
|
project: Entity<project::Project>,
|
|
debug_config: task::DebugAdapterConfig,
|
|
window: &mut Window,
|
|
cx: &mut Context<Self>,
|
|
) -> Self {
|
|
let picker = cx.new(|cx| {
|
|
Picker::uniform_list(AttachModalDelegate::new(project, debug_config), window, cx)
|
|
});
|
|
Self {
|
|
_subscription: cx.subscribe(&picker, |_, _, _, cx| {
|
|
cx.emit(DismissEvent);
|
|
}),
|
|
picker,
|
|
}
|
|
}
|
|
}
|
|
|
|
impl Render for AttachModal {
|
|
fn render(&mut self, _window: &mut Window, _: &mut Context<Self>) -> impl ui::IntoElement {
|
|
v_flex()
|
|
.key_context("AttachModal")
|
|
.w(rems(34.))
|
|
.child(self.picker.clone())
|
|
}
|
|
}
|
|
|
|
impl EventEmitter<DismissEvent> for AttachModal {}
|
|
|
|
impl Focusable for AttachModal {
|
|
fn focus_handle(&self, cx: &App) -> gpui::FocusHandle {
|
|
self.picker.read(cx).focus_handle(cx)
|
|
}
|
|
}
|
|
|
|
impl ModalView for AttachModal {}
|
|
|
|
impl PickerDelegate for AttachModalDelegate {
|
|
type ListItem = ListItem;
|
|
|
|
fn match_count(&self) -> usize {
|
|
self.matches.len()
|
|
}
|
|
|
|
fn selected_index(&self) -> usize {
|
|
self.selected_index
|
|
}
|
|
|
|
fn set_selected_index(
|
|
&mut self,
|
|
ix: usize,
|
|
_window: &mut Window,
|
|
_: &mut Context<Picker<Self>>,
|
|
) {
|
|
self.selected_index = ix;
|
|
}
|
|
|
|
fn placeholder_text(&self, _window: &mut Window, _cx: &mut App) -> std::sync::Arc<str> {
|
|
self.placeholder_text.clone()
|
|
}
|
|
|
|
fn update_matches(
|
|
&mut self,
|
|
query: String,
|
|
_window: &mut Window,
|
|
cx: &mut Context<Picker<Self>>,
|
|
) -> gpui::Task<()> {
|
|
cx.spawn(|this, mut cx| async move {
|
|
let Some(processes) = this
|
|
.update(&mut cx, |this, _| {
|
|
if let Some(processes) = this.delegate.candidates.clone() {
|
|
processes
|
|
} else {
|
|
let system = System::new_all();
|
|
|
|
let processes =
|
|
attach_processes(&this.delegate.debug_config.kind, &system.processes());
|
|
let candidates = processes
|
|
.into_iter()
|
|
.map(|(pid, process)| Candidate {
|
|
pid: pid.as_u32(),
|
|
name: process.name().to_string_lossy().into_owned(),
|
|
command: process
|
|
.cmd()
|
|
.iter()
|
|
.map(|s| s.to_string_lossy().to_string())
|
|
.collect::<Vec<_>>(),
|
|
})
|
|
.collect::<Vec<Candidate>>();
|
|
|
|
let _ = this.delegate.candidates.insert(candidates.clone());
|
|
|
|
candidates
|
|
}
|
|
})
|
|
.ok()
|
|
else {
|
|
return;
|
|
};
|
|
|
|
let matches = fuzzy::match_strings(
|
|
&processes
|
|
.iter()
|
|
.enumerate()
|
|
.map(|(id, candidate)| {
|
|
StringMatchCandidate::new(
|
|
id,
|
|
format!(
|
|
"{} {} {}",
|
|
candidate.command.join(" "),
|
|
candidate.pid,
|
|
candidate.name
|
|
)
|
|
.as_str(),
|
|
)
|
|
})
|
|
.collect::<Vec<_>>(),
|
|
&query,
|
|
true,
|
|
100,
|
|
&Default::default(),
|
|
cx.background_executor().clone(),
|
|
)
|
|
.await;
|
|
|
|
this.update(&mut cx, |this, _| {
|
|
let delegate = &mut this.delegate;
|
|
|
|
delegate.matches = matches;
|
|
delegate.candidates = Some(processes);
|
|
|
|
if delegate.matches.is_empty() {
|
|
delegate.selected_index = 0;
|
|
} else {
|
|
delegate.selected_index =
|
|
delegate.selected_index.min(delegate.matches.len() - 1);
|
|
}
|
|
})
|
|
.ok();
|
|
})
|
|
}
|
|
|
|
fn confirm(&mut self, _: bool, _window: &mut Window, cx: &mut Context<Picker<Self>>) {
|
|
let candidate = self
|
|
.matches
|
|
.get(self.selected_index())
|
|
.and_then(|current_match| {
|
|
let ix = current_match.candidate_id;
|
|
self.candidates.as_ref().map(|candidates| &candidates[ix])
|
|
});
|
|
|
|
let Some(candidate) = candidate else {
|
|
return cx.emit(DismissEvent);
|
|
};
|
|
|
|
match &mut self.debug_config.request {
|
|
DebugRequestType::Attach(config) => {
|
|
config.process_id = Some(candidate.pid);
|
|
}
|
|
DebugRequestType::Launch => {
|
|
debug_panic!("Debugger attach modal used on launch debug config");
|
|
return;
|
|
}
|
|
}
|
|
|
|
let config = self.debug_config.clone();
|
|
self.project
|
|
.update(cx, |project, cx| project.start_debug_session(config, cx))
|
|
.detach_and_log_err(cx);
|
|
|
|
cx.emit(DismissEvent);
|
|
}
|
|
|
|
fn dismissed(&mut self, _window: &mut Window, cx: &mut Context<Picker<Self>>) {
|
|
self.selected_index = 0;
|
|
self.candidates.take();
|
|
|
|
cx.emit(DismissEvent);
|
|
}
|
|
|
|
fn render_match(
|
|
&self,
|
|
ix: usize,
|
|
selected: bool,
|
|
_window: &mut Window,
|
|
_: &mut Context<Picker<Self>>,
|
|
) -> Option<Self::ListItem> {
|
|
let candidates = self.candidates.as_ref()?;
|
|
let hit = &self.matches[ix];
|
|
let candidate = &candidates.get(hit.candidate_id)?;
|
|
|
|
Some(
|
|
ListItem::new(SharedString::from(format!("process-entry-{ix}")))
|
|
.inset(true)
|
|
.spacing(ListItemSpacing::Sparse)
|
|
.toggle_state(selected)
|
|
.child(
|
|
v_flex()
|
|
.items_start()
|
|
.child(Label::new(format!("{} {}", candidate.name, candidate.pid)))
|
|
.child(
|
|
div()
|
|
.id(SharedString::from(format!("process-entry-{ix}-command")))
|
|
.tooltip(Tooltip::text(
|
|
candidate
|
|
.command
|
|
.clone()
|
|
.into_iter()
|
|
.collect::<Vec<_>>()
|
|
.join(" "),
|
|
))
|
|
.child(
|
|
Label::new(format!(
|
|
"{} {}",
|
|
candidate.name,
|
|
candidate
|
|
.command
|
|
.clone()
|
|
.into_iter()
|
|
.skip(1)
|
|
.collect::<Vec<_>>()
|
|
.join(" ")
|
|
))
|
|
.size(LabelSize::Small)
|
|
.color(Color::Muted),
|
|
),
|
|
),
|
|
),
|
|
)
|
|
}
|
|
}
|
|
|
|
#[allow(dead_code)]
|
|
#[cfg(any(test, feature = "test-support"))]
|
|
pub(crate) fn process_names(modal: &AttachModal, cx: &mut Context<AttachModal>) -> Vec<String> {
|
|
modal.picker.update(cx, |picker, _| {
|
|
picker
|
|
.delegate
|
|
.matches
|
|
.iter()
|
|
.map(|hit| hit.string.clone())
|
|
.collect::<Vec<_>>()
|
|
})
|
|
}
|