//! Various traits that are implemented by ast nodes. //! //! The implementations are usually trivial, and live in generated.rs use stdx::SepBy; use crate::{ ast::{self, support, AstChildren, AstNode, AstToken}, syntax_node::SyntaxElementChildren, SyntaxToken, T, }; pub trait TypeAscriptionOwner: AstNode { fn ascribed_type(&self) -> Option { support::child(self.syntax()) } } 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 TypeParamsOwner: AstNode { fn type_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 mut has_comments = false; let docs = self .filter(|comment| comment.kind().doc.is_some()) .map(|comment| { has_comments = true; let prefix_len = comment.prefix().len(); let line: &str = comment.text().as_str(); // Determine if the prefix or prefix + 1 char is stripped let pos = if let Some(ws) = line.chars().nth(prefix_len).filter(|c| c.is_whitespace()) { prefix_len + ws.len_utf8() } else { prefix_len }; let end = if comment.kind().shape.is_block() && line.ends_with("*/") { line.len() - 2 } else { line.len() }; // Note that we do not trim the end of the line here // since whitespace can have special meaning at the end // of a line in markdown. line[pos..end].to_owned() }) .sep_by("\n") .to_string(); if has_comments { Some(docs) } else { None } } } 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)) } } #[cfg(test)] mod tests { use comrak::{parse_document,format_commonmark, ComrakOptions, Arena}; use comrak::nodes::{AstNode, NodeValue}; fn iter_nodes<'a, F>(node: &'a AstNode<'a>, f: &F) where F : Fn(&'a AstNode<'a>) { f(node); for c in node.children() { iter_nodes(c, f); } } #[allow(non_snake_case)] #[test] fn test_link_rewrite() { let src = include_str!("./test.txt"); let arena = Arena::new(); let doc = parse_document(&arena, src, &ComrakOptions::default()); iter_nodes(doc, &|node| { match &mut node.data.borrow_mut().value { &mut NodeValue::Link(ref mut link) => { link.url = "https://www.google.com".as_bytes().to_vec(); }, _ => () } }); let mut out = Vec::new(); format_commonmark(doc, &ComrakOptions::default(), &mut out); panic!("{}", String::from_utf8(out).unwrap()); } }