comment-parser

Crates.iocomment-parser
lib.rscomment-parser
version0.1.0
sourcesrc
created_at2020-02-18 18:04:08.785395
updated_at2020-02-18 18:04:08.785395
descriptionExtract comments from code in various programming languages
homepage
repositoryhttps://github.com/vallentin/comment-parser
max_upload_size
id210382
size32,183
Christian Vallentin (vallentin)

documentation

https://docs.rs/comment-parser

README

comment-parser

Build Status Latest Version Docs License

This crate implements a (pull) parser for extracting comments from code in various programming languages.

Usage

Add this to your Cargo.toml:

[dependencies]
comment-parser = "0.1"

Extract Comments from Rust Code

use comment_parser::CommentParser;

let rust = r#"
/* This is
the main
function */
fn main() {
    // println! is a macro
    println!("Hello World"); // Prints "Hello World"
}
"#;

let rules = comment_parser::get_syntax("rust").unwrap();

let parser = CommentParser::new(rust, rules);

for comment in parser {
    println!("{:?}", comment);
}

This will output the following:

BlockComment(_, " This is\nthe main\nfunction ")
LineComment(_, " println! is a macro")
LineComment(_, " Prints \"Hello World\"")

Extract Comments from Python Code

use comment_parser::CommentParser;

let python = r#"
# In Python main is not a function
if __name__ == "__main__":
    # print is a function
    print("Hello World")  # Prints "Hello World"
"#;

let rules = comment_parser::get_syntax("python").unwrap();

let parser = CommentParser::new(python, rules);

for comment in parser {
    println!("{:?}", comment);
}

This will output the following:

LineComment(_, " In Python main is not a function")
LineComment(_, " print is a function")
LineComment(_, " Prints \"Hello World\"")
Commit count: 16

cargo fmt