c.rs

  1use anyhow::{Context as _, Result, bail};
  2use async_trait::async_trait;
  3use futures::StreamExt;
  4use gpui::{App, AsyncApp};
  5use http_client::github::{AssetKind, GitHubLspBinaryVersion, latest_github_release};
  6use http_client::github_download::{GithubBinaryMetadata, download_server_binary};
  7pub use language::*;
  8use lsp::{InitializeParams, LanguageServerBinary, LanguageServerName};
  9use project::lsp_store::clangd_ext;
 10use serde_json::json;
 11use smol::fs;
 12use std::{env::consts, path::PathBuf, sync::Arc};
 13use util::{ResultExt, fs::remove_matching, maybe, merge_json_value_into};
 14
 15pub struct CLspAdapter;
 16
 17impl CLspAdapter {
 18    const SERVER_NAME: LanguageServerName = LanguageServerName::new_static("clangd");
 19}
 20
 21impl LspInstaller for CLspAdapter {
 22    type BinaryVersion = GitHubLspBinaryVersion;
 23
 24    async fn fetch_latest_server_version(
 25        &self,
 26        delegate: &dyn LspAdapterDelegate,
 27        pre_release: bool,
 28        _: &mut AsyncApp,
 29    ) -> Result<GitHubLspBinaryVersion> {
 30        let release =
 31            latest_github_release("clangd/clangd", true, pre_release, delegate.http_client())
 32                .await?;
 33        let os_suffix = match consts::OS {
 34            "macos" => "mac",
 35            "linux" => "linux",
 36            "windows" => "windows",
 37            other => bail!("Running on unsupported os: {other}"),
 38        };
 39        let asset_name = format!("clangd-{}-{}.zip", os_suffix, release.tag_name);
 40        let asset = release
 41            .assets
 42            .iter()
 43            .find(|asset| asset.name == asset_name)
 44            .with_context(|| format!("no asset found matching {asset_name:?}"))?;
 45        let version = GitHubLspBinaryVersion {
 46            name: release.tag_name,
 47            url: asset.browser_download_url.clone(),
 48            digest: asset.digest.clone(),
 49        };
 50        Ok(version)
 51    }
 52
 53    async fn check_if_user_installed(
 54        &self,
 55        delegate: &dyn LspAdapterDelegate,
 56        _: Option<Toolchain>,
 57        _: &AsyncApp,
 58    ) -> Option<LanguageServerBinary> {
 59        let path = delegate.which(Self::SERVER_NAME.as_ref()).await?;
 60        Some(LanguageServerBinary {
 61            path,
 62            arguments: Vec::new(),
 63            env: None,
 64        })
 65    }
 66
 67    async fn fetch_server_binary(
 68        &self,
 69        version: GitHubLspBinaryVersion,
 70        container_dir: PathBuf,
 71        delegate: &dyn LspAdapterDelegate,
 72    ) -> Result<LanguageServerBinary> {
 73        let GitHubLspBinaryVersion {
 74            name,
 75            url,
 76            digest: expected_digest,
 77        } = version;
 78        let version_dir = container_dir.join(format!("clangd_{name}"));
 79        let binary_path = version_dir.join("bin/clangd");
 80
 81        let binary = LanguageServerBinary {
 82            path: binary_path.clone(),
 83            env: None,
 84            arguments: Default::default(),
 85        };
 86
 87        let metadata_path = version_dir.join("metadata");
 88        let metadata = GithubBinaryMetadata::read_from_file(&metadata_path)
 89            .await
 90            .ok();
 91        if let Some(metadata) = metadata {
 92            let validity_check = async || {
 93                delegate
 94                    .try_exec(LanguageServerBinary {
 95                        path: binary_path.clone(),
 96                        arguments: vec!["--version".into()],
 97                        env: None,
 98                    })
 99                    .await
100                    .inspect_err(|err| {
101                        log::warn!("Unable to run {binary_path:?} asset, redownloading: {err}",)
102                    })
103            };
104            if let (Some(actual_digest), Some(expected_digest)) =
105                (&metadata.digest, &expected_digest)
106            {
107                if actual_digest == expected_digest {
108                    if validity_check().await.is_ok() {
109                        return Ok(binary);
110                    }
111                } else {
112                    log::info!(
113                        "SHA-256 mismatch for {binary_path:?} asset, downloading new asset. Expected: {expected_digest}, Got: {actual_digest}"
114                    );
115                }
116            } else if validity_check().await.is_ok() {
117                return Ok(binary);
118            }
119        }
120        download_server_binary(
121            &*delegate.http_client(),
122            &url,
123            expected_digest.as_deref(),
124            &container_dir,
125            AssetKind::Zip,
126        )
127        .await?;
128        remove_matching(&container_dir, |entry| entry != version_dir).await;
129        GithubBinaryMetadata::write_to_file(
130            &GithubBinaryMetadata {
131                metadata_version: 1,
132                digest: expected_digest,
133            },
134            &metadata_path,
135        )
136        .await?;
137
138        Ok(binary)
139    }
140
141    async fn cached_server_binary(
142        &self,
143        container_dir: PathBuf,
144        _: &dyn LspAdapterDelegate,
145    ) -> Option<LanguageServerBinary> {
146        get_cached_server_binary(container_dir).await
147    }
148}
149
150#[async_trait(?Send)]
151impl super::LspAdapter for CLspAdapter {
152    fn name(&self) -> LanguageServerName {
153        Self::SERVER_NAME
154    }
155
156    async fn label_for_completion(
157        &self,
158        completion: &lsp::CompletionItem,
159        language: &Arc<Language>,
160    ) -> Option<CodeLabel> {
161        let label_detail = match &completion.label_details {
162            Some(label_detail) => match &label_detail.detail {
163                Some(detail) => detail.trim(),
164                None => "",
165            },
166            None => "",
167        };
168
169        let label = completion
170            .label
171            .strip_prefix('•')
172            .unwrap_or(&completion.label)
173            .trim()
174            .to_owned()
175            + label_detail;
176
177        match completion.kind {
178            Some(lsp::CompletionItemKind::FIELD) if completion.detail.is_some() => {
179                let detail = completion.detail.as_ref().unwrap();
180                let text = format!("{} {}", detail, label);
181                let source = Rope::from(format!("struct S {{ {} }}", text).as_str());
182                let runs = language.highlight_text(&source, 11..11 + text.len());
183                let filter_range = completion
184                    .filter_text
185                    .as_deref()
186                    .and_then(|filter_text| {
187                        text.find(filter_text)
188                            .map(|start| start..start + filter_text.len())
189                    })
190                    .unwrap_or(detail.len() + 1..text.len());
191                return Some(CodeLabel {
192                    filter_range,
193                    text,
194                    runs,
195                });
196            }
197            Some(lsp::CompletionItemKind::CONSTANT | lsp::CompletionItemKind::VARIABLE)
198                if completion.detail.is_some() =>
199            {
200                let detail = completion.detail.as_ref().unwrap();
201                let text = format!("{} {}", detail, label);
202                let runs = language.highlight_text(&Rope::from(text.as_str()), 0..text.len());
203                let filter_range = completion
204                    .filter_text
205                    .as_deref()
206                    .and_then(|filter_text| {
207                        text.find(filter_text)
208                            .map(|start| start..start + filter_text.len())
209                    })
210                    .unwrap_or(detail.len() + 1..text.len());
211                return Some(CodeLabel {
212                    filter_range,
213                    text,
214                    runs,
215                });
216            }
217            Some(lsp::CompletionItemKind::FUNCTION | lsp::CompletionItemKind::METHOD)
218                if completion.detail.is_some() =>
219            {
220                let detail = completion.detail.as_ref().unwrap();
221                let text = format!("{} {}", detail, label);
222                let runs = language.highlight_text(&Rope::from(text.as_str()), 0..text.len());
223                let filter_range = completion
224                    .filter_text
225                    .as_deref()
226                    .and_then(|filter_text| {
227                        text.find(filter_text)
228                            .map(|start| start..start + filter_text.len())
229                    })
230                    .unwrap_or_else(|| {
231                        let filter_start = detail.len() + 1;
232                        let filter_end = text
233                            .rfind('(')
234                            .filter(|end| *end > filter_start)
235                            .unwrap_or(text.len());
236                        filter_start..filter_end
237                    });
238
239                return Some(CodeLabel {
240                    filter_range,
241                    text,
242                    runs,
243                });
244            }
245            Some(kind) => {
246                let highlight_name = match kind {
247                    lsp::CompletionItemKind::STRUCT
248                    | lsp::CompletionItemKind::INTERFACE
249                    | lsp::CompletionItemKind::CLASS
250                    | lsp::CompletionItemKind::ENUM => Some("type"),
251                    lsp::CompletionItemKind::ENUM_MEMBER => Some("variant"),
252                    lsp::CompletionItemKind::KEYWORD => Some("keyword"),
253                    lsp::CompletionItemKind::VALUE | lsp::CompletionItemKind::CONSTANT => {
254                        Some("constant")
255                    }
256                    _ => None,
257                };
258                if let Some(highlight_id) = language
259                    .grammar()
260                    .and_then(|g| g.highlight_id_for_name(highlight_name?))
261                {
262                    let mut label = CodeLabel::plain(label, completion.filter_text.as_deref());
263                    label.runs.push((
264                        0..label.text.rfind('(').unwrap_or(label.text.len()),
265                        highlight_id,
266                    ));
267                    return Some(label);
268                }
269            }
270            _ => {}
271        }
272        Some(CodeLabel::plain(label, completion.filter_text.as_deref()))
273    }
274
275    async fn label_for_symbol(
276        &self,
277        name: &str,
278        kind: lsp::SymbolKind,
279        language: &Arc<Language>,
280    ) -> Option<CodeLabel> {
281        let (text, filter_range, display_range) = match kind {
282            lsp::SymbolKind::METHOD | lsp::SymbolKind::FUNCTION => {
283                let text = format!("void {} () {{}}", name);
284                let filter_range = 0..name.len();
285                let display_range = 5..5 + name.len();
286                (text, filter_range, display_range)
287            }
288            lsp::SymbolKind::STRUCT => {
289                let text = format!("struct {} {{}}", name);
290                let filter_range = 7..7 + name.len();
291                let display_range = 0..filter_range.end;
292                (text, filter_range, display_range)
293            }
294            lsp::SymbolKind::ENUM => {
295                let text = format!("enum {} {{}}", name);
296                let filter_range = 5..5 + name.len();
297                let display_range = 0..filter_range.end;
298                (text, filter_range, display_range)
299            }
300            lsp::SymbolKind::INTERFACE | lsp::SymbolKind::CLASS => {
301                let text = format!("class {} {{}}", name);
302                let filter_range = 6..6 + name.len();
303                let display_range = 0..filter_range.end;
304                (text, filter_range, display_range)
305            }
306            lsp::SymbolKind::CONSTANT => {
307                let text = format!("const int {} = 0;", name);
308                let filter_range = 10..10 + name.len();
309                let display_range = 0..filter_range.end;
310                (text, filter_range, display_range)
311            }
312            lsp::SymbolKind::MODULE => {
313                let text = format!("namespace {} {{}}", name);
314                let filter_range = 10..10 + name.len();
315                let display_range = 0..filter_range.end;
316                (text, filter_range, display_range)
317            }
318            lsp::SymbolKind::TYPE_PARAMETER => {
319                let text = format!("typename {} {{}};", name);
320                let filter_range = 9..9 + name.len();
321                let display_range = 0..filter_range.end;
322                (text, filter_range, display_range)
323            }
324            _ => return None,
325        };
326
327        Some(CodeLabel {
328            runs: language.highlight_text(&text.as_str().into(), display_range.clone()),
329            text: text[display_range].to_string(),
330            filter_range,
331        })
332    }
333
334    fn prepare_initialize_params(
335        &self,
336        mut original: InitializeParams,
337        _: &App,
338    ) -> Result<InitializeParams> {
339        let experimental = json!({
340            "textDocument": {
341                "completion" : {
342                    // enable clangd's dot-to-arrow feature.
343                    "editsNearCursor": true
344                },
345                "inactiveRegionsCapabilities": {
346                    "inactiveRegions": true,
347                }
348            }
349        });
350        if let Some(ref mut original_experimental) = original.capabilities.experimental {
351            merge_json_value_into(experimental, original_experimental);
352        } else {
353            original.capabilities.experimental = Some(experimental);
354        }
355        Ok(original)
356    }
357
358    fn retain_old_diagnostic(&self, previous_diagnostic: &Diagnostic, _: &App) -> bool {
359        clangd_ext::is_inactive_region(previous_diagnostic)
360    }
361
362    fn underline_diagnostic(&self, diagnostic: &lsp::Diagnostic) -> bool {
363        !clangd_ext::is_lsp_inactive_region(diagnostic)
364    }
365}
366
367async fn get_cached_server_binary(container_dir: PathBuf) -> Option<LanguageServerBinary> {
368    maybe!(async {
369        let mut last_clangd_dir = None;
370        let mut entries = fs::read_dir(&container_dir).await?;
371        while let Some(entry) = entries.next().await {
372            let entry = entry?;
373            if entry.file_type().await?.is_dir() {
374                last_clangd_dir = Some(entry.path());
375            }
376        }
377        let clangd_dir = last_clangd_dir.context("no cached binary")?;
378        let clangd_bin = clangd_dir.join("bin/clangd");
379        anyhow::ensure!(
380            clangd_bin.exists(),
381            "missing clangd binary in directory {clangd_dir:?}"
382        );
383        Ok(LanguageServerBinary {
384            path: clangd_bin,
385            env: None,
386            arguments: Vec::new(),
387        })
388    })
389    .await
390    .log_err()
391}
392
393#[cfg(test)]
394mod tests {
395    use gpui::{AppContext as _, BorrowAppContext, TestAppContext};
396    use language::{AutoindentMode, Buffer};
397    use settings::SettingsStore;
398    use std::num::NonZeroU32;
399
400    #[gpui::test]
401    async fn test_c_autoindent(cx: &mut TestAppContext) {
402        // cx.executor().set_block_on_ticks(usize::MAX..=usize::MAX);
403        cx.update(|cx| {
404            let test_settings = SettingsStore::test(cx);
405            cx.set_global(test_settings);
406            language::init(cx);
407            cx.update_global::<SettingsStore, _>(|store, cx| {
408                store.update_user_settings(cx, |s| {
409                    s.project.all_languages.defaults.tab_size = NonZeroU32::new(2);
410                });
411            });
412        });
413        let language = crate::language("c", tree_sitter_c::LANGUAGE.into());
414
415        cx.new(|cx| {
416            let mut buffer = Buffer::local("", cx).with_language(language, cx);
417
418            // empty function
419            buffer.edit([(0..0, "int main() {}")], None, cx);
420
421            // indent inside braces
422            let ix = buffer.len() - 1;
423            buffer.edit([(ix..ix, "\n\n")], Some(AutoindentMode::EachLine), cx);
424            assert_eq!(buffer.text(), "int main() {\n  \n}");
425
426            // indent body of single-statement if statement
427            let ix = buffer.len() - 2;
428            buffer.edit([(ix..ix, "if (a)\nb;")], Some(AutoindentMode::EachLine), cx);
429            assert_eq!(buffer.text(), "int main() {\n  if (a)\n    b;\n}");
430
431            // indent inside field expression
432            let ix = buffer.len() - 3;
433            buffer.edit([(ix..ix, "\n.c")], Some(AutoindentMode::EachLine), cx);
434            assert_eq!(buffer.text(), "int main() {\n  if (a)\n    b\n      .c;\n}");
435
436            buffer
437        });
438    }
439}