#docs #parser #javadoc #tsdoc #jsdoc

doctor

Flexible low level parser for Javadoc-style doc comments: Javadoc, JSDoc, TSDoc, etc

9 releases

0.3.4 Jan 12, 2021
0.3.3 Jan 11, 2021
0.2.2 Jan 8, 2021
0.1.0 Jan 6, 2021

#1527 in Parser implementations

MIT license

42KB
969 lines

🩺 doctor

Fast and flexible low level parser for JavaDoc-style doc comments.

docs.rs

Example

use doctor::parse;
use doctor::ast::{DocComment, Description, BodyItem, BlockTag, InlineTag};

assert_eq!(
    parse(
        r#"/**
            * This is a doc comment.
            * It contains an {@inlineTag with some body} in its description.
            *
            * @blockTag1
            * @blockTag2 with body text
            * @blockTag3 with body text and {@inlineTag}
            */"#
    ),
    Ok(DocComment {
        description: Some(Description {
            body_items: vec![
                BodyItem::TextSegment("This is a doc comment.\n"),
                BodyItem::TextSegment("It contains an "),
                BodyItem::InlineTag(InlineTag {
                    name: "inlineTag",
                    body_lines: vec!["with some body"],
                }),
                BodyItem::TextSegment("in its description.\n"),
                BodyItem::TextSegment("\n"),
            ]
        }),
        block_tags: vec![
            BlockTag {
                name: "blockTag1",
                body_items: vec![]
            },
            BlockTag {
                name: "blockTag2",
                body_items: vec![BodyItem::TextSegment("with body text\n"),]
            },
            BlockTag {
                name: "blockTag3",
                body_items: vec![
                    BodyItem::TextSegment("with body text and "),
                    BodyItem::InlineTag(InlineTag {
                        name: "inlineTag",
                        body_lines: vec![]
                    }),
                    BodyItem::TextSegment("\n"),
                ]
            },
        ]
    })
);

For additional info check the documentation.

🔮 Design Goals

  • The crate is agnostic from the concrete set of valid tags so that more high-level parsers (JSDoc, TSDoc, etc.) can be built on top of it.
  • The parser tries to allocate as little memory as possible to ensure great performance, so the AST format is designed to use slices of the input data as much as possible.

👯‍ Contributing

Please check the contributing documentation

License: MIT

Dependencies

~2MB
~46K SLoC