//! Various traits that are implemented by ast nodes. //! //! The implementations are usually trivial, and live in generated.rs use crate::{ ast::{self, support, AstChildren, AstNode, AstToken}, syntax_node::SyntaxElementChildren, SyntaxToken, T, }; pub trait NameOwner: AstNode { fn name(&self) -> Option { support::child(self.syntax()) } } pub trait VisibilityOwner: AstNode { fn visibility(&self) -> Option { support::child(self.syntax()) } } pub trait LoopBodyOwner: AstNode { fn loop_body(&self) -> Option { support::child(self.syntax()) } fn label(&self) -> Option { support::child(self.syntax()) } } pub trait ArgListOwner: AstNode { fn arg_list(&self) -> Option { support::child(self.syntax()) } } pub trait ModuleItemOwner: AstNode { fn items(&self) -> AstChildren { support::children(self.syntax()) } } pub trait GenericParamsOwner: AstNode { fn generic_param_list(&self) -> Option { support::child(self.syntax()) } fn where_clause(&self) -> Option { support::child(self.syntax()) } } pub trait TypeBoundsOwner: AstNode { fn type_bound_list(&self) -> Option { support::child(self.syntax()) } fn colon_token(&self) -> Option { support::token(self.syntax(), T![:]) } } pub trait AttrsOwner: AstNode { fn attrs(&self) -> AstChildren { support::children(self.syntax()) } fn has_atom_attr(&self, atom: &str) -> bool { self.attrs().filter_map(|x| x.as_simple_atom()).any(|x| x == atom) } } pub trait DocCommentsOwner: AttrsOwner { fn doc_comments(&self) -> CommentIter { CommentIter { iter: self.syntax().children_with_tokens() } } } impl CommentIter { pub fn from_syntax_node(syntax_node: &ast::SyntaxNode) -> CommentIter { CommentIter { iter: syntax_node.children_with_tokens() } } #[cfg(test)] pub fn doc_comment_text(self) -> Option { let docs = itertools::Itertools::join( &mut self.filter_map(|comment| comment.doc_comment().map(ToOwned::to_owned)), "\n", ); if docs.is_empty() { None } else { Some(docs) } } } pub struct CommentIter { iter: SyntaxElementChildren, } impl Iterator for CommentIter { type Item = ast::Comment; fn next(&mut self) -> Option { self.iter.by_ref().find_map(|el| el.into_token().and_then(ast::Comment::cast)) } }