markdown-ppp 2.12.0

Feature-rich Markdown Parsing and Pretty-Printing library
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
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125

use crate::ast::*;
use crate::parser::{parse_markdown, MarkdownParserState};

#[test]
fn image1() {
    let doc = parse_markdown(MarkdownParserState::default(), "![foo](/url \"title\")").unwrap();
    assert_eq!(
        doc,
        Document {
            blocks: vec![Block::Paragraph(vec![Inline::Image(Image {
                destination: "/url".to_owned(),
                title: Some("title".to_owned()),
                alt: "foo".to_owned(),
            })])]
        }
    );
}

#[test]
fn image2() {
    let doc = parse_markdown(MarkdownParserState::default(), "![foo](train.jpg)").unwrap();
    assert_eq!(
        doc,
        Document {
            blocks: vec![Block::Paragraph(vec![Inline::Image(Image {
                destination: "train.jpg".to_owned(),
                title: None,
                alt: "foo".to_owned(),
            })])]
        }
    );
}

#[test]
fn image3() {
    let doc = parse_markdown(MarkdownParserState::default(), "![foo](<url>)").unwrap();
    assert_eq!(
        doc,
        Document {
            blocks: vec![Block::Paragraph(vec![Inline::Image(Image {
                destination: "url".to_owned(),
                title: None,
                alt: "foo".to_owned(),
            })])]
        }
    );
}

/// Backslash escapes in the description are resolved, per CommonMark §6.4.
#[test]
fn image_alt_escapes_are_resolved() {
    let doc = parse_markdown(MarkdownParserState::default(), r"![Face N \(TD+\)](u.jpg)").unwrap();
    assert_eq!(
        doc,
        Document {
            blocks: vec![Block::Paragraph(vec![Inline::Image(Image {
                destination: "u.jpg".to_owned(),
                title: None,
                alt: "Face N (TD+)".to_owned(),
            })])]
        }
    );
}

/// An escaped `]` belongs to the description and must not end it, so a consumer that
/// escapes user text before splicing it into `![...]` keeps the image intact.
#[test]
fn image_alt_escaped_close_bracket() {
    let doc = parse_markdown(MarkdownParserState::default(), r"![a\](x)](u.jpg)").unwrap();
    assert_eq!(
        doc,
        Document {
            blocks: vec![Block::Paragraph(vec![Inline::Image(Image {
                destination: "u.jpg".to_owned(),
                title: None,
                alt: "a](x)".to_owned(),
            })])]
        }
    );
}

/// Only ASCII punctuation is escapable; `\n` stays two literal characters.
#[test]
fn image_alt_keeps_non_punctuation_escape() {
    let doc = parse_markdown(MarkdownParserState::default(), r"![a\nb](u.jpg)").unwrap();
    assert_eq!(
        doc,
        Document {
            blocks: vec![Block::Paragraph(vec![Inline::Image(Image {
                destination: "u.jpg".to_owned(),
                title: None,
                alt: r"a\nb".to_owned(),
            })])]
        }
    );
}

/// The scanner used when the input is not covered by an `InlineIndex` has to agree
/// with the index on where the description ends.
#[test]
fn image_alt_scanner_skips_escaped_brackets() {
    use crate::parser::inline::image::unescaped_close_bracket;

    assert_eq!(unescaped_close_bracket("a]b]"), Some(1));
    assert_eq!(unescaped_close_bracket(r"a\](x)]"), Some(6));
    assert_eq!(unescaped_close_bracket(r"a\\](x)"), Some(3));
    assert_eq!(unescaped_close_bracket("no bracket"), None);
    assert_eq!(unescaped_close_bracket(r"trailing\"), None);
    assert_eq!(unescaped_close_bracket(r"ä\]ö]"), Some(6));
}

#[test]
fn image4() {
    let doc = parse_markdown(MarkdownParserState::default(), "![](train.jpg)").unwrap();
    assert_eq!(
        doc,
        Document {
            blocks: vec![Block::Paragraph(vec![Inline::Image(Image {
                destination: "train.jpg".to_owned(),
                title: None,
                alt: "".to_owned(),
            })])]
        }
    );
}