use std::path::Path; use std::sync::atomic::AtomicBool; use std::sync::Arc; use anyhow::{anyhow, bail, Context, Result}; use assistant_slash_command::{SlashCommand, SlashCommandOutput, SlashCommandOutputSection}; use fs::Fs; use futures::AsyncReadExt; use gpui::{AppContext, Model, Task, WeakView}; use http::{AsyncBody, HttpClient, HttpClientWithUrl}; use language::LspAdapterDelegate; use project::{Project, ProjectPath}; use rustdoc::convert_rustdoc_to_markdown; use ui::{prelude::*, ButtonLike, ElevationIndex}; use workspace::Workspace; #[derive(Debug, Clone, Copy)] enum RustdocSource { /// The docs were sourced from local `cargo doc` output. Local, /// The docs were sourced from `docs.rs`. DocsDotRs, } pub(crate) struct RustdocSlashCommand; impl RustdocSlashCommand { async fn build_message( fs: Arc, http_client: Arc, crate_name: String, module_path: Vec, path_to_cargo_toml: Option<&Path>, ) -> Result<(RustdocSource, String)> { let cargo_workspace_root = path_to_cargo_toml.and_then(|path| path.parent()); if let Some(cargo_workspace_root) = cargo_workspace_root { let mut local_cargo_doc_path = cargo_workspace_root.join("target/doc"); local_cargo_doc_path.push(&crate_name); if !module_path.is_empty() { local_cargo_doc_path.push(module_path.join("/")); } local_cargo_doc_path.push("index.html"); if let Ok(contents) = fs.load(&local_cargo_doc_path).await { let (markdown, _items) = convert_rustdoc_to_markdown(contents.as_bytes())?; return Ok((RustdocSource::Local, markdown)); } } let version = "latest"; let path = format!( "{crate_name}/{version}/{crate_name}/{module_path}", module_path = module_path.join("/") ); let mut response = http_client .get( &format!("https://docs.rs/{path}"), AsyncBody::default(), true, ) .await?; let mut body = Vec::new(); response .body_mut() .read_to_end(&mut body) .await .context("error reading docs.rs response body")?; if response.status().is_client_error() { let text = String::from_utf8_lossy(body.as_slice()); bail!( "status error {}, response: {text:?}", response.status().as_u16() ); } let (markdown, _items) = convert_rustdoc_to_markdown(&body[..])?; Ok((RustdocSource::DocsDotRs, markdown)) } fn path_to_cargo_toml(project: Model, cx: &mut AppContext) -> Option> { let worktree = project.read(cx).worktrees().next()?; let worktree = worktree.read(cx); let entry = worktree.entry_for_path("Cargo.toml")?; let path = ProjectPath { worktree_id: worktree.id(), path: entry.path.clone(), }; Some(Arc::from( project.read(cx).absolute_path(&path, cx)?.as_path(), )) } } impl SlashCommand for RustdocSlashCommand { fn name(&self) -> String { "rustdoc".into() } fn description(&self) -> String { "insert Rust docs".into() } fn menu_text(&self) -> String { "Insert Rust Documentation".into() } fn requires_argument(&self) -> bool { true } fn complete_argument( &self, _query: String, _cancel: Arc, _workspace: Option>, _cx: &mut AppContext, ) -> Task>> { Task::ready(Ok(Vec::new())) } fn run( self: Arc, argument: Option<&str>, workspace: WeakView, _delegate: Arc, cx: &mut WindowContext, ) -> Task> { let Some(argument) = argument else { return Task::ready(Err(anyhow!("missing crate name"))); }; let Some(workspace) = workspace.upgrade() else { return Task::ready(Err(anyhow!("workspace was dropped"))); }; let project = workspace.read(cx).project().clone(); let fs = project.read(cx).fs().clone(); let http_client = workspace.read(cx).client().http_client(); let mut path_components = argument.split("::"); let crate_name = match path_components .next() .ok_or_else(|| anyhow!("missing crate name")) { Ok(crate_name) => crate_name.to_string(), Err(err) => return Task::ready(Err(err)), }; let module_path = path_components.map(ToString::to_string).collect::>(); let path_to_cargo_toml = Self::path_to_cargo_toml(project, cx); let text = cx.background_executor().spawn({ let crate_name = crate_name.clone(); let module_path = module_path.clone(); async move { Self::build_message( fs, http_client, crate_name, module_path, path_to_cargo_toml.as_deref(), ) .await } }); let crate_name = SharedString::from(crate_name); let module_path = if module_path.is_empty() { None } else { Some(SharedString::from(module_path.join("::"))) }; cx.foreground_executor().spawn(async move { let (source, text) = text.await?; let range = 0..text.len(); Ok(SlashCommandOutput { text, sections: vec![SlashCommandOutputSection { range, render_placeholder: Arc::new(move |id, unfold, _cx| { RustdocPlaceholder { id, unfold, source, crate_name: crate_name.clone(), module_path: module_path.clone(), } .into_any_element() }), }], run_commands_in_text: false, }) }) } } #[derive(IntoElement)] struct RustdocPlaceholder { pub id: ElementId, pub unfold: Arc, pub source: RustdocSource, pub crate_name: SharedString, pub module_path: Option, } impl RenderOnce for RustdocPlaceholder { fn render(self, _cx: &mut WindowContext) -> impl IntoElement { let unfold = self.unfold; let crate_path = self .module_path .map(|module_path| format!("{crate_name}::{module_path}", crate_name = self.crate_name)) .unwrap_or(self.crate_name.to_string()); ButtonLike::new(self.id) .style(ButtonStyle::Filled) .layer(ElevationIndex::ElevatedSurface) .child(Icon::new(IconName::FileRust)) .child(Label::new(format!( "rustdoc ({source}): {crate_path}", source = match self.source { RustdocSource::Local => "local", RustdocSource::DocsDotRs => "docs.rs", } ))) .on_click(move |_, cx| unfold(cx)) } }