//! Provides set of implementation for hir's objects that allows get back location in file. use either::Either; use hir_def::{ CallableDefId, Lookup, MacroId, VariantId, nameres::{ModuleOrigin, ModuleSource}, src::{HasChildSource, HasSource as _}, }; use hir_expand::{EditionedFileId, HirFileId, InFile}; use hir_ty::{db::InternedClosure, next_solver::AnyImplId}; use syntax::{AstNode, ast}; use tt::TextRange; use crate::{ Adt, AnyFunctionId, Callee, Const, Enum, ExternCrateDecl, Field, FieldSource, Function, Impl, InlineAsmOperand, Label, LifetimeParam, LocalSource, Macro, Module, Param, SelfParam, Static, Struct, Trait, TypeAlias, TypeOrConstParam, Union, Variant, VariantDef, db::HirDatabase, }; pub trait HasSource: Sized { type Ast: AstNode; /// Fetches the definition's source node. /// Using [`crate::SemanticsImpl::source`] is preferred when working with [`crate::Semantics`], /// as that caches the parsed file in the semantics' cache. /// /// The current some implementations can return `InFile` instead of `Option`. /// But we made this method `Option` to support rlib in the future /// by fn source(self, db: &dyn HirDatabase) -> Option>; /// Fetches the source node, along with its full range. /// /// The reason for the separate existence of this method is that some things, notably builtin derive impls, /// do not really have a source node, at least not of the correct type. But we still can trace them /// to source code (the derive producing them). So this method will return the range if it is supported, /// and if the node is supported too it will return it as well. fn source_with_range( self, db: &dyn HirDatabase, ) -> Option)>> { let source = self.source(db)?; Some(source.map(|node| (node.syntax().text_range(), Some(node)))) } } /// NB: Module is !HasSource, because it has two source nodes at the same time: /// definition and declaration. impl Module { /// Returns a node which defines this module. That is, a file or a `mod foo {}` with items. pub fn definition_source(self, db: &dyn HirDatabase) -> InFile { let def_map = self.id.def_map(db); def_map[self.id].definition_source(db) } /// Returns a node which defines this module. That is, a file or a `mod foo {}` with items. pub fn definition_source_range(self, db: &dyn HirDatabase) -> InFile { let def_map = self.id.def_map(db); def_map[self.id].definition_source_range(db) } pub fn definition_source_file_id(self, db: &dyn HirDatabase) -> HirFileId { let def_map = self.id.def_map(db); def_map[self.id].definition_source_file_id() } pub fn is_mod_rs(self, db: &dyn HirDatabase) -> bool { let def_map = self.id.def_map(db); match def_map[self.id].origin { ModuleOrigin::File { is_mod_rs, .. } => is_mod_rs, _ => false, } } pub fn as_source_file_id(self, db: &dyn HirDatabase) -> Option { let def_map = self.id.def_map(db); match def_map[self.id].origin { ModuleOrigin::File { definition, .. } | ModuleOrigin::CrateRoot { definition, .. } => { Some(definition) } _ => None, } } pub fn is_inline(self, db: &dyn HirDatabase) -> bool { let def_map = self.id.def_map(db); def_map[self.id].origin.is_inline() } /// Returns a node which declares this module, either a `mod foo;` or a `mod foo {}`. /// `None` for the crate root. pub fn declaration_source(self, db: &dyn HirDatabase) -> Option> { let def_map = self.id.def_map(db); def_map[self.id].declaration_source(db) } /// Returns a text range which declares this module, either a `mod foo;` or a `mod foo {}`. /// `None` for the crate root. pub fn declaration_source_range(self, db: &dyn HirDatabase) -> Option> { let def_map = self.id.def_map(db); def_map[self.id].declaration_source_range(db) } } impl HasSource for Field { type Ast = FieldSource; fn source(self, db: &dyn HirDatabase) -> Option> { let var = VariantId::from(self.parent); let src = var.child_source(db); let field_source = src.map(|it| match it[self.id].clone() { Either::Left(it) => FieldSource::Pos(it), Either::Right(it) => FieldSource::Named(it), }); Some(field_source) } } impl HasSource for Adt { type Ast = ast::Adt; fn source(self, db: &dyn HirDatabase) -> Option> { match self { Adt::Struct(s) => Some(s.source(db)?.map(ast::Adt::Struct)), Adt::Union(u) => Some(u.source(db)?.map(ast::Adt::Union)), Adt::Enum(e) => Some(e.source(db)?.map(ast::Adt::Enum)), } } } impl HasSource for VariantDef { type Ast = ast::VariantDef; fn source(self, db: &dyn HirDatabase) -> Option> { match self { VariantDef::Struct(s) => Some(s.source(db)?.map(ast::VariantDef::Struct)), VariantDef::Union(u) => Some(u.source(db)?.map(ast::VariantDef::Union)), VariantDef::Variant(v) => Some(v.source(db)?.map(ast::VariantDef::Variant)), } } } impl HasSource for Struct { type Ast = ast::Struct; fn source(self, db: &dyn HirDatabase) -> Option> { Some(self.id.lookup(db).source(db)) } } impl HasSource for Union { type Ast = ast::Union; fn source(self, db: &dyn HirDatabase) -> Option> { Some(self.id.lookup(db).source(db)) } } impl HasSource for Enum { type Ast = ast::Enum; fn source(self, db: &dyn HirDatabase) -> Option> { Some(self.id.lookup(db).source(db)) } } impl HasSource for Variant { type Ast = ast::Variant; fn source(self, db: &dyn HirDatabase) -> Option> { Some(self.id.lookup(db).source(db)) } } impl HasSource for Function { type Ast = ast::Fn; fn source(self, db: &dyn HirDatabase) -> Option> { match self.id { AnyFunctionId::FunctionId(id) => Some(id.loc(db).source(db)), // When calling `source()`, we use the trait method source, but when calling `source_with_range()`, // we return `None` as the syntax node source. This is relying on the assumption that if you are calling // `source_with_range()` (e.g. in navigation) you're prepared to deal with no source node, while if // you call `source()` maybe you don't - therefore we fall back to the trait method, to not lose features. AnyFunctionId::BuiltinDeriveImplMethod { method, impl_ } => method .trait_method(db, impl_) .and_then(|trait_method| Function::from(trait_method).source(db)), } } fn source_with_range( self, db: &dyn HirDatabase, ) -> Option)>> { match self.id { AnyFunctionId::FunctionId(id) => Some( id.loc(db).source(db).map(|source| (source.syntax().text_range(), Some(source))), ), AnyFunctionId::BuiltinDeriveImplMethod { impl_, .. } => { Some(impl_.loc(db).source(db).map(|range| (range, None))) } } } } impl HasSource for Const { type Ast = ast::Const; fn source(self, db: &dyn HirDatabase) -> Option> { Some(self.id.lookup(db).source(db)) } } impl HasSource for Static { type Ast = ast::Static; fn source(self, db: &dyn HirDatabase) -> Option> { Some(self.id.lookup(db).source(db)) } } impl HasSource for Trait { type Ast = ast::Trait; fn source(self, db: &dyn HirDatabase) -> Option> { Some(self.id.lookup(db).source(db)) } } impl HasSource for TypeAlias { type Ast = ast::TypeAlias; fn source(self, db: &dyn HirDatabase) -> Option> { Some(self.id.lookup(db).source(db)) } } impl HasSource for Macro { type Ast = Either; fn source(self, db: &dyn HirDatabase) -> Option> { match self.id { MacroId::Macro2Id(it) => { Some(it.lookup(db).source(db).map(ast::Macro::MacroDef).map(Either::Left)) } MacroId::MacroRulesId(it) => { Some(it.lookup(db).source(db).map(ast::Macro::MacroRules).map(Either::Left)) } MacroId::ProcMacroId(it) => Some(it.lookup(db).source(db).map(Either::Right)), } } } impl HasSource for Impl { type Ast = ast::Impl; fn source(self, db: &dyn HirDatabase) -> Option> { match self.id { AnyImplId::ImplId(id) => Some(id.loc(db).source(db)), AnyImplId::BuiltinDeriveImplId(_) => None, } } fn source_with_range( self, db: &dyn HirDatabase, ) -> Option)>> { match self.id { AnyImplId::ImplId(id) => Some( id.loc(db).source(db).map(|source| (source.syntax().text_range(), Some(source))), ), AnyImplId::BuiltinDeriveImplId(impl_) => { Some(impl_.loc(db).source(db).map(|range| (range, None))) } } } } impl HasSource for TypeOrConstParam { type Ast = Either; fn source(self, db: &dyn HirDatabase) -> Option> { let child_source = self.id.parent.child_source(db); child_source.map(|it| it.get(self.id.local_id).cloned()).transpose() } } impl HasSource for LifetimeParam { type Ast = ast::LifetimeParam; fn source(self, db: &dyn HirDatabase) -> Option> { let child_source = self.id.parent.child_source(db); child_source.map(|it| it.get(self.id.local_id).cloned()).transpose() } } impl HasSource for LocalSource { type Ast = Either; fn source(self, _: &dyn HirDatabase) -> Option> { Some(self.source) } } impl HasSource for Param<'_> { type Ast = Either; fn source(self, db: &dyn HirDatabase) -> Option> { match self.func { Callee::Def(CallableDefId::FunctionId(func)) => { let InFile { file_id, value } = Function::from(func).source(db)?; let params = value.param_list()?; if let Some(self_param) = params.self_param() { if let Some(idx) = self.idx.checked_sub(1) { params.params().nth(idx).map(Either::Right) } else { Some(Either::Left(self_param)) } } else { params.params().nth(self.idx).map(Either::Right) } .map(|value| InFile { file_id, value }) } Callee::Closure(closure, _) => { let InternedClosure(owner, expr_id) = db.lookup_intern_closure(closure); let (_, source_map) = db.body_with_source_map(owner); let ast @ InFile { file_id, value } = source_map.expr_syntax(expr_id).ok()?; let root = db.parse_or_expand(file_id); match value.to_node(&root) { Either::Left(ast::Expr::ClosureExpr(it)) => it .param_list()? .params() .nth(self.idx) .map(Either::Right) .map(|value| InFile { file_id: ast.file_id, value }), _ => None, } } _ => None, } } } impl HasSource for SelfParam { type Ast = ast::SelfParam; fn source(self, db: &dyn HirDatabase) -> Option> { let InFile { file_id, value } = self.func.source(db)?; value .param_list() .and_then(|params| params.self_param()) .map(|value| InFile { file_id, value }) } } impl HasSource for Label { type Ast = ast::Label; fn source(self, db: &dyn HirDatabase) -> Option> { let (_body, source_map) = db.body_with_source_map(self.parent); let src = source_map.label_syntax(self.label_id); let root = src.file_syntax(db); src.map(|ast| ast.to_node(&root).left()).transpose() } } impl HasSource for ExternCrateDecl { type Ast = ast::ExternCrate; fn source(self, db: &dyn HirDatabase) -> Option> { Some(self.id.lookup(db).source(db)) } } impl HasSource for InlineAsmOperand { type Ast = ast::AsmOperandNamed; fn source(self, db: &dyn HirDatabase) -> Option> { let source_map = db.body_with_source_map(self.owner).1; if let Ok(src) = source_map.expr_syntax(self.expr) { let root = src.file_syntax(db); return src .map(|ast| match ast.to_node(&root) { Either::Left(ast::Expr::AsmExpr(asm)) => asm .asm_pieces() .filter_map(|it| match it { ast::AsmPiece::AsmOperandNamed(it) => Some(it), _ => None, }) .nth(self.index), _ => None, }) .transpose(); } None } }