links-notation 0.20.0

Rust implementation of the Links Notation parser
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33

//! Line comments: `#` hides the rest of its line, unless it sits inside a token
//! or inside a delimited reference. Parsers accept comments by default and can
//! be told to treat `#` as an ordinary character again.
//!
//! Run with `cargo run --example comments`.

use links_notation::{parse_lino, parse_lino_with_config, ParserConfig};

fn main() {
    let documents = [
        "# a note about the document\ndeploy: staging\n",
        "deploy: staging # only staging, for now\n",
        "issue#1047: open\n",
        "\"# not a comment\": still a reference\n",
        "parent\n  # what the child is for\n  child\n",
    ];

    for document in documents {
        match parse_lino(document) {
            Ok(links) => println!("{document:?}\n  parses as {links}"),
            Err(error) => println!("{document:?}\n  {error}"),
        }
    }

    // Documents that predate comments can be read with `#` as an ordinary
    // character.
    let config = ParserConfig::without_comments();
    let document = "# a b\n";
    match parse_lino_with_config(document, &config) {
        Ok(links) => println!("\nwithout comments {document:?}\n  parses as {links}"),
        Err(error) => println!("\nwithout comments {document:?}\n  {error}"),
    }
}