//! A higher level attributes based on TokenTree, with also some shortcuts. use std::{ convert::{TryFrom, TryInto}, fmt, ops, sync::Arc, }; use base_db::CrateId; use cfg::{CfgExpr, CfgOptions}; use either::Either; use hir_expand::{hygiene::Hygiene, name::AsName, AstId, InFile}; use itertools::Itertools; use la_arena::ArenaMap; use mbe::ast_to_token_tree; use smallvec::{smallvec, SmallVec}; use syntax::{ ast::{self, AstNode, AttrsOwner}, match_ast, AstPtr, AstToken, SmolStr, SyntaxNode, TextRange, TextSize, }; use tt::Subtree; use crate::{ db::DefDatabase, intern::Interned, item_tree::{ItemTreeId, ItemTreeNode}, nameres::ModuleSource, path::{ModPath, PathKind}, src::{HasChildSource, HasSource}, AdtId, AttrDefId, EnumId, GenericParamId, HasModule, LocalEnumVariantId, LocalFieldId, Lookup, VariantId, }; /// Holds documentation #[derive(Debug, Clone, PartialEq, Eq, Hash)] pub struct Documentation(String); impl Documentation { pub fn new(s: String) -> Self { Documentation(s) } pub fn as_str(&self) -> &str { &self.0 } } impl From for String { fn from(Documentation(string): Documentation) -> Self { string } } /// Syntactical attributes, without filtering of `cfg_attr`s. #[derive(Default, Debug, Clone, PartialEq, Eq)] pub(crate) struct RawAttrs { entries: Option>, } #[derive(Default, Debug, Clone, PartialEq, Eq)] pub struct Attrs(RawAttrs); #[derive(Debug, Clone, PartialEq, Eq)] pub struct AttrsWithOwner { attrs: Attrs, owner: AttrDefId, } impl ops::Deref for RawAttrs { type Target = [Attr]; fn deref(&self) -> &[Attr] { match &self.entries { Some(it) => &*it, None => &[], } } } impl ops::Deref for Attrs { type Target = [Attr]; fn deref(&self) -> &[Attr] { match &self.0.entries { Some(it) => &*it, None => &[], } } } impl ops::Deref for AttrsWithOwner { type Target = Attrs; fn deref(&self) -> &Attrs { &self.attrs } } impl RawAttrs { pub(crate) const EMPTY: Self = Self { entries: None }; pub(crate) fn new( db: &dyn DefDatabase, owner: &dyn ast::AttrsOwner, hygiene: &Hygiene, ) -> Self { let entries = collect_attrs(owner) .flat_map(|(id, attr)| match attr { Either::Left(attr) => { attr.meta().and_then(|meta| Attr::from_src(db, meta, hygiene, id)) } Either::Right(comment) => comment.doc_comment().map(|doc| Attr { id, input: Some(Interned::new(AttrInput::Literal(SmolStr::new(doc)))), path: Interned::new(ModPath::from(hir_expand::name!(doc))), }), }) .collect::>(); Self { entries: if entries.is_empty() { None } else { Some(entries) } } } fn from_attrs_owner(db: &dyn DefDatabase, owner: InFile<&dyn ast::AttrsOwner>) -> Self { let hygiene = Hygiene::new(db.upcast(), owner.file_id); Self::new(db, owner.value, &hygiene) } pub(crate) fn merge(&self, other: Self) -> Self { // FIXME: This needs to fixup `AttrId`s match (&self.entries, &other.entries) { (None, None) => Self::EMPTY, (Some(entries), None) | (None, Some(entries)) => { Self { entries: Some(entries.clone()) } } (Some(a), Some(b)) => { Self { entries: Some(a.iter().chain(b.iter()).cloned().collect()) } } } } /// Processes `cfg_attr`s, returning the resulting semantic `Attrs`. pub(crate) fn filter(self, db: &dyn DefDatabase, krate: CrateId) -> Attrs { let has_cfg_attrs = self.iter().any(|attr| { attr.path.as_ident().map_or(false, |name| *name == hir_expand::name![cfg_attr]) }); if !has_cfg_attrs { return Attrs(self); } let crate_graph = db.crate_graph(); let new_attrs = self .iter() .flat_map(|attr| -> SmallVec<[_; 1]> { let is_cfg_attr = attr.path.as_ident().map_or(false, |name| *name == hir_expand::name![cfg_attr]); if !is_cfg_attr { return smallvec![attr.clone()]; } let subtree = match attr.input.as_deref() { Some(AttrInput::TokenTree(it)) => it, _ => return smallvec![attr.clone()], }; // Input subtree is: `(cfg, $(attr),+)` // Split it up into a `cfg` subtree and the `attr` subtrees. // FIXME: There should be a common API for this. let mut parts = subtree.token_trees.split( |tt| matches!(tt, tt::TokenTree::Leaf(tt::Leaf::Punct(p)) if p.char == ','), ); let cfg = parts.next().unwrap(); let cfg = Subtree { delimiter: subtree.delimiter, token_trees: cfg.to_vec() }; let cfg = CfgExpr::parse(&cfg); let index = attr.id; let attrs = parts.filter(|a| !a.is_empty()).filter_map(|attr| { let tree = Subtree { delimiter: None, token_trees: attr.to_vec() }; // FIXME hygiene let hygiene = Hygiene::new_unhygienic(); Attr::from_tt(db, &tree, &hygiene, index) }); let cfg_options = &crate_graph[krate].cfg_options; if cfg_options.check(&cfg) == Some(false) { smallvec![] } else { cov_mark::hit!(cfg_attr_active); attrs.collect() } }) .collect(); Attrs(RawAttrs { entries: Some(new_attrs) }) } } impl Attrs { pub const EMPTY: Self = Self(RawAttrs::EMPTY); pub(crate) fn variants_attrs_query( db: &dyn DefDatabase, e: EnumId, ) -> Arc> { let krate = e.lookup(db).container.krate; let src = e.child_source(db); let mut res = ArenaMap::default(); for (id, var) in src.value.iter() { let attrs = RawAttrs::from_attrs_owner(db, src.with_value(var as &dyn ast::AttrsOwner)) .filter(db, krate); res.insert(id, attrs) } Arc::new(res) } pub(crate) fn fields_attrs_query( db: &dyn DefDatabase, v: VariantId, ) -> Arc> { let krate = v.module(db).krate; let src = v.child_source(db); let mut res = ArenaMap::default(); for (id, fld) in src.value.iter() { let owner: &dyn AttrsOwner = match fld { Either::Left(tuple) => tuple, Either::Right(record) => record, }; let attrs = RawAttrs::from_attrs_owner(db, src.with_value(owner)).filter(db, krate); res.insert(id, attrs); } Arc::new(res) } pub fn by_key(&self, key: &'static str) -> AttrQuery<'_> { AttrQuery { attrs: self, key } } pub fn cfg(&self) -> Option { let mut cfgs = self.by_key("cfg").tt_values().map(CfgExpr::parse).collect::>(); match cfgs.len() { 0 => None, 1 => Some(cfgs.pop().unwrap()), _ => Some(CfgExpr::All(cfgs)), } } pub(crate) fn is_cfg_enabled(&self, cfg_options: &CfgOptions) -> bool { match self.cfg() { None => true, Some(cfg) => cfg_options.check(&cfg) != Some(false), } } pub fn docs(&self) -> Option { let docs = self.by_key("doc").attrs().flat_map(|attr| match attr.input.as_deref()? { AttrInput::Literal(s) => Some(s), AttrInput::TokenTree(_) => None, }); let indent = docs .clone() .flat_map(|s| s.lines()) .filter(|line| !line.chars().all(|c| c.is_whitespace())) .map(|line| line.chars().take_while(|c| c.is_whitespace()).count()) .min() .unwrap_or(0); let mut buf = String::new(); for doc in docs { // str::lines doesn't yield anything for the empty string if !doc.is_empty() { buf.extend(Itertools::intersperse( doc.lines().map(|line| { line.char_indices() .nth(indent) .map_or(line, |(offset, _)| &line[offset..]) .trim_end() }), "\n", )); } buf.push('\n'); } buf.pop(); if buf.is_empty() { None } else { Some(Documentation(buf)) } } } impl AttrsWithOwner { pub(crate) fn attrs_query(db: &dyn DefDatabase, def: AttrDefId) -> Self { // FIXME: this should use `Trace` to avoid duplication in `source_map` below let raw_attrs = match def { AttrDefId::ModuleId(module) => { let def_map = module.def_map(db); let mod_data = &def_map[module.local_id]; match mod_data.declaration_source(db) { Some(it) => { let raw_attrs = RawAttrs::from_attrs_owner( db, it.as_ref().map(|it| it as &dyn ast::AttrsOwner), ); match mod_data.definition_source(db) { InFile { file_id, value: ModuleSource::SourceFile(file) } => raw_attrs .merge(RawAttrs::from_attrs_owner(db, InFile::new(file_id, &file))), _ => raw_attrs, } } None => RawAttrs::from_attrs_owner( db, mod_data.definition_source(db).as_ref().map(|src| match src { ModuleSource::SourceFile(file) => file as &dyn ast::AttrsOwner, ModuleSource::Module(module) => module as &dyn ast::AttrsOwner, ModuleSource::BlockExpr(block) => block as &dyn ast::AttrsOwner, }), ), } } AttrDefId::FieldId(it) => { return Self { attrs: db.fields_attrs(it.parent)[it.local_id].clone(), owner: def }; } AttrDefId::EnumVariantId(it) => { return Self { attrs: db.variants_attrs(it.parent)[it.local_id].clone(), owner: def, }; } AttrDefId::AdtId(it) => match it { AdtId::StructId(it) => attrs_from_item_tree(it.lookup(db).id, db), AdtId::EnumId(it) => attrs_from_item_tree(it.lookup(db).id, db), AdtId::UnionId(it) => attrs_from_item_tree(it.lookup(db).id, db), }, AttrDefId::TraitId(it) => attrs_from_item_tree(it.lookup(db).id, db), AttrDefId::MacroDefId(it) => it .ast_id() .left() .map_or_else(Default::default, |ast_id| attrs_from_ast(ast_id, db)), AttrDefId::ImplId(it) => attrs_from_item_tree(it.lookup(db).id, db), AttrDefId::ConstId(it) => attrs_from_item_tree(it.lookup(db).id, db), AttrDefId::StaticId(it) => attrs_from_item_tree(it.lookup(db).id, db), AttrDefId::FunctionId(it) => attrs_from_item_tree(it.lookup(db).id, db), AttrDefId::TypeAliasId(it) => attrs_from_item_tree(it.lookup(db).id, db), AttrDefId::GenericParamId(it) => match it { GenericParamId::TypeParamId(it) => { let src = it.parent.child_source(db); RawAttrs::from_attrs_owner( db, src.with_value( src.value[it.local_id].as_ref().either(|it| it as _, |it| it as _), ), ) } GenericParamId::LifetimeParamId(it) => { let src = it.parent.child_source(db); RawAttrs::from_attrs_owner(db, src.with_value(&src.value[it.local_id])) } GenericParamId::ConstParamId(it) => { let src = it.parent.child_source(db); RawAttrs::from_attrs_owner(db, src.with_value(&src.value[it.local_id])) } }, }; let attrs = raw_attrs.filter(db, def.krate(db)); Self { attrs, owner: def } } pub fn source_map(&self, db: &dyn DefDatabase) -> AttrSourceMap { let owner = match self.owner { AttrDefId::ModuleId(module) => { // Modules can have 2 attribute owners (the `mod x;` item, and the module file itself). let def_map = module.def_map(db); let mod_data = &def_map[module.local_id]; match mod_data.declaration_source(db) { Some(it) => { let mut map = AttrSourceMap::new(InFile::new(it.file_id, &it.value)); if let InFile { file_id, value: ModuleSource::SourceFile(file) } = mod_data.definition_source(db) { map.merge(AttrSourceMap::new(InFile::new(file_id, &file))); } return map; } None => { let InFile { file_id, value } = mod_data.definition_source(db); let attrs_owner = match &value { ModuleSource::SourceFile(file) => file as &dyn ast::AttrsOwner, ModuleSource::Module(module) => module as &dyn ast::AttrsOwner, ModuleSource::BlockExpr(block) => block as &dyn ast::AttrsOwner, }; return AttrSourceMap::new(InFile::new(file_id, attrs_owner)); } } } AttrDefId::FieldId(id) => { let map = db.fields_attrs_source_map(id.parent); let file_id = id.parent.file_id(db); let root = db.parse_or_expand(file_id).unwrap(); let owner = match &map[id.local_id] { Either::Left(it) => ast::AttrsOwnerNode::new(it.to_node(&root)), Either::Right(it) => ast::AttrsOwnerNode::new(it.to_node(&root)), }; InFile::new(file_id, owner) } AttrDefId::AdtId(adt) => match adt { AdtId::StructId(id) => id.lookup(db).source(db).map(ast::AttrsOwnerNode::new), AdtId::UnionId(id) => id.lookup(db).source(db).map(ast::AttrsOwnerNode::new), AdtId::EnumId(id) => id.lookup(db).source(db).map(ast::AttrsOwnerNode::new), }, AttrDefId::FunctionId(id) => id.lookup(db).source(db).map(ast::AttrsOwnerNode::new), AttrDefId::EnumVariantId(id) => { let map = db.variants_attrs_source_map(id.parent); let file_id = id.parent.lookup(db).id.file_id(); let root = db.parse_or_expand(file_id).unwrap(); InFile::new(file_id, ast::AttrsOwnerNode::new(map[id.local_id].to_node(&root))) } AttrDefId::StaticId(id) => id.lookup(db).source(db).map(ast::AttrsOwnerNode::new), AttrDefId::ConstId(id) => id.lookup(db).source(db).map(ast::AttrsOwnerNode::new), AttrDefId::TraitId(id) => id.lookup(db).source(db).map(ast::AttrsOwnerNode::new), AttrDefId::TypeAliasId(id) => id.lookup(db).source(db).map(ast::AttrsOwnerNode::new), AttrDefId::MacroDefId(id) => match id.ast_id() { Either::Left(it) => { it.with_value(ast::AttrsOwnerNode::new(it.to_node(db.upcast()))) } Either::Right(it) => { it.with_value(ast::AttrsOwnerNode::new(it.to_node(db.upcast()))) } }, AttrDefId::ImplId(id) => id.lookup(db).source(db).map(ast::AttrsOwnerNode::new), AttrDefId::GenericParamId(id) => match id { GenericParamId::TypeParamId(id) => { id.parent.child_source(db).map(|source| match &source[id.local_id] { Either::Left(id) => ast::AttrsOwnerNode::new(id.clone()), Either::Right(id) => ast::AttrsOwnerNode::new(id.clone()), }) } GenericParamId::LifetimeParamId(id) => id .parent .child_source(db) .map(|source| ast::AttrsOwnerNode::new(source[id.local_id].clone())), GenericParamId::ConstParamId(id) => id .parent .child_source(db) .map(|source| ast::AttrsOwnerNode::new(source[id.local_id].clone())), }, }; AttrSourceMap::new(owner.as_ref().map(|node| node as &dyn AttrsOwner)) } pub fn docs_with_rangemap( &self, db: &dyn DefDatabase, ) -> Option<(Documentation, DocsRangeMap)> { // FIXME: code duplication in `docs` above let docs = self.by_key("doc").attrs().flat_map(|attr| match attr.input.as_deref()? { AttrInput::Literal(s) => Some((s, attr.id)), AttrInput::TokenTree(_) => None, }); let indent = docs .clone() .flat_map(|(s, _)| s.lines()) .filter(|line| !line.chars().all(|c| c.is_whitespace())) .map(|line| line.chars().take_while(|c| c.is_whitespace()).count()) .min() .unwrap_or(0); let mut buf = String::new(); let mut mapping = Vec::new(); for (doc, idx) in docs { if !doc.is_empty() { let mut base_offset = 0; for raw_line in doc.split('\n') { let line = raw_line.trim_end(); let line_len = line.len(); let (offset, line) = match line.char_indices().nth(indent) { Some((offset, _)) => (offset, &line[offset..]), None => (0, line), }; let buf_offset = buf.len(); buf.push_str(line); mapping.push(( TextRange::new(buf_offset.try_into().ok()?, buf.len().try_into().ok()?), idx, TextRange::at( (base_offset + offset).try_into().ok()?, line_len.try_into().ok()?, ), )); buf.push('\n'); base_offset += raw_line.len() + 1; } } else { buf.push('\n'); } } buf.pop(); if buf.is_empty() { None } else { Some((Documentation(buf), DocsRangeMap { mapping, source_map: self.source_map(db) })) } } } fn inner_attributes( syntax: &SyntaxNode, ) -> Option<(impl Iterator, impl Iterator)> { let (attrs, docs) = match_ast! { match syntax { ast::SourceFile(it) => (it.attrs(), ast::CommentIter::from_syntax_node(it.syntax())), ast::ExternBlock(it) => { let extern_item_list = it.extern_item_list()?; (extern_item_list.attrs(), ast::CommentIter::from_syntax_node(extern_item_list.syntax())) }, ast::Fn(it) => { let body = it.body()?; (body.attrs(), ast::CommentIter::from_syntax_node(body.syntax())) }, ast::Impl(it) => { let assoc_item_list = it.assoc_item_list()?; (assoc_item_list.attrs(), ast::CommentIter::from_syntax_node(assoc_item_list.syntax())) }, ast::Module(it) => { let item_list = it.item_list()?; (item_list.attrs(), ast::CommentIter::from_syntax_node(item_list.syntax())) }, // FIXME: BlockExpr's only accept inner attributes in specific cases // Excerpt from the reference: // Block expressions accept outer and inner attributes, but only when they are the outer // expression of an expression statement or the final expression of another block expression. ast::BlockExpr(_it) => return None, _ => return None, } }; let attrs = attrs.filter(|attr| attr.kind().is_inner()); let docs = docs.filter(|doc| doc.is_inner()); Some((attrs, docs)) } pub struct AttrSourceMap { attrs: Vec>, doc_comments: Vec>, } impl AttrSourceMap { fn new(owner: InFile<&dyn ast::AttrsOwner>) -> Self { let mut attrs = Vec::new(); let mut doc_comments = Vec::new(); for (_, attr) in collect_attrs(owner.value) { match attr { Either::Left(attr) => attrs.push(owner.with_value(attr)), Either::Right(comment) => doc_comments.push(owner.with_value(comment)), } } Self { attrs, doc_comments } } fn merge(&mut self, other: Self) { self.attrs.extend(other.attrs); self.doc_comments.extend(other.doc_comments); } /// Maps the lowered `Attr` back to its original syntax node. /// /// `attr` must come from the `owner` used for AttrSourceMap /// /// Note that the returned syntax node might be a `#[cfg_attr]`, or a doc comment, instead of /// the attribute represented by `Attr`. pub fn source_of(&self, attr: &Attr) -> InFile> { self.source_of_id(attr.id) } fn source_of_id(&self, id: AttrId) -> InFile> { if id.is_doc_comment { self.doc_comments .get(id.ast_index as usize) .unwrap_or_else(|| panic!("cannot find doc comment at index {:?}", id)) .clone() .map(Either::Right) } else { self.attrs .get(id.ast_index as usize) .unwrap_or_else(|| panic!("cannot find `Attr` at index {:?}", id)) .clone() .map(Either::Left) } } } /// A struct to map text ranges from [`Documentation`] back to TextRanges in the syntax tree. pub struct DocsRangeMap { source_map: AttrSourceMap, // (docstring-line-range, attr_index, attr-string-range) // a mapping from the text range of a line of the [`Documentation`] to the attribute index and // the original (untrimmed) syntax doc line mapping: Vec<(TextRange, AttrId, TextRange)>, } impl DocsRangeMap { pub fn map(&self, range: TextRange) -> Option> { let found = self.mapping.binary_search_by(|(probe, ..)| probe.ordering(range)).ok()?; let (line_docs_range, idx, original_line_src_range) = self.mapping[found]; if !line_docs_range.contains_range(range) { return None; } let relative_range = range - line_docs_range.start(); let &InFile { file_id, value: ref source } = &self.source_map.source_of_id(idx); match source { Either::Left(_) => None, // FIXME, figure out a nice way to handle doc attributes here // as well as for whats done in syntax highlight doc injection Either::Right(comment) => { let text_range = comment.syntax().text_range(); let range = TextRange::at( text_range.start() + TextSize::try_from(comment.prefix().len()).ok()? + original_line_src_range.start() + relative_range.start(), text_range.len().min(range.len()), ); Some(InFile { file_id, value: range }) } } } } #[derive(Debug, Clone, Copy, PartialEq, Eq, Hash)] pub(crate) struct AttrId { is_doc_comment: bool, pub(crate) ast_index: u32, } #[derive(Debug, Clone, PartialEq, Eq)] pub struct Attr { pub(crate) id: AttrId, pub(crate) path: Interned, pub(crate) input: Option>, } #[derive(Debug, Clone, PartialEq, Eq, Hash)] pub enum AttrInput { /// `#[attr = "string"]` Literal(SmolStr), /// `#[attr(subtree)]` TokenTree(Subtree), } impl fmt::Display for AttrInput { fn fmt(&self, f: &mut fmt::Formatter<'_>) -> fmt::Result { match self { AttrInput::Literal(lit) => write!(f, " = \"{}\"", lit.escape_debug()), AttrInput::TokenTree(subtree) => subtree.fmt(f), } } } impl Attr { fn from_src( db: &dyn DefDatabase, ast: ast::Meta, hygiene: &Hygiene, id: AttrId, ) -> Option { let path = Interned::new(ModPath::from_src(db, ast.path()?, hygiene)?); let input = if let Some(ast::Expr::Literal(lit)) = ast.expr() { let value = match lit.kind() { ast::LiteralKind::String(string) => string.value()?.into(), _ => lit.syntax().first_token()?.text().trim_matches('"').into(), }; Some(Interned::new(AttrInput::Literal(value))) } else if let Some(tt) = ast.token_tree() { Some(Interned::new(AttrInput::TokenTree(ast_to_token_tree(&tt).0))) } else { None }; Some(Attr { id, path, input }) } fn from_tt( db: &dyn DefDatabase, tt: &tt::Subtree, hygiene: &Hygiene, id: AttrId, ) -> Option { let (parse, _) = mbe::token_tree_to_syntax_node(tt, hir_expand::FragmentKind::MetaItem).ok()?; let ast = ast::Meta::cast(parse.syntax_node())?; Self::from_src(db, ast, hygiene, id) } /// Parses this attribute as a `#[derive]`, returns an iterator that yields all contained paths /// to derive macros. /// /// Returns `None` when the attribute is not a well-formed `#[derive]` attribute. pub(crate) fn parse_derive(&self) -> Option> { if self.path.as_ident() != Some(&hir_expand::name![derive]) { return None; } match self.input.as_deref() { Some(AttrInput::TokenTree(args)) => { let mut counter = 0; let paths = args .token_trees .iter() .group_by(move |tt| { match tt { tt::TokenTree::Leaf(tt::Leaf::Punct(p)) if p.char == ',' => { counter += 1; } _ => {} } counter }) .into_iter() .map(|(_, tts)| { let segments = tts.filter_map(|tt| match tt { tt::TokenTree::Leaf(tt::Leaf::Ident(id)) => Some(id.as_name()), _ => None, }); ModPath::from_segments(PathKind::Plain, segments) }) .collect::>(); Some(paths.into_iter()) } _ => None, } } pub fn string_value(&self) -> Option<&SmolStr> { match self.input.as_deref()? { AttrInput::Literal(it) => Some(it), _ => None, } } } #[derive(Debug, Clone, Copy)] pub struct AttrQuery<'a> { attrs: &'a Attrs, key: &'static str, } impl<'a> AttrQuery<'a> { pub fn tt_values(self) -> impl Iterator { self.attrs().filter_map(|attr| match attr.input.as_deref()? { AttrInput::TokenTree(it) => Some(it), _ => None, }) } pub fn string_value(self) -> Option<&'a SmolStr> { self.attrs().find_map(|attr| match attr.input.as_deref()? { AttrInput::Literal(it) => Some(it), _ => None, }) } pub fn exists(self) -> bool { self.attrs().next().is_some() } pub fn attrs(self) -> impl Iterator + Clone { let key = self.key; self.attrs .iter() .filter(move |attr| attr.path.as_ident().map_or(false, |s| s.to_string() == key)) } } fn attrs_from_ast(src: AstId, db: &dyn DefDatabase) -> RawAttrs where N: ast::AttrsOwner, { let src = InFile::new(src.file_id, src.to_node(db.upcast())); RawAttrs::from_attrs_owner(db, src.as_ref().map(|it| it as &dyn ast::AttrsOwner)) } fn attrs_from_item_tree(id: ItemTreeId, db: &dyn DefDatabase) -> RawAttrs { let tree = id.item_tree(db); let mod_item = N::id_to_mod_item(id.value); tree.raw_attrs(mod_item.into()).clone() } fn collect_attrs( owner: &dyn ast::AttrsOwner, ) -> impl Iterator)> { let (inner_attrs, inner_docs) = inner_attributes(owner.syntax()) .map_or((None, None), |(attrs, docs)| (Some(attrs), Some(docs))); let outer_attrs = owner.attrs().filter(|attr| attr.kind().is_outer()); let attrs = outer_attrs.chain(inner_attrs.into_iter().flatten()).enumerate().map(|(idx, attr)| { ( AttrId { ast_index: idx as u32, is_doc_comment: false }, attr.syntax().text_range().start(), Either::Left(attr), ) }); let outer_docs = ast::CommentIter::from_syntax_node(owner.syntax()).filter(ast::Comment::is_outer); let docs = outer_docs.chain(inner_docs.into_iter().flatten()).enumerate().map(|(idx, docs_text)| { ( AttrId { ast_index: idx as u32, is_doc_comment: true }, docs_text.syntax().text_range().start(), Either::Right(docs_text), ) }); // sort here by syntax node offset because the source can have doc attributes and doc strings be interleaved docs.chain(attrs).sorted_by_key(|&(_, offset, _)| offset).map(|(id, _, attr)| (id, attr)) } pub(crate) fn variants_attrs_source_map( db: &dyn DefDatabase, def: EnumId, ) -> Arc>> { let mut res = ArenaMap::default(); let child_source = def.child_source(db); for (idx, variant) in child_source.value.iter() { res.insert(idx, AstPtr::new(variant)); } Arc::new(res) } pub(crate) fn fields_attrs_source_map( db: &dyn DefDatabase, def: VariantId, ) -> Arc, AstPtr>>> { let mut res = ArenaMap::default(); let child_source = def.child_source(db); for (idx, variant) in child_source.value.iter() { res.insert( idx, variant .as_ref() .either(|l| Either::Left(AstPtr::new(l)), |r| Either::Right(AstPtr::new(r))), ); } Arc::new(res) }