fulgur 0.3.0

HTML/CSS to PDF conversion 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

use super::{ContentItem, CounterType};

/// Resolve content items to a plain string.
///
/// `Element` references are skipped in plain string mode.
pub fn resolve_content_to_string(items: &[ContentItem], page: usize, total_pages: usize) -> String {
    let mut out = String::new();
    for item in items {
        match item {
            ContentItem::String(s) => out.push_str(s),
            ContentItem::Counter(CounterType::Page) => {
                out.push_str(&page.to_string());
            }
            ContentItem::Counter(CounterType::Pages) => {
                out.push_str(&total_pages.to_string());
            }
            ContentItem::Element(_) => {}
        }
    }
    out
}

/// Resolve content items to an HTML string.
///
/// `Element(name)` references are looked up in `running_elements` (a `&[(name, html)]` slice)
/// and the matching HTML is appended.
pub fn resolve_content_to_html(
    items: &[ContentItem],
    running_elements: &[(String, String)],
    page: usize,
    total_pages: usize,
) -> String {
    let mut out = String::new();
    for item in items {
        match item {
            ContentItem::String(s) => out.push_str(s),
            ContentItem::Counter(CounterType::Page) => {
                out.push_str(&page.to_string());
            }
            ContentItem::Counter(CounterType::Pages) => {
                out.push_str(&total_pages.to_string());
            }
            ContentItem::Element(name) => {
                if let Some((_, html)) = running_elements.iter().find(|(n, _)| n == name) {
                    out.push_str(html);
                }
            }
        }
    }
    out
}

#[cfg(test)]
mod tests {
    use super::*;

    #[test]
    fn test_resolve_counters() {
        let items = vec![
            ContentItem::String("Page ".into()),
            ContentItem::Counter(CounterType::Page),
            ContentItem::String(" of ".into()),
            ContentItem::Counter(CounterType::Pages),
        ];
        assert_eq!(resolve_content_to_string(&items, 3, 10), "Page 3 of 10");
    }

    #[test]
    fn test_element_becomes_empty() {
        let items = vec![
            ContentItem::String("Before".into()),
            ContentItem::Element("hdr".into()),
            ContentItem::String("After".into()),
        ];
        assert_eq!(resolve_content_to_string(&items, 1, 5), "BeforeAfter");
    }

    #[test]
    fn test_resolve_html_with_running_element() {
        let items = vec![ContentItem::Element("hdr".into())];
        let running = vec![("hdr".to_string(), "<b>Header</b>".to_string())];
        assert_eq!(
            resolve_content_to_html(&items, &running, 1, 1),
            "<b>Header</b>"
        );
    }

    #[test]
    fn test_resolve_html_mixed() {
        let items = vec![
            ContentItem::Element("hdr".into()),
            ContentItem::String(" - Page ".into()),
            ContentItem::Counter(CounterType::Page),
            ContentItem::String("/".into()),
            ContentItem::Counter(CounterType::Pages),
        ];
        let running = vec![("hdr".to_string(), "<span>Title</span>".to_string())];
        assert_eq!(
            resolve_content_to_html(&items, &running, 2, 8),
            "<span>Title</span> - Page 2/8"
        );
    }
}