//! `hir_def` crate contains everything between macro expansion and type //! inference. //! //! It defines various items (structs, enums, traits) which comprises Rust code, //! as well as an algorithm for resolving paths to such entities. //! //! Note that `hir_def` is a work in progress, so not all of the above is //! actually true. #![cfg_attr(feature = "in-rust-tree", feature(rustc_private))] #[cfg(feature = "in-rust-tree")] extern crate rustc_parse_format; #[cfg(not(feature = "in-rust-tree"))] extern crate ra_ap_rustc_parse_format as rustc_parse_format; extern crate ra_ap_rustc_abi as rustc_abi; pub mod db; pub mod attrs; pub mod builtin_type; pub mod item_scope; pub mod per_ns; pub mod signatures; pub mod dyn_map; pub mod item_tree; pub mod builtin_derive; pub mod lang_item; pub mod hir; pub use self::hir::type_ref; pub mod expr_store; pub mod resolver; pub mod nameres; pub mod src; pub mod find_path; pub mod import_map; pub mod visibility; use intern::{Interned, Symbol}; pub use rustc_abi as layout; use thin_vec::ThinVec; use triomphe::Arc; pub use crate::signatures::LocalFieldId; #[cfg(test)] mod macro_expansion_tests; #[cfg(test)] mod test_db; use std::hash::{Hash, Hasher}; use base_db::{Crate, impl_intern_key}; use hir_expand::{ AstId, ExpandResult, ExpandTo, HirFileId, InFile, MacroCallId, MacroCallKind, MacroCallStyles, MacroDefId, MacroDefKind, attrs::AttrId, builtin::{BuiltinAttrExpander, BuiltinDeriveExpander, BuiltinFnLikeExpander, EagerExpander}, db::ExpandDatabase, eager::expand_eager_macro_input, impl_intern_lookup, mod_path::ModPath, name::Name, proc_macro::{CustomProcMacroExpander, ProcMacroKind}, }; use nameres::DefMap; use span::{AstIdNode, Edition, FileAstId, SyntaxContext}; use stdx::impl_from; use syntax::{AstNode, ast}; pub use hir_expand::{Intern, Lookup, tt}; use crate::{ attrs::AttrFlags, builtin_derive::BuiltinDeriveImplTrait, builtin_type::BuiltinType, db::DefDatabase, expr_store::ExpressionStoreSourceMap, hir::generics::{GenericParams, LocalLifetimeParamId, LocalTypeOrConstParamId}, nameres::{ LocalDefMap, assoc::{ImplItems, TraitItems}, block_def_map, crate_def_map, crate_local_def_map, diagnostics::DefDiagnostics, }, signatures::{EnumVariants, InactiveEnumVariantCode, VariantFields}, }; type FxIndexMap = indexmap::IndexMap; /// A wrapper around three booleans #[derive(Debug, Clone, PartialEq, Eq, Hash, Copy)] pub struct FindPathConfig { /// If true, prefer to unconditionally use imports of the `core` and `alloc` crate /// over the std. pub prefer_no_std: bool, /// If true, prefer import paths containing a prelude module. pub prefer_prelude: bool, /// If true, prefer abs path (starting with `::`) where it is available. pub prefer_absolute: bool, /// If true, paths containing `#[unstable]` segments may be returned, but only if if there is no /// stable path. This does not check, whether the item itself that is being imported is `#[unstable]`. pub allow_unstable: bool, } #[derive(Debug)] pub struct ItemLoc { pub container: ModuleId, pub id: AstId, } impl Clone for ItemLoc { fn clone(&self) -> Self { *self } } impl Copy for ItemLoc {} impl PartialEq for ItemLoc { fn eq(&self, other: &Self) -> bool { self.container == other.container && self.id == other.id } } impl Eq for ItemLoc {} impl Hash for ItemLoc { fn hash(&self, state: &mut H) { self.container.hash(state); self.id.hash(state); } } impl HasModule for ItemLoc { #[inline] fn module(&self, _db: &dyn DefDatabase) -> ModuleId { self.container } } #[derive(Debug)] pub struct AssocItemLoc { // FIXME: Store this as an erased `salsa::Id` to save space pub container: ItemContainerId, pub id: AstId, } impl Clone for AssocItemLoc { fn clone(&self) -> Self { *self } } impl Copy for AssocItemLoc {} impl PartialEq for AssocItemLoc { fn eq(&self, other: &Self) -> bool { self.container == other.container && self.id == other.id } } impl Eq for AssocItemLoc {} impl Hash for AssocItemLoc { fn hash(&self, state: &mut H) { self.container.hash(state); self.id.hash(state); } } impl HasModule for AssocItemLoc { #[inline] fn module(&self, db: &dyn DefDatabase) -> ModuleId { self.container.module(db) } } pub trait AstIdLoc { type Container; type Ast: AstNode; fn ast_id(&self) -> AstId; fn container(&self) -> Self::Container; } impl AstIdLoc for ItemLoc { type Container = ModuleId; type Ast = N; #[inline] fn ast_id(&self) -> AstId { self.id } #[inline] fn container(&self) -> Self::Container { self.container } } impl AstIdLoc for AssocItemLoc { type Container = ItemContainerId; type Ast = N; #[inline] fn ast_id(&self) -> AstId { self.id } #[inline] fn container(&self) -> Self::Container { self.container } } macro_rules! impl_intern { ($id:ident, $loc:ident, $intern:ident, $lookup:ident) => { impl_intern_key!($id, $loc); impl_intern_lookup!(DefDatabase, $id, $loc, $intern, $lookup); }; } macro_rules! impl_loc { ($loc:ident, $id:ident: $id_ty:ident, $container:ident: $container_type:ident) => { impl AstIdLoc for $loc { type Container = $container_type; type Ast = ast::$id_ty; fn ast_id(&self) -> AstId { self.$id } fn container(&self) -> Self::Container { self.$container } } impl HasModule for $loc { #[inline] fn module(&self, db: &dyn DefDatabase) -> ModuleId { self.$container.module(db) } } }; } type FunctionLoc = AssocItemLoc; impl_intern!(FunctionId, FunctionLoc, intern_function, lookup_intern_function); type StructLoc = ItemLoc; impl_intern!(StructId, StructLoc, intern_struct, lookup_intern_struct); impl StructId { pub fn fields(self, db: &dyn DefDatabase) -> &VariantFields { VariantFields::firewall(db, self.into()) } pub fn fields_with_source_map( self, db: &dyn DefDatabase, ) -> (Arc, Arc) { VariantFields::query(db, self.into()) } } pub type UnionLoc = ItemLoc; impl_intern!(UnionId, UnionLoc, intern_union, lookup_intern_union); impl UnionId { pub fn fields(self, db: &dyn DefDatabase) -> &VariantFields { VariantFields::firewall(db, self.into()) } pub fn fields_with_source_map( self, db: &dyn DefDatabase, ) -> (Arc, Arc) { VariantFields::query(db, self.into()) } } pub type EnumLoc = ItemLoc; impl_intern!(EnumId, EnumLoc, intern_enum, lookup_intern_enum); impl EnumId { #[inline] pub fn enum_variants(self, db: &dyn DefDatabase) -> &EnumVariants { &self.enum_variants_with_diagnostics(db).0 } #[inline] pub fn enum_variants_with_diagnostics( self, db: &dyn DefDatabase, ) -> &(EnumVariants, Option>) { EnumVariants::of(db, self) } } type ConstLoc = AssocItemLoc; impl_intern!(ConstId, ConstLoc, intern_const, lookup_intern_const); pub type StaticLoc = AssocItemLoc; impl_intern!(StaticId, StaticLoc, intern_static, lookup_intern_static); pub type TraitLoc = ItemLoc; impl_intern!(TraitId, TraitLoc, intern_trait, lookup_intern_trait); impl TraitId { #[inline] pub fn trait_items(self, db: &dyn DefDatabase) -> &TraitItems { TraitItems::query(db, self) } } type TypeAliasLoc = AssocItemLoc; impl_intern!(TypeAliasId, TypeAliasLoc, intern_type_alias, lookup_intern_type_alias); type ImplLoc = ItemLoc; impl_intern!(ImplId, ImplLoc, intern_impl, lookup_intern_impl); impl ImplId { #[inline] pub fn impl_items(self, db: &dyn DefDatabase) -> &ImplItems { &self.impl_items_with_diagnostics(db).0 } #[inline] pub fn impl_items_with_diagnostics(self, db: &dyn DefDatabase) -> &(ImplItems, DefDiagnostics) { ImplItems::of(db, self) } } #[derive(Debug, Clone, Copy, PartialEq, Eq, Hash)] pub struct BuiltinDeriveImplLoc { pub adt: AdtId, pub trait_: BuiltinDeriveImplTrait, pub derive_attr_id: AttrId, pub derive_index: u32, } #[salsa::interned(debug, no_lifetime)] #[derive(PartialOrd, Ord)] pub struct BuiltinDeriveImplId { #[returns(ref)] pub loc: BuiltinDeriveImplLoc, } type UseLoc = ItemLoc; impl_intern!(UseId, UseLoc, intern_use, lookup_intern_use); type ExternCrateLoc = ItemLoc; impl_intern!(ExternCrateId, ExternCrateLoc, intern_extern_crate, lookup_intern_extern_crate); type ExternBlockLoc = ItemLoc; impl_intern!(ExternBlockId, ExternBlockLoc, intern_extern_block, lookup_intern_extern_block); #[salsa::tracked] impl ExternBlockId { #[salsa::tracked] pub fn abi(self, db: &dyn DefDatabase) -> Option { signatures::extern_block_abi(db, self) } } #[derive(Debug, Clone, Copy, PartialEq, Eq, Hash)] pub struct EnumVariantLoc { pub id: AstId, pub parent: EnumId, pub index: u32, } impl_intern!(EnumVariantId, EnumVariantLoc, intern_enum_variant, lookup_intern_enum_variant); impl_loc!(EnumVariantLoc, id: Variant, parent: EnumId); impl EnumVariantId { pub fn fields(self, db: &dyn DefDatabase) -> &VariantFields { VariantFields::firewall(db, self.into()) } pub fn fields_with_source_map( self, db: &dyn DefDatabase, ) -> (Arc, Arc) { VariantFields::query(db, self.into()) } } #[derive(Debug, Clone, Copy, PartialEq, Eq, Hash)] pub struct Macro2Loc { pub container: ModuleId, pub id: AstId, pub expander: MacroExpander, pub allow_internal_unsafe: bool, pub edition: Edition, } impl_intern!(Macro2Id, Macro2Loc, intern_macro2, lookup_intern_macro2); impl_loc!(Macro2Loc, id: MacroDef, container: ModuleId); #[derive(Debug, Clone, Copy, PartialEq, Eq, Hash)] pub struct MacroRulesLoc { pub container: ModuleId, pub id: AstId, pub expander: MacroExpander, pub flags: MacroRulesLocFlags, pub edition: Edition, } impl_intern!(MacroRulesId, MacroRulesLoc, intern_macro_rules, lookup_intern_macro_rules); impl_loc!(MacroRulesLoc, id: MacroRules, container: ModuleId); bitflags::bitflags! { #[derive(Debug, Clone, Copy, PartialEq, Eq, Hash)] pub struct MacroRulesLocFlags: u8 { const ALLOW_INTERNAL_UNSAFE = 1 << 0; const LOCAL_INNER = 1 << 1; } } #[derive(Debug, Clone, Copy, PartialEq, Eq, Hash)] pub enum MacroExpander { Declarative { styles: MacroCallStyles }, BuiltIn(BuiltinFnLikeExpander), BuiltInAttr(BuiltinAttrExpander), BuiltInDerive(BuiltinDeriveExpander), BuiltInEager(EagerExpander), } #[derive(Debug, Clone, Copy, PartialEq, Eq, Hash)] pub struct ProcMacroLoc { pub container: ModuleId, pub id: AstId, pub expander: CustomProcMacroExpander, pub kind: ProcMacroKind, pub edition: Edition, } impl_intern!(ProcMacroId, ProcMacroLoc, intern_proc_macro, lookup_intern_proc_macro); impl_loc!(ProcMacroLoc, id: Fn, container: ModuleId); #[derive(Debug, Hash, PartialEq, Eq, Clone)] pub struct BlockLoc { pub ast_id: AstId, /// The containing module. pub module: ModuleId, } impl_intern!(BlockId, BlockLoc, intern_block, lookup_intern_block); #[salsa_macros::tracked(debug)] #[derive(PartialOrd, Ord)] pub struct ModuleIdLt<'db> { /// The crate this module belongs to. pub krate: Crate, /// If this `ModuleId` was derived from a `DefMap` for a block expression, this stores the /// `BlockId` of that block expression. If `None`, this module is part of the crate-level /// `DefMap` of `krate`. pub block: Option, } pub type ModuleId = ModuleIdLt<'static>; impl ModuleIdLt<'_> { /// # Safety /// /// The caller must ensure that the `ModuleId` is not leaked outside of query computations. pub unsafe fn to_static(self) -> ModuleId { unsafe { std::mem::transmute(self) } } } impl ModuleId { /// # Safety /// /// The caller must ensure that the `ModuleId` comes from the given database. pub unsafe fn to_db<'db>(self, _db: &'db dyn DefDatabase) -> ModuleIdLt<'db> { unsafe { std::mem::transmute(self) } } pub fn def_map(self, db: &dyn DefDatabase) -> &DefMap { match self.block(db) { Some(block) => block_def_map(db, block), None => crate_def_map(db, self.krate(db)), } } pub(crate) fn local_def_map(self, db: &dyn DefDatabase) -> (&DefMap, &LocalDefMap) { match self.block(db) { Some(block) => (block_def_map(db, block), self.only_local_def_map(db)), None => { let def_map = crate_local_def_map(db, self.krate(db)); (def_map.def_map(db), def_map.local(db)) } } } pub(crate) fn only_local_def_map(self, db: &dyn DefDatabase) -> &LocalDefMap { crate_local_def_map(db, self.krate(db)).local(db) } pub fn crate_def_map(self, db: &dyn DefDatabase) -> &DefMap { crate_def_map(db, self.krate(db)) } pub fn name(self, db: &dyn DefDatabase) -> Option { let def_map = self.def_map(db); let parent = def_map[self].parent?; def_map[parent].children.iter().find_map(|(name, module_id)| { if *module_id == self { Some(name.clone()) } else { None } }) } /// Returns the module containing `self`, either the parent `mod`, or the module (or block) containing /// the block, if `self` corresponds to a block expression. pub fn containing_module(self, db: &dyn DefDatabase) -> Option { self.def_map(db).containing_module(self) } pub fn is_block_module(self, db: &dyn DefDatabase) -> bool { self.block(db).is_some() && self.def_map(db).root_module_id() == self } } impl HasModule for ModuleId { #[inline] fn module(&self, _db: &dyn DefDatabase) -> ModuleId { *self } } #[derive(Debug, Clone, Copy, PartialEq, Eq, Hash, salsa::Update)] pub struct FieldId { // FIXME: Store this as an erased `salsa::Id` to save space pub parent: VariantId, pub local_id: LocalFieldId, } #[derive(Debug, Clone, Copy, PartialEq, Eq, Hash, salsa::Update)] pub struct TupleId(pub u32); #[derive(Debug, Clone, Copy, PartialEq, Eq, Hash, salsa::Update)] pub struct TupleFieldId { pub tuple: TupleId, pub index: u32, } #[derive(Debug, Clone, Copy, PartialEq, Eq, Hash, PartialOrd, Ord)] pub struct TypeOrConstParamId { // FIXME: Store this as an erased `salsa::Id` to save space pub parent: GenericDefId, pub local_id: LocalTypeOrConstParamId, } /// A TypeOrConstParamId with an invariant that it actually belongs to a type #[derive(Debug, Clone, Copy, PartialEq, Eq, Hash)] pub struct TypeParamId(TypeOrConstParamId); impl TypeParamId { #[inline] pub fn parent(&self) -> GenericDefId { self.0.parent } #[inline] pub fn local_id(&self) -> LocalTypeOrConstParamId { self.0.local_id } #[inline] pub fn trait_self(trait_: TraitId) -> TypeParamId { TypeParamId::from_unchecked(TypeOrConstParamId { parent: trait_.into(), local_id: GenericParams::SELF_PARAM_ID_IN_SELF, }) } #[inline] /// Caller should check if this toc id really belongs to a type pub fn from_unchecked(it: TypeOrConstParamId) -> Self { Self(it) } } impl From for TypeOrConstParamId { fn from(it: TypeParamId) -> Self { it.0 } } /// A TypeOrConstParamId with an invariant that it actually belongs to a const #[derive(Debug, Clone, Copy, PartialEq, Eq, Hash)] pub struct ConstParamId(TypeOrConstParamId); impl ConstParamId { pub fn parent(&self) -> GenericDefId { self.0.parent } pub fn local_id(&self) -> LocalTypeOrConstParamId { self.0.local_id } } impl ConstParamId { /// Caller should check if this toc id really belongs to a const pub fn from_unchecked(it: TypeOrConstParamId) -> Self { Self(it) } } impl From for TypeOrConstParamId { fn from(it: ConstParamId) -> Self { it.0 } } #[derive(Debug, Clone, Copy, PartialEq, Eq, Hash)] pub struct LifetimeParamId { // FIXME: Store this as an erased `salsa::Id` to save space pub parent: GenericDefId, pub local_id: LocalLifetimeParamId, } #[derive(Debug, Clone, Copy, PartialEq, Eq, Hash, salsa_macros::Supertype)] pub enum ItemContainerId { ExternBlockId(ExternBlockId), ModuleId(ModuleId), ImplId(ImplId), TraitId(TraitId), } impl_from!(ModuleId for ItemContainerId); /// A Data Type #[derive(Debug, PartialOrd, Ord, Clone, Copy, PartialEq, Eq, Hash, salsa_macros::Supertype)] pub enum AdtId { StructId(StructId), UnionId(UnionId), EnumId(EnumId), } impl_from!(StructId, UnionId, EnumId for AdtId); /// A macro #[derive(Debug, PartialOrd, Ord, Clone, Copy, PartialEq, Eq, Hash, salsa_macros::Supertype)] pub enum MacroId { Macro2Id(Macro2Id), MacroRulesId(MacroRulesId), ProcMacroId(ProcMacroId), } impl_from!(Macro2Id, MacroRulesId, ProcMacroId for MacroId); impl MacroId { pub fn is_attribute(self, db: &dyn DefDatabase) -> bool { matches!(self, MacroId::ProcMacroId(it) if it.lookup(db).kind == ProcMacroKind::Attr) } } /// A generic param #[derive(Clone, Copy, Debug, PartialEq, Eq, Hash)] pub enum GenericParamId { TypeParamId(TypeParamId), ConstParamId(ConstParamId), LifetimeParamId(LifetimeParamId), } impl_from!(TypeParamId, LifetimeParamId, ConstParamId for GenericParamId); /// The defs which can be visible in the module. #[derive(Debug, Clone, Copy, PartialEq, Eq, Hash)] pub enum ModuleDefId { ModuleId(ModuleId), FunctionId(FunctionId), AdtId(AdtId), // Can't be directly declared, but can be imported. EnumVariantId(EnumVariantId), ConstId(ConstId), StaticId(StaticId), TraitId(TraitId), TypeAliasId(TypeAliasId), BuiltinType(BuiltinType), MacroId(MacroId), } impl_from!( MacroId(Macro2Id, MacroRulesId, ProcMacroId), ModuleId, FunctionId, AdtId(StructId, EnumId, UnionId), EnumVariantId, ConstId, StaticId, TraitId, TypeAliasId, BuiltinType for ModuleDefId ); impl From for ModuleDefId { #[inline] fn from(value: DefWithBodyId) -> Self { match value { DefWithBodyId::FunctionId(id) => id.into(), DefWithBodyId::StaticId(id) => id.into(), DefWithBodyId::ConstId(id) => id.into(), DefWithBodyId::VariantId(id) => id.into(), } } } /// A constant, which might appears as a const item, an anonymous const block in expressions /// or patterns, or as a constant in types with const generics. #[derive(Debug, Clone, Copy, PartialEq, Eq, Hash, salsa_macros::Supertype)] pub enum GeneralConstId { ConstId(ConstId), StaticId(StaticId), } impl_from!(ConstId, StaticId for GeneralConstId); impl GeneralConstId { pub fn generic_def(self, _db: &dyn DefDatabase) -> Option { match self { GeneralConstId::ConstId(it) => Some(it.into()), GeneralConstId::StaticId(it) => Some(it.into()), } } pub fn name(self, db: &dyn DefDatabase) -> String { match self { GeneralConstId::StaticId(it) => { db.static_signature(it).name.display(db, Edition::CURRENT).to_string() } GeneralConstId::ConstId(const_id) => { db.const_signature(const_id).name.as_ref().map_or_else( || "_".to_owned(), |name| name.display(db, Edition::CURRENT).to_string(), ) } } } } /// The defs which have a body (have root expressions for type inference). #[derive(Debug, PartialOrd, Ord, Clone, Copy, PartialEq, Eq, Hash, salsa_macros::Supertype)] pub enum DefWithBodyId { FunctionId(FunctionId), StaticId(StaticId), ConstId(ConstId), VariantId(EnumVariantId), // /// All fields of a variant are inference roots // VariantId(VariantId), // /// The signature can contain inference roots in a bunch of places // /// like const parameters or const arguments in paths // This should likely be kept on its own with a separate query // GenericDefId(GenericDefId), } impl_from!(FunctionId, ConstId, StaticId for DefWithBodyId); impl From for DefWithBodyId { fn from(id: EnumVariantId) -> Self { DefWithBodyId::VariantId(id) } } impl DefWithBodyId { pub fn as_generic_def_id(self, db: &dyn DefDatabase) -> Option { match self { DefWithBodyId::FunctionId(f) => Some(f.into()), DefWithBodyId::StaticId(s) => Some(s.into()), DefWithBodyId::ConstId(c) => Some(c.into()), DefWithBodyId::VariantId(c) => Some(c.lookup(db).parent.into()), } } } #[derive(Debug, Copy, Clone, PartialEq, Eq, Hash, salsa_macros::Supertype)] pub enum AssocItemId { FunctionId(FunctionId), ConstId(ConstId), TypeAliasId(TypeAliasId), } // FIXME: not every function, ... is actually an assoc item. maybe we should make // sure that you can only turn actual assoc items into AssocItemIds. This would // require not implementing From, and instead having some checked way of // casting them, and somehow making the constructors private, which would be annoying. impl_from!(FunctionId, ConstId, TypeAliasId for AssocItemId); impl From for ModuleDefId { fn from(item: AssocItemId) -> Self { match item { AssocItemId::FunctionId(f) => f.into(), AssocItemId::ConstId(c) => c.into(), AssocItemId::TypeAliasId(t) => t.into(), } } } #[derive(Debug, PartialOrd, Ord, Clone, Copy, PartialEq, Eq, Hash, salsa_macros::Supertype)] pub enum GenericDefId { AdtId(AdtId), // consts can have type parameters from their parents (i.e. associated consts of traits) ConstId(ConstId), FunctionId(FunctionId), ImplId(ImplId), // can't actually have generics currently, but they might in the future // More importantly, this completes the set of items that contain type references // which is to be used by the signature expression store in the future. StaticId(StaticId), TraitId(TraitId), TypeAliasId(TypeAliasId), } impl_from!( AdtId(StructId, EnumId, UnionId), ConstId, FunctionId, ImplId, StaticId, TraitId, TypeAliasId for GenericDefId ); impl GenericDefId { pub fn file_id_and_params_of( self, db: &dyn DefDatabase, ) -> (HirFileId, Option) { fn file_id_and_params_of_item_loc( db: &dyn DefDatabase, def: impl Lookup, ) -> (HirFileId, Option) where Loc: src::HasSource, Loc::Value: ast::HasGenericParams, { let src = def.lookup(db).source(db); (src.file_id, ast::HasGenericParams::generic_param_list(&src.value)) } match self { GenericDefId::FunctionId(it) => file_id_and_params_of_item_loc(db, it), GenericDefId::TypeAliasId(it) => file_id_and_params_of_item_loc(db, it), GenericDefId::AdtId(AdtId::StructId(it)) => file_id_and_params_of_item_loc(db, it), GenericDefId::AdtId(AdtId::UnionId(it)) => file_id_and_params_of_item_loc(db, it), GenericDefId::AdtId(AdtId::EnumId(it)) => file_id_and_params_of_item_loc(db, it), GenericDefId::TraitId(it) => file_id_and_params_of_item_loc(db, it), GenericDefId::ImplId(it) => file_id_and_params_of_item_loc(db, it), GenericDefId::ConstId(it) => (it.lookup(db).id.file_id, None), GenericDefId::StaticId(it) => (it.lookup(db).id.file_id, None), } } pub fn assoc_trait_container(self, db: &dyn DefDatabase) -> Option { match match self { GenericDefId::FunctionId(f) => f.lookup(db).container, GenericDefId::TypeAliasId(t) => t.lookup(db).container, GenericDefId::ConstId(c) => c.lookup(db).container, _ => return None, } { ItemContainerId::TraitId(trait_) => Some(trait_), _ => None, } } pub fn from_callable(db: &dyn DefDatabase, def: CallableDefId) -> GenericDefId { match def { CallableDefId::FunctionId(f) => f.into(), CallableDefId::StructId(s) => s.into(), CallableDefId::EnumVariantId(e) => e.lookup(db).parent.into(), } } } impl From for GenericDefId { fn from(item: AssocItemId) -> Self { match item { AssocItemId::FunctionId(f) => f.into(), AssocItemId::ConstId(c) => c.into(), AssocItemId::TypeAliasId(t) => t.into(), } } } #[derive(Debug, PartialOrd, Ord, Clone, Copy, PartialEq, Eq, Hash, salsa_macros::Supertype)] pub enum CallableDefId { FunctionId(FunctionId), StructId(StructId), EnumVariantId(EnumVariantId), } impl_from!(FunctionId, StructId, EnumVariantId for CallableDefId); impl From for ModuleDefId { fn from(def: CallableDefId) -> ModuleDefId { match def { CallableDefId::FunctionId(f) => ModuleDefId::FunctionId(f), CallableDefId::StructId(s) => ModuleDefId::AdtId(AdtId::StructId(s)), CallableDefId::EnumVariantId(e) => ModuleDefId::EnumVariantId(e), } } } impl CallableDefId { pub fn krate(self, db: &dyn DefDatabase) -> Crate { match self { CallableDefId::FunctionId(f) => f.krate(db), CallableDefId::StructId(s) => s.krate(db), CallableDefId::EnumVariantId(e) => e.krate(db), } } } #[derive(Clone, Copy, Debug, PartialEq, Eq, Hash, salsa_macros::Supertype)] pub enum AttrDefId { ModuleId(ModuleId), AdtId(AdtId), FunctionId(FunctionId), EnumVariantId(EnumVariantId), StaticId(StaticId), ConstId(ConstId), TraitId(TraitId), TypeAliasId(TypeAliasId), MacroId(MacroId), ImplId(ImplId), ExternBlockId(ExternBlockId), ExternCrateId(ExternCrateId), UseId(UseId), } impl_from!( AdtId(StructId, EnumId, UnionId), EnumVariantId, StaticId, ConstId, FunctionId, TraitId, TypeAliasId, MacroId(Macro2Id, MacroRulesId, ProcMacroId), ImplId, ExternCrateId, UseId for AttrDefId ); impl From for AttrDefId { fn from(assoc: AssocItemId) -> Self { match assoc { AssocItemId::FunctionId(it) => AttrDefId::FunctionId(it), AssocItemId::ConstId(it) => AttrDefId::ConstId(it), AssocItemId::TypeAliasId(it) => AttrDefId::TypeAliasId(it), } } } impl From for AttrDefId { fn from(vid: VariantId) -> Self { match vid { VariantId::EnumVariantId(id) => id.into(), VariantId::StructId(id) => id.into(), VariantId::UnionId(id) => id.into(), } } } #[derive(Debug, Clone, Copy, PartialEq, Eq, Hash, salsa_macros::Supertype, salsa::Update)] pub enum VariantId { EnumVariantId(EnumVariantId), StructId(StructId), UnionId(UnionId), } impl_from!(EnumVariantId, StructId, UnionId for VariantId); impl VariantId { pub fn fields(self, db: &dyn DefDatabase) -> &VariantFields { VariantFields::firewall(db, self) } pub fn fields_with_source_map( self, db: &dyn DefDatabase, ) -> (Arc, Arc) { VariantFields::query(db, self) } pub fn file_id(self, db: &dyn DefDatabase) -> HirFileId { match self { VariantId::EnumVariantId(it) => it.lookup(db).id.file_id, VariantId::StructId(it) => it.lookup(db).id.file_id, VariantId::UnionId(it) => it.lookup(db).id.file_id, } } pub fn adt_id(self, db: &dyn DefDatabase) -> AdtId { match self { VariantId::EnumVariantId(it) => it.lookup(db).parent.into(), VariantId::StructId(it) => it.into(), VariantId::UnionId(it) => it.into(), } } } pub trait HasModule { /// Returns the enclosing module this thing is defined within. fn module(&self, db: &dyn DefDatabase) -> ModuleId; /// Returns the crate this thing is defined within. #[inline] #[doc(alias = "crate")] fn krate(&self, db: &dyn DefDatabase) -> Crate { self.module(db).krate(db) } } // In theory this impl should work out for us, but rustc thinks it collides with all the other // manual impls that do not have a ModuleId container... // impl HasModule for ItemId // where // N: ItemTreeNode, // ItemId: for<'db> Lookup = dyn DefDatabase + 'db, Data = Data> + Copy, // Data: ItemTreeLoc, // { // #[inline] // fn module(&self, db: &dyn DefDatabase) -> ModuleId { // self.lookup(db).container() // } // } impl HasModule for ItemId where N: AstIdNode, ItemId: Lookup> + Copy, { #[inline] fn module(&self, db: &dyn DefDatabase) -> ModuleId { self.lookup(db).container } } // Technically this does not overlap with the above, but rustc currently forbids this, hence why we // need to write the 3 impls manually instead // impl HasModule for ItemId // where // N: ItemTreeModItemNode, // ItemId: for<'db> Lookup = dyn DefDatabase + 'db, Data = AssocItemLoc> + Copy, // { // #[inline] // fn module(&self, db: &dyn DefDatabase) -> ModuleId { // self.lookup(db).container.module(db) // } // } // region: manual-assoc-has-module-impls #[inline] fn module_for_assoc_item_loc<'db>( db: &(dyn 'db + DefDatabase), id: impl Lookup>, ) -> ModuleId { id.lookup(db).container.module(db) } impl HasModule for BuiltinDeriveImplLoc { #[inline] fn module(&self, db: &dyn DefDatabase) -> ModuleId { self.adt.module(db) } } impl HasModule for BuiltinDeriveImplId { #[inline] fn module(&self, db: &dyn DefDatabase) -> ModuleId { self.loc(db).module(db) } } impl HasModule for FunctionId { #[inline] fn module(&self, db: &dyn DefDatabase) -> ModuleId { module_for_assoc_item_loc(db, *self) } } impl HasModule for ConstId { #[inline] fn module(&self, db: &dyn DefDatabase) -> ModuleId { module_for_assoc_item_loc(db, *self) } } impl HasModule for StaticId { #[inline] fn module(&self, db: &dyn DefDatabase) -> ModuleId { module_for_assoc_item_loc(db, *self) } } impl HasModule for TypeAliasId { #[inline] fn module(&self, db: &dyn DefDatabase) -> ModuleId { module_for_assoc_item_loc(db, *self) } } // endregion: manual-assoc-has-module-impls impl HasModule for EnumVariantId { #[inline] fn module(&self, db: &dyn DefDatabase) -> ModuleId { self.lookup(db).parent.module(db) } } impl HasModule for MacroRulesId { #[inline] fn module(&self, db: &dyn DefDatabase) -> ModuleId { self.lookup(db).container } } impl HasModule for Macro2Id { #[inline] fn module(&self, db: &dyn DefDatabase) -> ModuleId { self.lookup(db).container } } impl HasModule for ProcMacroId { #[inline] fn module(&self, db: &dyn DefDatabase) -> ModuleId { self.lookup(db).container } } impl HasModule for ItemContainerId { fn module(&self, db: &dyn DefDatabase) -> ModuleId { match *self { ItemContainerId::ModuleId(it) => it, ItemContainerId::ImplId(it) => it.module(db), ItemContainerId::TraitId(it) => it.module(db), ItemContainerId::ExternBlockId(it) => it.module(db), } } } impl HasModule for AdtId { fn module(&self, db: &dyn DefDatabase) -> ModuleId { match *self { AdtId::StructId(it) => it.module(db), AdtId::UnionId(it) => it.module(db), AdtId::EnumId(it) => it.module(db), } } } impl HasModule for VariantId { fn module(&self, db: &dyn DefDatabase) -> ModuleId { match *self { VariantId::EnumVariantId(it) => it.module(db), VariantId::StructId(it) => it.module(db), VariantId::UnionId(it) => it.module(db), } } } impl HasModule for MacroId { fn module(&self, db: &dyn DefDatabase) -> ModuleId { match *self { MacroId::MacroRulesId(it) => it.module(db), MacroId::Macro2Id(it) => it.module(db), MacroId::ProcMacroId(it) => it.module(db), } } } impl HasModule for DefWithBodyId { fn module(&self, db: &dyn DefDatabase) -> ModuleId { match self { DefWithBodyId::FunctionId(it) => it.module(db), DefWithBodyId::StaticId(it) => it.module(db), DefWithBodyId::ConstId(it) => it.module(db), DefWithBodyId::VariantId(it) => it.module(db), } } } impl HasModule for GenericDefId { fn module(&self, db: &dyn DefDatabase) -> ModuleId { match self { GenericDefId::FunctionId(it) => it.module(db), GenericDefId::AdtId(it) => it.module(db), GenericDefId::TraitId(it) => it.module(db), GenericDefId::TypeAliasId(it) => it.module(db), GenericDefId::ImplId(it) => it.module(db), GenericDefId::ConstId(it) => it.module(db), GenericDefId::StaticId(it) => it.module(db), } } } impl HasModule for AttrDefId { fn module(&self, db: &dyn DefDatabase) -> ModuleId { match self { AttrDefId::ModuleId(it) => *it, AttrDefId::AdtId(it) => it.module(db), AttrDefId::FunctionId(it) => it.module(db), AttrDefId::EnumVariantId(it) => it.module(db), AttrDefId::StaticId(it) => it.module(db), AttrDefId::ConstId(it) => it.module(db), AttrDefId::TraitId(it) => it.module(db), AttrDefId::TypeAliasId(it) => it.module(db), AttrDefId::ImplId(it) => it.module(db), AttrDefId::ExternBlockId(it) => it.module(db), AttrDefId::MacroId(it) => it.module(db), AttrDefId::ExternCrateId(it) => it.module(db), AttrDefId::UseId(it) => it.module(db), } } } impl ModuleDefId { /// Returns the module containing `self` (or `self`, if `self` is itself a module). /// /// Returns `None` if `self` refers to a primitive type. pub fn module(&self, db: &dyn DefDatabase) -> Option { Some(match self { ModuleDefId::ModuleId(id) => *id, ModuleDefId::FunctionId(id) => id.module(db), ModuleDefId::AdtId(id) => id.module(db), ModuleDefId::EnumVariantId(id) => id.module(db), ModuleDefId::ConstId(id) => id.module(db), ModuleDefId::StaticId(id) => id.module(db), ModuleDefId::TraitId(id) => id.module(db), ModuleDefId::TypeAliasId(id) => id.module(db), ModuleDefId::MacroId(id) => id.module(db), ModuleDefId::BuiltinType(_) => return None, }) } } /// Helper wrapper for `AstId` with `ModPath` #[derive(Clone, Debug, Eq, PartialEq)] struct AstIdWithPath { ast_id: AstId, path: Interned, } impl AstIdWithPath { fn new(file_id: HirFileId, ast_id: FileAstId, path: Interned) -> AstIdWithPath { AstIdWithPath { ast_id: AstId::new(file_id, ast_id), path } } } pub fn macro_call_as_call_id( db: &dyn ExpandDatabase, ast_id: AstId, path: &ModPath, call_site: SyntaxContext, expand_to: ExpandTo, krate: Crate, resolver: impl Fn(&ModPath) -> Option + Copy, eager_callback: &mut dyn FnMut( InFile<(syntax::AstPtr, span::FileAstId)>, MacroCallId, ), ) -> Result>, UnresolvedMacro> { let def = resolver(path).ok_or_else(|| UnresolvedMacro { path: path.clone() })?; let res = match def.kind { MacroDefKind::BuiltInEager(..) => expand_eager_macro_input( db, krate, &ast_id.to_node(db), ast_id, def, call_site, &|path| resolver(path).filter(MacroDefId::is_fn_like), eager_callback, ), _ if def.is_fn_like() => ExpandResult { value: Some(def.make_call( db, krate, MacroCallKind::FnLike { ast_id, expand_to, eager: None }, call_site, )), err: None, }, _ => return Err(UnresolvedMacro { path: path.clone() }), }; Ok(res) } #[derive(Debug)] pub struct UnresolvedMacro { pub path: ModPath, } #[derive(Default, Debug, Eq, PartialEq, Clone, Copy)] pub struct SyntheticSyntax; // Feature: Completions Attribute // Crate authors can opt their type out of completions in some cases. // This is done with the `#[rust_analyzer::completions(...)]` attribute. // // All completable things support `#[rust_analyzer::completions(ignore_flyimport)]`, // which causes the thing to get excluded from flyimport completion. It will still // be completed when in scope. This is analogous to the setting `rust-analyzer.completion.autoimport.exclude` // with `"type": "always"`. // // In addition, traits support two more modes: `#[rust_analyzer::completions(ignore_flyimport_methods)]`, // which means the trait itself may still be flyimported but its methods won't, and // `#[rust_analyzer::completions(ignore_methods)]`, which means the methods won't be completed even when // the trait is in scope (but the trait itself may still be completed). The methods will still be completed // on `dyn Trait`, `impl Trait` or where the trait is specified in bounds. These modes correspond to // the settings `rust-analyzer.completion.autoimport.exclude` with `"type": "methods"` and // `rust-analyzer.completion.excludeTraits`, respectively. // // Malformed attributes will be ignored without warnings. // // Note that users have no way to override this attribute, so be careful and only include things // users definitely do not want to be completed! /// `#[rust_analyzer::completions(...)]` options. #[derive(Debug, Clone, Copy, PartialEq, Eq, PartialOrd, Ord, Hash)] pub enum Complete { /// No `#[rust_analyzer::completions(...)]`. Yes, /// `#[rust_analyzer::completions(ignore_flyimport)]`. IgnoreFlyimport, /// `#[rust_analyzer::completions(ignore_flyimport_methods)]` (on a trait only). IgnoreFlyimportMethods, /// `#[rust_analyzer::completions(ignore_methods)]` (on a trait only). IgnoreMethods, } impl Complete { #[inline] pub fn extract(is_trait: bool, attrs: AttrFlags) -> Complete { if attrs.contains(AttrFlags::COMPLETE_IGNORE_FLYIMPORT) { return Complete::IgnoreFlyimport; } else if is_trait { if attrs.contains(AttrFlags::COMPLETE_IGNORE_METHODS) { return Complete::IgnoreMethods; } else if attrs.contains(AttrFlags::COMPLETE_IGNORE_FLYIMPORT_METHODS) { return Complete::IgnoreFlyimportMethods; } } Complete::Yes } #[inline] pub fn for_trait_item(trait_attr: Complete, item_attr: Complete) -> Complete { match (trait_attr, item_attr) { ( Complete::IgnoreFlyimportMethods | Complete::IgnoreFlyimport | Complete::IgnoreMethods, _, ) => Complete::IgnoreFlyimport, _ => item_attr, } } }