//! Various traits that are implemented by ast nodes. //! //! The implementations are usually trivial, and live in generated.rs use itertools::Itertools; 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: AstNode { fn doc_comments(&self) -> CommentIter { CommentIter { iter: self.syntax().children_with_tokens() } } fn doc_comment_text(&self) -> Option { self.doc_comments().doc_comment_text() } } impl CommentIter { pub fn from_syntax_node(syntax_node: &ast::SyntaxNode) -> CommentIter { CommentIter { iter: syntax_node.children_with_tokens() } } /// Returns the textual content of a doc comment block as a single string. /// That is, strips leading `///` (+ optional 1 character of whitespace), /// trailing `*/`, trailing whitespace and then joins the lines. pub fn doc_comment_text(self) -> Option { let docs = self.filter_map(|comment| comment.doc_comment().map(ToOwned::to_owned)).join("\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)) } }