use hir::PerNs; use crate::completion::CompletionContext; /// `CompletionItem` describes a single completion variant in the editor pop-up. /// It is basically a POD with various properties. To construct a /// `CompletionItem`, use `new` method and the `Builder` struct. #[derive(Debug)] pub struct CompletionItem { /// Used only internally in tests, to check only specific kind of /// completion. completion_kind: CompletionKind, label: String, detail: Option, lookup: Option, snippet: Option, kind: Option, } pub enum InsertText { PlainText { text: String }, Snippet { text: String }, } #[derive(Debug, Clone, Copy, PartialEq, Eq)] pub enum CompletionItemKind { Snippet, Keyword, Module, Function, Struct, Enum, EnumVariant, Binding, Field, Static, Const, Trait, TypeAlias, Method, } #[derive(Debug, PartialEq, Eq)] pub(crate) enum CompletionKind { /// Parser-based keyword completion. Keyword, /// Your usual "complete all valid identifiers". Reference, /// "Secret sauce" completions. Magic, Snippet, } impl CompletionItem { pub(crate) fn new(completion_kind: CompletionKind, label: impl Into) -> Builder { let label = label.into(); Builder { completion_kind, label, detail: None, lookup: None, snippet: None, kind: None, } } /// What user sees in pop-up in the UI. pub fn label(&self) -> &str { &self.label } /// Short one-line additional information, like a type pub fn detail(&self) -> Option<&str> { self.detail.as_ref().map(|it| it.as_str()) } /// What string is used for filtering. pub fn lookup(&self) -> &str { self.lookup .as_ref() .map(|it| it.as_str()) .unwrap_or(self.label()) } /// What is inserted. pub fn insert_text(&self) -> InsertText { match &self.snippet { None => InsertText::PlainText { text: self.label.clone(), }, Some(it) => InsertText::Snippet { text: it.clone() }, } } pub fn kind(&self) -> Option { self.kind } } /// A helper to make `CompletionItem`s. #[must_use] pub(crate) struct Builder { completion_kind: CompletionKind, label: String, detail: Option, lookup: Option, snippet: Option, kind: Option, } impl Builder { pub(crate) fn add_to(self, acc: &mut Completions) { acc.add(self.build()) } pub(crate) fn build(self) -> CompletionItem { CompletionItem { label: self.label, detail: self.detail, lookup: self.lookup, snippet: self.snippet, kind: self.kind, completion_kind: self.completion_kind, } } pub(crate) fn lookup_by(mut self, lookup: impl Into) -> Builder { self.lookup = Some(lookup.into()); self } pub(crate) fn snippet(mut self, snippet: impl Into) -> Builder { self.snippet = Some(snippet.into()); self } pub(crate) fn kind(mut self, kind: CompletionItemKind) -> Builder { self.kind = Some(kind); self } #[allow(unused)] pub(crate) fn detail(self, detail: impl Into) -> Builder { self.set_detail(Some(detail)) } pub(crate) fn set_detail(mut self, detail: Option>) -> Builder { self.detail = detail.map(Into::into); self } pub(super) fn from_resolution( mut self, ctx: &CompletionContext, resolution: &hir::Resolution, ) -> Builder { let resolved = resolution.def_id.and_then(|d| d.resolve(ctx.db).ok()); let kind = match resolved { PerNs { types: Some(hir::Def::Module(..)), .. } => CompletionItemKind::Module, PerNs { types: Some(hir::Def::Struct(..)), .. } => CompletionItemKind::Struct, PerNs { types: Some(hir::Def::Enum(..)), .. } => CompletionItemKind::Enum, PerNs { types: Some(hir::Def::Trait(..)), .. } => CompletionItemKind::Trait, PerNs { types: Some(hir::Def::Type(..)), .. } => CompletionItemKind::TypeAlias, PerNs { values: Some(hir::Def::Const(..)), .. } => CompletionItemKind::Const, PerNs { values: Some(hir::Def::Static(..)), .. } => CompletionItemKind::Static, PerNs { values: Some(hir::Def::Function(function)), .. } => return self.from_function(ctx, function), _ => return self, }; self.kind = Some(kind); self } pub(super) fn from_function( mut self, ctx: &CompletionContext, function: hir::Function, ) -> Builder { // If not an import, add parenthesis automatically. if ctx.use_item_syntax.is_none() && !ctx.is_call { if function.signature(ctx.db).args().is_empty() { self.snippet = Some(format!("{}()$0", self.label)); } else { self.snippet = Some(format!("{}($0)", self.label)); } } self.kind = Some(CompletionItemKind::Function); self } } impl Into for Builder { fn into(self) -> CompletionItem { self.build() } } /// Represents an in-progress set of completions being built. #[derive(Debug, Default)] pub(crate) struct Completions { buf: Vec, } impl Completions { pub(crate) fn add(&mut self, item: impl Into) { self.buf.push(item.into()) } pub(crate) fn add_all(&mut self, items: I) where I: IntoIterator, I::Item: Into, { items.into_iter().for_each(|item| self.add(item.into())) } #[cfg(test)] pub(crate) fn assert_match(&self, expected: &str, kind: CompletionKind) { let expected = normalize(expected); let actual = self.debug_render(kind); test_utils::assert_eq_text!(expected.as_str(), actual.as_str(),); /// Normalize the textual representation of `Completions`: /// replace `;` with newlines, normalize whitespace fn normalize(expected: &str) -> String { use ra_syntax::{tokenize, TextUnit, TextRange, SyntaxKind::SEMI}; let mut res = String::new(); for line in expected.trim().lines() { let line = line.trim(); let mut start_offset: TextUnit = 0.into(); // Yep, we use rust tokenize in completion tests :-) for token in tokenize(line) { let range = TextRange::offset_len(start_offset, token.len); start_offset += token.len; if token.kind == SEMI { res.push('\n'); } else { res.push_str(&line[range]); } } res.push('\n'); } res } } #[cfg(test)] fn debug_render(&self, kind: CompletionKind) -> String { let mut res = String::new(); for c in self.buf.iter() { if c.completion_kind == kind { if let Some(lookup) = &c.lookup { res.push_str(lookup); res.push_str(&format!(" {:?}", c.label)); } else { res.push_str(&c.label); } if let Some(detail) = &c.detail { res.push_str(&format!(" {:?}", detail)); } if let Some(snippet) = &c.snippet { res.push_str(&format!(" {:?}", snippet)); } res.push('\n'); } } res } } impl Into> for Completions { fn into(self) -> Vec { self.buf } }