//! Attributes & documentation for hir types. use either::Either; use hir_def::{ attr::{AttrsWithOwner, Documentation}, item_scope::ItemInNs, path::ModPath, per_ns::PerNs, resolver::HasResolver, AttrDefId, GenericParamId, ModuleDefId, }; use hir_expand::{hygiene::Hygiene, MacroDefId}; use hir_ty::db::HirDatabase; use syntax::ast; use crate::{ Adt, AssocItem, Const, ConstParam, Enum, Field, Function, GenericParam, Impl, LifetimeParam, MacroDef, Module, ModuleDef, Static, Struct, Trait, TypeAlias, TypeParam, Union, Variant, }; pub trait HasAttrs { fn attrs(self, db: &dyn HirDatabase) -> AttrsWithOwner; fn docs(self, db: &dyn HirDatabase) -> Option; fn resolve_doc_path( self, db: &dyn HirDatabase, link: &str, ns: Option, ) -> Option>; } #[derive(PartialEq, Eq, Hash, Copy, Clone, Debug)] pub enum Namespace { Types, Values, Macros, } macro_rules! impl_has_attrs { ($(($def:ident, $def_id:ident),)*) => {$( impl HasAttrs for $def { fn attrs(self, db: &dyn HirDatabase) -> AttrsWithOwner { let def = AttrDefId::$def_id(self.into()); db.attrs(def) } fn docs(self, db: &dyn HirDatabase) -> Option { let def = AttrDefId::$def_id(self.into()); db.attrs(def).docs() } fn resolve_doc_path(self, db: &dyn HirDatabase, link: &str, ns: Option) -> Option> { let def = AttrDefId::$def_id(self.into()); resolve_doc_path(db, def, link, ns).map(|it| it.map_left(ModuleDef::from).map_right(MacroDef::from)) } } )*}; } impl_has_attrs![ (Field, FieldId), (Variant, EnumVariantId), (Static, StaticId), (Const, ConstId), (Trait, TraitId), (TypeAlias, TypeAliasId), (MacroDef, MacroDefId), (Function, FunctionId), (Adt, AdtId), (Module, ModuleId), (GenericParam, GenericParamId), (Impl, ImplId), ]; macro_rules! impl_has_attrs_enum { ($($variant:ident),* for $enum:ident) => {$( impl HasAttrs for $variant { fn attrs(self, db: &dyn HirDatabase) -> AttrsWithOwner { $enum::$variant(self).attrs(db) } fn docs(self, db: &dyn HirDatabase) -> Option { $enum::$variant(self).docs(db) } fn resolve_doc_path(self, db: &dyn HirDatabase, link: &str, ns: Option) -> Option> { $enum::$variant(self).resolve_doc_path(db, link, ns) } } )*}; } impl_has_attrs_enum![Struct, Union, Enum for Adt]; impl_has_attrs_enum![TypeParam, ConstParam, LifetimeParam for GenericParam]; impl HasAttrs for AssocItem { fn attrs(self, db: &dyn HirDatabase) -> AttrsWithOwner { match self { AssocItem::Function(it) => it.attrs(db), AssocItem::Const(it) => it.attrs(db), AssocItem::TypeAlias(it) => it.attrs(db), } } fn docs(self, db: &dyn HirDatabase) -> Option { match self { AssocItem::Function(it) => it.docs(db), AssocItem::Const(it) => it.docs(db), AssocItem::TypeAlias(it) => it.docs(db), } } fn resolve_doc_path( self, db: &dyn HirDatabase, link: &str, ns: Option, ) -> Option> { match self { AssocItem::Function(it) => it.resolve_doc_path(db, link, ns), AssocItem::Const(it) => it.resolve_doc_path(db, link, ns), AssocItem::TypeAlias(it) => it.resolve_doc_path(db, link, ns), } } } fn resolve_doc_path( db: &dyn HirDatabase, def: AttrDefId, link: &str, ns: Option, ) -> Option> { let resolver = match def { AttrDefId::ModuleId(it) => it.resolver(db.upcast()), AttrDefId::FieldId(it) => it.parent.resolver(db.upcast()), AttrDefId::AdtId(it) => it.resolver(db.upcast()), AttrDefId::FunctionId(it) => it.resolver(db.upcast()), AttrDefId::EnumVariantId(it) => it.parent.resolver(db.upcast()), AttrDefId::StaticId(it) => it.resolver(db.upcast()), AttrDefId::ConstId(it) => it.resolver(db.upcast()), AttrDefId::TraitId(it) => it.resolver(db.upcast()), AttrDefId::TypeAliasId(it) => it.resolver(db.upcast()), AttrDefId::ImplId(it) => it.resolver(db.upcast()), AttrDefId::ExternBlockId(it) => it.resolver(db.upcast()), AttrDefId::GenericParamId(it) => match it { GenericParamId::TypeParamId(it) => it.parent, GenericParamId::LifetimeParamId(it) => it.parent, GenericParamId::ConstParamId(it) => it.parent, } .resolver(db.upcast()), // FIXME AttrDefId::MacroDefId(_) => return None, }; let path = ast::Path::parse(link).ok()?; let modpath = ModPath::from_src(db.upcast(), path, &Hygiene::new_unhygienic())?; let resolved = resolver.resolve_module_path_in_items(db.upcast(), &modpath); let resolved = if resolved == PerNs::none() { resolver.resolve_module_path_in_trait_assoc_items(db.upcast(), &modpath)? } else { resolved }; match ns { Some(Namespace::Types) => resolved.take_types().map(Either::Left), Some(Namespace::Values) => resolved.take_values().map(Either::Left), Some(Namespace::Macros) => resolved.take_macros().map(Either::Right), None => resolved.iter_items().next().map(|it| match it { ItemInNs::Types(it) => Either::Left(it), ItemInNs::Values(it) => Either::Left(it), ItemInNs::Macros(it) => Either::Right(it), }), } }