3 SyntaxNode, AstNode, SmolStr, TextRange, ast,
4 SyntaxKind::{self, NAME},
6 use hir::{ModuleSource, FieldSource};
8 use crate::{FileSymbol, db::RootDatabase};
10 /// `NavigationTarget` represents and element in the editor's UI which you can
11 /// click on to navigate to a particular piece of code.
13 /// Typically, a `NavigationTarget` corresponds to some element in the source
14 /// code, like a function or a struct, but this is not strictly required.
15 #[derive(Debug, Clone)]
16 pub struct NavigationTarget {
20 full_range: TextRange,
21 focus_range: Option<TextRange>,
24 impl NavigationTarget {
25 pub fn name(&self) -> &SmolStr {
29 pub fn kind(&self) -> SyntaxKind {
33 pub fn file_id(&self) -> FileId {
37 pub fn full_range(&self) -> TextRange {
41 /// A "most interesting" range withing the `range_full`.
43 /// Typically, `range` is the whole syntax node, including doc comments, and
44 /// `focus_range` is the range of the identifier.
45 pub fn focus_range(&self) -> Option<TextRange> {
49 pub(crate) fn from_symbol(symbol: FileSymbol) -> NavigationTarget {
51 file_id: symbol.file_id,
52 name: symbol.name.clone(),
53 kind: symbol.ptr.kind(),
54 full_range: symbol.ptr.range(),
59 pub(crate) fn from_scope_entry(
61 entry: &hir::ScopeEntryWithSyntax,
62 ) -> NavigationTarget {
65 name: entry.name().to_string().into(),
66 full_range: entry.ptr().range(),
72 pub(crate) fn from_module(db: &RootDatabase, module: hir::Module) -> NavigationTarget {
73 let (file_id, source) = module.definition_source(db);
76 .map(|it| it.to_string().into())
79 ModuleSource::SourceFile(node) => {
80 NavigationTarget::from_syntax(file_id, name, None, node.syntax())
82 ModuleSource::Module(node) => {
83 NavigationTarget::from_syntax(file_id, name, None, node.syntax())
88 pub(crate) fn from_module_to_decl(db: &RootDatabase, module: hir::Module) -> NavigationTarget {
91 .map(|it| it.to_string().into())
93 if let Some((file_id, source)) = module.declaration_source(db) {
94 return NavigationTarget::from_syntax(file_id, name, None, source.syntax());
96 NavigationTarget::from_module(db, module)
99 pub(crate) fn from_function(db: &RootDatabase, func: hir::Function) -> NavigationTarget {
100 let (file_id, fn_def) = func.source(db);
101 NavigationTarget::from_named(file_id.original_file(db), &*fn_def)
104 pub(crate) fn from_field(db: &RootDatabase, field: hir::StructField) -> NavigationTarget {
105 let (file_id, field) = field.source(db);
106 let file_id = file_id.original_file(db);
108 FieldSource::Named(it) => NavigationTarget::from_named(file_id, &*it),
109 FieldSource::Pos(it) => {
110 NavigationTarget::from_syntax(file_id, "".into(), None, it.syntax())
115 // TODO once Def::Item is gone, this should be able to always return a NavigationTarget
116 pub(crate) fn from_def(
118 module_def: hir::ModuleDef,
119 ) -> Option<NavigationTarget> {
121 hir::ModuleDef::Module(module) => Some(NavigationTarget::from_module(db, module)),
122 hir::ModuleDef::Function(func) => Some(NavigationTarget::from_function(db, func)),
123 hir::ModuleDef::Struct(s) => {
124 let (file_id, node) = s.source(db);
125 Some(NavigationTarget::from_named(
126 file_id.original_file(db),
130 hir::ModuleDef::Const(s) => {
131 let (file_id, node) = s.source(db);
132 Some(NavigationTarget::from_named(
133 file_id.original_file(db),
137 hir::ModuleDef::Static(s) => {
138 let (file_id, node) = s.source(db);
139 Some(NavigationTarget::from_named(
140 file_id.original_file(db),
144 hir::ModuleDef::Enum(e) => {
145 let (file_id, node) = e.source(db);
146 Some(NavigationTarget::from_named(
147 file_id.original_file(db),
151 hir::ModuleDef::EnumVariant(var) => {
152 let (file_id, node) = var.source(db);
153 Some(NavigationTarget::from_named(
154 file_id.original_file(db),
158 hir::ModuleDef::Trait(e) => {
159 let (file_id, node) = e.source(db);
160 Some(NavigationTarget::from_named(
161 file_id.original_file(db),
165 hir::ModuleDef::Type(e) => {
166 let (file_id, node) = e.source(db);
167 Some(NavigationTarget::from_named(
168 file_id.original_file(db),
176 pub(crate) fn assert_match(&self, expected: &str) {
177 let actual = self.debug_render();
178 test_utils::assert_eq_text!(expected.trim(), actual.trim(),);
182 pub(crate) fn debug_render(&self) -> String {
183 let mut buf = format!(
190 if let Some(focus_range) = self.focus_range() {
191 buf.push_str(&format!(" {:?}", focus_range))
196 fn from_named(file_id: FileId, node: &impl ast::NameOwner) -> NavigationTarget {
197 let name = node.name().map(|it| it.text().clone()).unwrap_or_default();
198 let focus_range = node.name().map(|it| it.syntax().range());
199 NavigationTarget::from_syntax(file_id, name, focus_range, node.syntax())
205 focus_range: Option<TextRange>,
207 ) -> NavigationTarget {
212 full_range: node.range(),
214 // ptr: Some(LocalSyntaxPtr::new(node)),