language.rs

  1mod buffer;
  2mod diagnostic_set;
  3mod highlight_map;
  4mod outline;
  5pub mod proto;
  6#[cfg(test)]
  7mod tests;
  8
  9use anyhow::{anyhow, Context, Result};
 10use async_trait::async_trait;
 11use client::http::HttpClient;
 12use collections::HashMap;
 13use futures::{
 14    future::{BoxFuture, Shared},
 15    FutureExt, TryFutureExt,
 16};
 17use gpui::{MutableAppContext, Task};
 18use highlight_map::HighlightMap;
 19use lazy_static::lazy_static;
 20use parking_lot::{Mutex, RwLock};
 21use regex::Regex;
 22use serde::{de, Deserialize, Deserializer};
 23use serde_json::Value;
 24use std::{
 25    any::Any,
 26    cell::RefCell,
 27    mem,
 28    ops::Range,
 29    path::{Path, PathBuf},
 30    str,
 31    sync::Arc,
 32};
 33use theme::SyntaxTheme;
 34use tree_sitter::{self, Query};
 35use util::ResultExt;
 36
 37#[cfg(any(test, feature = "test-support"))]
 38use futures::channel::mpsc;
 39
 40pub use buffer::Operation;
 41pub use buffer::*;
 42pub use diagnostic_set::DiagnosticEntry;
 43pub use outline::{Outline, OutlineItem};
 44pub use tree_sitter::{Parser, Tree};
 45
 46thread_local! {
 47    static PARSER: RefCell<Parser> = RefCell::new(Parser::new());
 48}
 49
 50lazy_static! {
 51    pub static ref PLAIN_TEXT: Arc<Language> = Arc::new(Language::new(
 52        LanguageConfig {
 53            name: "Plain Text".into(),
 54            ..Default::default()
 55        },
 56        None,
 57    ));
 58}
 59
 60pub trait ToLspPosition {
 61    fn to_lsp_position(self) -> lsp::Position;
 62}
 63
 64#[derive(Clone, Debug, PartialEq, Eq, Hash)]
 65pub struct LanguageServerName(pub Arc<str>);
 66
 67/// Represents a Language Server, with certain cached sync properties.
 68/// Uses [`LspAdapterTrait`] under the hood, but calls all 'static' methods
 69/// once at startup, and caches the results.
 70pub struct LspAdapter {
 71    pub name: LanguageServerName,
 72    pub server_args: Vec<String>,
 73    pub initialization_options: Option<Value>,
 74    pub disk_based_diagnostic_sources: Vec<String>,
 75    pub disk_based_diagnostics_progress_token: Option<String>,
 76    pub id_for_language: Option<String>,
 77    pub adapter: Box<dyn LspAdapterTrait>,
 78}
 79
 80impl LspAdapter {
 81    pub async fn new<T: LspAdapterTrait>(adapter: T) -> Arc<Self> {
 82        let adapter = Box::new(adapter);
 83        let name = adapter.name().await;
 84        let server_args = adapter.server_args().await;
 85        let initialization_options = adapter.initialization_options().await;
 86        let disk_based_diagnostic_sources = adapter.disk_based_diagnostic_sources().await;
 87        let disk_based_diagnostics_progress_token =
 88            adapter.disk_based_diagnostics_progress_token().await;
 89        let id_for_language = adapter.id_for_language(name.0.as_ref()).await;
 90
 91        Arc::new(LspAdapter {
 92            name,
 93            server_args,
 94            initialization_options,
 95            disk_based_diagnostic_sources,
 96            disk_based_diagnostics_progress_token,
 97            id_for_language,
 98            adapter,
 99        })
100    }
101
102    pub async fn fetch_latest_server_version(
103        &self,
104        http: Arc<dyn HttpClient>,
105    ) -> Result<Box<dyn 'static + Send + Any>> {
106        self.adapter.fetch_latest_server_version(http).await
107    }
108
109    pub async fn fetch_server_binary(
110        &self,
111        version: Box<dyn 'static + Send + Any>,
112        http: Arc<dyn HttpClient>,
113        container_dir: PathBuf,
114    ) -> Result<PathBuf> {
115        self.adapter
116            .fetch_server_binary(version, http, container_dir)
117            .await
118    }
119
120    pub async fn cached_server_binary(&self, container_dir: PathBuf) -> Option<PathBuf> {
121        self.adapter.cached_server_binary(container_dir).await
122    }
123
124    pub async fn process_diagnostics(&self, params: &mut lsp::PublishDiagnosticsParams) {
125        self.adapter.process_diagnostics(params).await
126    }
127
128    pub async fn label_for_completion(
129        &self,
130        completion_item: &lsp::CompletionItem,
131        language: &Language,
132    ) -> Option<CodeLabel> {
133        self.adapter
134            .label_for_completion(completion_item, language)
135            .await
136    }
137
138    pub async fn label_for_symbol(
139        &self,
140        name: &str,
141        kind: lsp::SymbolKind,
142        language: &Language,
143    ) -> Option<CodeLabel> {
144        self.adapter.label_for_symbol(name, kind, language).await
145    }
146}
147
148#[async_trait]
149pub trait LspAdapterTrait: 'static + Send + Sync {
150    async fn name(&self) -> LanguageServerName;
151
152    async fn fetch_latest_server_version(
153        &self,
154        http: Arc<dyn HttpClient>,
155    ) -> Result<Box<dyn 'static + Send + Any>>;
156
157    async fn fetch_server_binary(
158        &self,
159        version: Box<dyn 'static + Send + Any>,
160        http: Arc<dyn HttpClient>,
161        container_dir: PathBuf,
162    ) -> Result<PathBuf>;
163
164    async fn cached_server_binary(&self, container_dir: PathBuf) -> Option<PathBuf>;
165
166    async fn process_diagnostics(&self, _: &mut lsp::PublishDiagnosticsParams) {}
167
168    async fn label_for_completion(
169        &self,
170        _: &lsp::CompletionItem,
171        _: &Language,
172    ) -> Option<CodeLabel> {
173        None
174    }
175
176    async fn label_for_symbol(
177        &self,
178        _: &str,
179        _: lsp::SymbolKind,
180        _: &Language,
181    ) -> Option<CodeLabel> {
182        None
183    }
184
185    async fn server_args(&self) -> Vec<String> {
186        Vec::new()
187    }
188
189    async fn initialization_options(&self) -> Option<Value> {
190        None
191    }
192
193    async fn disk_based_diagnostic_sources(&self) -> Vec<String> {
194        Default::default()
195    }
196
197    async fn disk_based_diagnostics_progress_token(&self) -> Option<String> {
198        None
199    }
200
201    async fn id_for_language(&self, _name: &str) -> Option<String> {
202        None
203    }
204}
205
206#[derive(Clone, Debug, PartialEq, Eq)]
207pub struct CodeLabel {
208    pub text: String,
209    pub runs: Vec<(Range<usize>, HighlightId)>,
210    pub filter_range: Range<usize>,
211}
212
213#[derive(Deserialize)]
214pub struct LanguageConfig {
215    pub name: Arc<str>,
216    pub path_suffixes: Vec<String>,
217    pub brackets: Vec<BracketPair>,
218    #[serde(default = "auto_indent_using_last_non_empty_line_default")]
219    pub auto_indent_using_last_non_empty_line: bool,
220    #[serde(default, deserialize_with = "deserialize_regex")]
221    pub increase_indent_pattern: Option<Regex>,
222    #[serde(default, deserialize_with = "deserialize_regex")]
223    pub decrease_indent_pattern: Option<Regex>,
224    #[serde(default)]
225    pub autoclose_before: String,
226    pub line_comment: Option<String>,
227}
228
229impl Default for LanguageConfig {
230    fn default() -> Self {
231        Self {
232            name: "".into(),
233            path_suffixes: Default::default(),
234            brackets: Default::default(),
235            auto_indent_using_last_non_empty_line: auto_indent_using_last_non_empty_line_default(),
236            increase_indent_pattern: Default::default(),
237            decrease_indent_pattern: Default::default(),
238            autoclose_before: Default::default(),
239            line_comment: Default::default(),
240        }
241    }
242}
243
244fn auto_indent_using_last_non_empty_line_default() -> bool {
245    true
246}
247
248fn deserialize_regex<'de, D: Deserializer<'de>>(d: D) -> Result<Option<Regex>, D::Error> {
249    let source = Option::<String>::deserialize(d)?;
250    if let Some(source) = source {
251        Ok(Some(regex::Regex::new(&source).map_err(de::Error::custom)?))
252    } else {
253        Ok(None)
254    }
255}
256
257// #[cfg(any(test, feature = "test-support"))]
258// pub type FakeLspAdapter = Arc<FakeLspAdapterInner>;
259
260#[cfg(any(test, feature = "test-support"))]
261pub struct FakeLspAdapter {
262    pub name: &'static str,
263    pub capabilities: lsp::ServerCapabilities,
264    pub initializer: Option<Box<dyn 'static + Send + Sync + Fn(&mut lsp::FakeLanguageServer)>>,
265    pub disk_based_diagnostics_progress_token: Option<String>,
266    pub disk_based_diagnostics_sources: Vec<String>,
267}
268
269#[derive(Clone, Debug, Deserialize)]
270pub struct BracketPair {
271    pub start: String,
272    pub end: String,
273    pub close: bool,
274    pub newline: bool,
275}
276
277pub struct Language {
278    pub(crate) config: LanguageConfig,
279    pub(crate) grammar: Option<Arc<Grammar>>,
280    pub(crate) adapter: Option<Arc<LspAdapter>>,
281
282    #[cfg(any(test, feature = "test-support"))]
283    fake_adapter: Option<(
284        mpsc::UnboundedSender<lsp::FakeLanguageServer>,
285        Arc<FakeLspAdapter>,
286    )>,
287}
288
289pub struct Grammar {
290    pub(crate) ts_language: tree_sitter::Language,
291    pub(crate) highlights_query: Option<Query>,
292    pub(crate) brackets_query: Option<Query>,
293    pub(crate) indents_query: Option<Query>,
294    pub(crate) outline_query: Option<Query>,
295    pub(crate) highlight_map: Mutex<HighlightMap>,
296}
297
298#[derive(Clone)]
299pub enum LanguageServerBinaryStatus {
300    CheckingForUpdate,
301    Downloading,
302    Downloaded,
303    Cached,
304    Failed { error: String },
305}
306
307pub struct LanguageRegistry {
308    languages: RwLock<Vec<Arc<Language>>>,
309    language_server_download_dir: Option<Arc<Path>>,
310    lsp_binary_statuses_tx: async_broadcast::Sender<(Arc<Language>, LanguageServerBinaryStatus)>,
311    lsp_binary_statuses_rx: async_broadcast::Receiver<(Arc<Language>, LanguageServerBinaryStatus)>,
312    login_shell_env_loaded: Shared<Task<()>>,
313    lsp_binary_paths: Mutex<
314        HashMap<
315            LanguageServerName,
316            Shared<BoxFuture<'static, Result<PathBuf, Arc<anyhow::Error>>>>,
317        >,
318    >,
319}
320
321impl LanguageRegistry {
322    pub fn new(login_shell_env_loaded: Task<()>) -> Self {
323        let (lsp_binary_statuses_tx, lsp_binary_statuses_rx) = async_broadcast::broadcast(16);
324        Self {
325            language_server_download_dir: None,
326            languages: Default::default(),
327            lsp_binary_statuses_tx,
328            lsp_binary_statuses_rx,
329            login_shell_env_loaded: login_shell_env_loaded.shared(),
330            lsp_binary_paths: Default::default(),
331        }
332    }
333
334    #[cfg(any(test, feature = "test-support"))]
335    pub fn test() -> Self {
336        Self::new(Task::ready(()))
337    }
338
339    pub fn add(&self, language: Arc<Language>) {
340        self.languages.write().push(language.clone());
341    }
342
343    pub fn set_theme(&self, theme: &SyntaxTheme) {
344        for language in self.languages.read().iter() {
345            language.set_theme(theme);
346        }
347    }
348
349    pub fn set_language_server_download_dir(&mut self, path: impl Into<Arc<Path>>) {
350        self.language_server_download_dir = Some(path.into());
351    }
352
353    pub fn get_language(&self, name: &str) -> Option<Arc<Language>> {
354        self.languages
355            .read()
356            .iter()
357            .find(|language| language.name().to_lowercase() == name.to_lowercase())
358            .cloned()
359    }
360
361    pub fn to_vec(&self) -> Vec<Arc<Language>> {
362        self.languages.read().iter().cloned().collect()
363    }
364
365    pub fn language_names(&self) -> Vec<String> {
366        self.languages
367            .read()
368            .iter()
369            .map(|language| language.name().to_string())
370            .collect()
371    }
372
373    pub fn select_language(&self, path: impl AsRef<Path>) -> Option<Arc<Language>> {
374        let path = path.as_ref();
375        let filename = path.file_name().and_then(|name| name.to_str());
376        let extension = path.extension().and_then(|name| name.to_str());
377        let path_suffixes = [extension, filename];
378        self.languages
379            .read()
380            .iter()
381            .find(|language| {
382                language
383                    .config
384                    .path_suffixes
385                    .iter()
386                    .any(|suffix| dbg!(path_suffixes.contains(&Some(dbg!(suffix.as_str())))))
387            })
388            .cloned()
389    }
390
391    pub fn start_language_server(
392        self: &Arc<Self>,
393        server_id: usize,
394        language: Arc<Language>,
395        root_path: Arc<Path>,
396        http_client: Arc<dyn HttpClient>,
397        cx: &mut MutableAppContext,
398    ) -> Option<Task<Result<lsp::LanguageServer>>> {
399        #[cfg(any(test, feature = "test-support"))]
400        if language.fake_adapter.is_some() {
401            let language = language.clone();
402            return Some(cx.spawn(|cx| async move {
403                let (servers_tx, fake_adapter) = language.fake_adapter.as_ref().unwrap();
404                let (server, mut fake_server) = lsp::LanguageServer::fake(
405                    fake_adapter.name.to_string(),
406                    fake_adapter.capabilities.clone(),
407                    cx.clone(),
408                );
409
410                if let Some(initializer) = &fake_adapter.initializer {
411                    initializer(&mut fake_server);
412                }
413
414                let servers_tx = servers_tx.clone();
415                cx.background()
416                    .spawn(async move {
417                        if fake_server
418                            .try_receive_notification::<lsp::notification::Initialized>()
419                            .await
420                            .is_some()
421                        {
422                            servers_tx.unbounded_send(fake_server).ok();
423                        }
424                    })
425                    .detach();
426                Ok(server)
427            }));
428        }
429
430        let download_dir = self
431            .language_server_download_dir
432            .clone()
433            .ok_or_else(|| anyhow!("language server download directory has not been assigned"))
434            .log_err()?;
435
436        let this = self.clone();
437        let adapter = language.adapter.clone()?;
438        let lsp_binary_statuses = self.lsp_binary_statuses_tx.clone();
439        let login_shell_env_loaded = self.login_shell_env_loaded.clone();
440        Some(cx.spawn(|cx| async move {
441            login_shell_env_loaded.await;
442            let server_binary_path = this
443                .lsp_binary_paths
444                .lock()
445                .entry(adapter.name.clone())
446                .or_insert_with(|| {
447                    get_server_binary_path(
448                        adapter.clone(),
449                        language.clone(),
450                        http_client,
451                        download_dir,
452                        lsp_binary_statuses,
453                    )
454                    .map_err(Arc::new)
455                    .boxed()
456                    .shared()
457                })
458                .clone()
459                .map_err(|e| anyhow!(e));
460
461            let server_binary_path = server_binary_path.await?;
462            let server_args = &adapter.server_args;
463            let server = lsp::LanguageServer::new(
464                server_id,
465                &server_binary_path,
466                &server_args,
467                &root_path,
468                cx,
469            )?;
470            Ok(server)
471        }))
472    }
473
474    pub fn language_server_binary_statuses(
475        &self,
476    ) -> async_broadcast::Receiver<(Arc<Language>, LanguageServerBinaryStatus)> {
477        self.lsp_binary_statuses_rx.clone()
478    }
479}
480
481async fn get_server_binary_path(
482    adapter: Arc<LspAdapter>,
483    language: Arc<Language>,
484    http_client: Arc<dyn HttpClient>,
485    download_dir: Arc<Path>,
486    statuses: async_broadcast::Sender<(Arc<Language>, LanguageServerBinaryStatus)>,
487) -> Result<PathBuf> {
488    let container_dir = download_dir.join(adapter.name.0.as_ref());
489    if !container_dir.exists() {
490        smol::fs::create_dir_all(&container_dir)
491            .await
492            .context("failed to create container directory")?;
493    }
494
495    let path = fetch_latest_server_binary_path(
496        adapter.clone(),
497        language.clone(),
498        http_client,
499        &container_dir,
500        statuses.clone(),
501    )
502    .await;
503    if let Err(error) = path.as_ref() {
504        if let Some(cached_path) = adapter.cached_server_binary(container_dir).await {
505            statuses
506                .broadcast((language.clone(), LanguageServerBinaryStatus::Cached))
507                .await?;
508            return Ok(cached_path);
509        } else {
510            statuses
511                .broadcast((
512                    language.clone(),
513                    LanguageServerBinaryStatus::Failed {
514                        error: format!("{:?}", error),
515                    },
516                ))
517                .await?;
518        }
519    }
520    path
521}
522
523async fn fetch_latest_server_binary_path(
524    adapter: Arc<LspAdapter>,
525    language: Arc<Language>,
526    http_client: Arc<dyn HttpClient>,
527    container_dir: &Path,
528    lsp_binary_statuses_tx: async_broadcast::Sender<(Arc<Language>, LanguageServerBinaryStatus)>,
529) -> Result<PathBuf> {
530    let container_dir: Arc<Path> = container_dir.into();
531    lsp_binary_statuses_tx
532        .broadcast((
533            language.clone(),
534            LanguageServerBinaryStatus::CheckingForUpdate,
535        ))
536        .await?;
537    let version_info = adapter
538        .fetch_latest_server_version(http_client.clone())
539        .await?;
540    lsp_binary_statuses_tx
541        .broadcast((language.clone(), LanguageServerBinaryStatus::Downloading))
542        .await?;
543    let path = adapter
544        .fetch_server_binary(version_info, http_client, container_dir.to_path_buf())
545        .await?;
546    lsp_binary_statuses_tx
547        .broadcast((language.clone(), LanguageServerBinaryStatus::Downloaded))
548        .await?;
549    Ok(path)
550}
551
552impl Language {
553    pub fn new(config: LanguageConfig, ts_language: Option<tree_sitter::Language>) -> Self {
554        Self {
555            config,
556            grammar: ts_language.map(|ts_language| {
557                Arc::new(Grammar {
558                    highlights_query: None,
559                    brackets_query: None,
560                    indents_query: None,
561                    outline_query: None,
562                    ts_language,
563                    highlight_map: Default::default(),
564                })
565            }),
566            adapter: None,
567
568            #[cfg(any(test, feature = "test-support"))]
569            fake_adapter: None,
570        }
571    }
572
573    pub fn lsp_adapter(&self) -> Option<Arc<LspAdapter>> {
574        self.adapter.clone()
575    }
576
577    pub fn with_highlights_query(mut self, source: &str) -> Result<Self> {
578        let grammar = self.grammar_mut();
579        grammar.highlights_query = Some(Query::new(grammar.ts_language, source)?);
580        Ok(self)
581    }
582
583    pub fn with_brackets_query(mut self, source: &str) -> Result<Self> {
584        let grammar = self.grammar_mut();
585        grammar.brackets_query = Some(Query::new(grammar.ts_language, source)?);
586        Ok(self)
587    }
588
589    pub fn with_indents_query(mut self, source: &str) -> Result<Self> {
590        let grammar = self.grammar_mut();
591        grammar.indents_query = Some(Query::new(grammar.ts_language, source)?);
592        Ok(self)
593    }
594
595    pub fn with_outline_query(mut self, source: &str) -> Result<Self> {
596        let grammar = self.grammar_mut();
597        grammar.outline_query = Some(Query::new(grammar.ts_language, source)?);
598        Ok(self)
599    }
600
601    fn grammar_mut(&mut self) -> &mut Grammar {
602        Arc::get_mut(self.grammar.as_mut().unwrap()).unwrap()
603    }
604
605    pub fn with_lsp_adapter(mut self, lsp_adapter: Arc<LspAdapter>) -> Self {
606        self.adapter = Some(lsp_adapter);
607        self
608    }
609
610    #[cfg(any(test, feature = "test-support"))]
611    pub fn set_fake_lsp_adapter(
612        &mut self,
613        fake_lsp_adapter: Arc<FakeLspAdapter>,
614    ) -> mpsc::UnboundedReceiver<lsp::FakeLanguageServer> {
615        let (servers_tx, servers_rx) = mpsc::unbounded();
616        self.fake_adapter = Some((servers_tx, fake_lsp_adapter.clone()));
617        let adapter = smol::block_on(LspAdapter::new(fake_lsp_adapter));
618        self.adapter = Some(adapter);
619        servers_rx
620    }
621
622    pub fn name(&self) -> Arc<str> {
623        self.config.name.clone()
624    }
625
626    pub fn line_comment_prefix(&self) -> Option<&str> {
627        self.config.line_comment.as_deref()
628    }
629
630    pub async fn disk_based_diagnostic_sources(&self) -> &[String] {
631        match self.adapter.as_ref() {
632            Some(adapter) => &adapter.disk_based_diagnostic_sources,
633            None => &[],
634        }
635    }
636
637    pub async fn disk_based_diagnostics_progress_token(&self) -> Option<&str> {
638        if let Some(adapter) = self.adapter.as_ref() {
639            adapter.disk_based_diagnostics_progress_token.as_deref()
640        } else {
641            None
642        }
643    }
644
645    pub async fn process_diagnostics(&self, diagnostics: &mut lsp::PublishDiagnosticsParams) {
646        if let Some(processor) = self.adapter.as_ref() {
647            processor.process_diagnostics(diagnostics).await;
648        }
649    }
650
651    pub async fn label_for_completion(
652        &self,
653        completion: &lsp::CompletionItem,
654    ) -> Option<CodeLabel> {
655        self.adapter
656            .as_ref()?
657            .label_for_completion(completion, self)
658            .await
659    }
660
661    pub async fn label_for_symbol(&self, name: &str, kind: lsp::SymbolKind) -> Option<CodeLabel> {
662        self.adapter
663            .as_ref()?
664            .label_for_symbol(name, kind, self)
665            .await
666    }
667
668    pub fn highlight_text<'a>(
669        &'a self,
670        text: &'a Rope,
671        range: Range<usize>,
672    ) -> Vec<(Range<usize>, HighlightId)> {
673        let mut result = Vec::new();
674        if let Some(grammar) = &self.grammar {
675            let tree = grammar.parse_text(text, None);
676            let mut offset = 0;
677            for chunk in BufferChunks::new(text, range, Some(&tree), self.grammar.as_ref(), vec![])
678            {
679                let end_offset = offset + chunk.text.len();
680                if let Some(highlight_id) = chunk.syntax_highlight_id {
681                    if !highlight_id.is_default() {
682                        result.push((offset..end_offset, highlight_id));
683                    }
684                }
685                offset = end_offset;
686            }
687        }
688        result
689    }
690
691    pub fn brackets(&self) -> &[BracketPair] {
692        &self.config.brackets
693    }
694
695    pub fn path_suffixes(&self) -> &[String] {
696        &self.config.path_suffixes
697    }
698
699    pub fn should_autoclose_before(&self, c: char) -> bool {
700        c.is_whitespace() || self.config.autoclose_before.contains(c)
701    }
702
703    pub fn set_theme(&self, theme: &SyntaxTheme) {
704        if let Some(grammar) = self.grammar.as_ref() {
705            if let Some(highlights_query) = &grammar.highlights_query {
706                *grammar.highlight_map.lock() =
707                    HighlightMap::new(highlights_query.capture_names(), theme);
708            }
709        }
710    }
711
712    pub fn grammar(&self) -> Option<&Arc<Grammar>> {
713        self.grammar.as_ref()
714    }
715}
716
717impl Grammar {
718    fn parse_text(&self, text: &Rope, old_tree: Option<Tree>) -> Tree {
719        PARSER.with(|parser| {
720            let mut parser = parser.borrow_mut();
721            parser
722                .set_language(self.ts_language)
723                .expect("incompatible grammar");
724            let mut chunks = text.chunks_in_range(0..text.len());
725            parser
726                .parse_with(
727                    &mut move |offset, _| {
728                        chunks.seek(offset);
729                        chunks.next().unwrap_or("").as_bytes()
730                    },
731                    old_tree.as_ref(),
732                )
733                .unwrap()
734        })
735    }
736
737    pub fn highlight_map(&self) -> HighlightMap {
738        self.highlight_map.lock().clone()
739    }
740
741    pub fn highlight_id_for_name(&self, name: &str) -> Option<HighlightId> {
742        let capture_id = self
743            .highlights_query
744            .as_ref()?
745            .capture_index_for_name(name)?;
746        Some(self.highlight_map.lock().get(capture_id))
747    }
748}
749
750impl CodeLabel {
751    pub fn plain(text: String, filter_text: Option<&str>) -> Self {
752        let mut result = Self {
753            runs: Vec::new(),
754            filter_range: 0..text.len(),
755            text,
756        };
757        if let Some(filter_text) = filter_text {
758            if let Some(ix) = result.text.find(filter_text) {
759                result.filter_range = ix..ix + filter_text.len();
760            }
761        }
762        result
763    }
764}
765
766#[cfg(any(test, feature = "test-support"))]
767impl Default for FakeLspAdapter {
768    fn default() -> Self {
769        Self {
770            name: "the-fake-language-server",
771            capabilities: lsp::LanguageServer::full_capabilities(),
772            initializer: None,
773            disk_based_diagnostics_progress_token: None,
774            disk_based_diagnostics_sources: Vec::new(),
775        }
776    }
777}
778
779#[cfg(any(test, feature = "test-support"))]
780#[async_trait]
781impl LspAdapterTrait for Arc<FakeLspAdapter> {
782    async fn name(&self) -> LanguageServerName {
783        LanguageServerName(self.name.into())
784    }
785
786    async fn fetch_latest_server_version(
787        &self,
788        _: Arc<dyn HttpClient>,
789    ) -> Result<Box<dyn 'static + Send + Any>> {
790        unreachable!();
791    }
792
793    async fn fetch_server_binary(
794        &self,
795        _: Box<dyn 'static + Send + Any>,
796        _: Arc<dyn HttpClient>,
797        _: PathBuf,
798    ) -> Result<PathBuf> {
799        unreachable!();
800    }
801
802    async fn cached_server_binary(&self, _: PathBuf) -> Option<PathBuf> {
803        unreachable!();
804    }
805
806    async fn process_diagnostics(&self, _: &mut lsp::PublishDiagnosticsParams) {}
807
808    async fn disk_based_diagnostic_sources(&self) -> Vec<String> {
809        self.disk_based_diagnostics_sources.clone()
810    }
811
812    async fn disk_based_diagnostics_progress_token(&self) -> Option<String> {
813        self.disk_based_diagnostics_progress_token.clone()
814    }
815}
816
817pub fn point_to_lsp(point: PointUtf16) -> lsp::Position {
818    lsp::Position::new(point.row, point.column)
819}
820
821pub fn point_from_lsp(point: lsp::Position) -> PointUtf16 {
822    PointUtf16::new(point.line, point.character)
823}
824
825pub fn range_to_lsp(range: Range<PointUtf16>) -> lsp::Range {
826    lsp::Range {
827        start: point_to_lsp(range.start),
828        end: point_to_lsp(range.end),
829    }
830}
831
832pub fn range_from_lsp(range: lsp::Range) -> Range<PointUtf16> {
833    let mut start = point_from_lsp(range.start);
834    let mut end = point_from_lsp(range.end);
835    if start > end {
836        mem::swap(&mut start, &mut end);
837    }
838    start..end
839}