harper 0.0.1

A library to implement SSGs.
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
126

use pulldown_cmark::{Event, Tag, HeadingLevel};

use crate::markdown::Plugin;

pub type LunrIndex = elasticlunr::Index;

#[derive(Default, Debug)]
pub struct LunrIndexer {
    pub docs: Vec<LunrDocument>,
}

struct Heading {
    level: HeadingLevel,
    name: String,
}

#[derive(Debug)]
pub struct LunrDocument {
    id: String,
    title: String,
    breadcrumb: String,
    body: String,
}

#[derive(Copy, Clone, PartialEq)]
enum State {
    InHeading,
    InBody,
}

struct IndexerIterator<'a, I: Iterator<Item = Event<'a>>> {
    breadcrumb_stack: Vec<Heading>,
    docs: &'a mut Vec<LunrDocument>,
    state: State,
    inner: I,
}

impl<'a, I: Iterator<Item = Event<'a>>> IndexerIterator<'a, I> {
    fn breadcrumb_string(&self) -> String {
        let mut string = String::new();
        let mut headings = self.breadcrumb_stack.iter();
        if let Some(heading) = headings.next() {
            string.push_str(&heading.name);
        }

        for heading in headings {
            string.push_str(" > ");
            string.push_str(&heading.name);
        }

        string
    }
}

impl<'a, I: Iterator<Item = Event<'a>>> Iterator for IndexerIterator<'a, I> {
    type Item = Event<'a>;

    fn next(&mut self) -> Option<Self::Item> {
        // TODO: Check if we have a doc here before sending `None`.
        let event = self.inner.next()?;
        match event {
            Event::Start(Tag::Heading(level, Some(ref id), _)) => {
                while self.breadcrumb_stack.last().map_or(false, |h| h.level >= level) {
                    self.breadcrumb_stack.pop();
                }

                self.state = State::InHeading;
                self.docs.push(LunrDocument {
                    id: id.to_string(),
                    title: String::new(),
                    breadcrumb: String::new(),
                    body: String::new()
                })
            }
            Event::Text(ref s) | Event::Code(ref s) if self.state == State::InHeading => {
                if let Some(doc) = self.docs.last_mut() {
                    doc.title.push_str(s);
                }
            },
            Event::Text(ref s) | Event::Code(ref s) => {
                if let Some(doc) = self.docs.last_mut() {
                    doc.body.push_str(s);
                }
            },
            Event::End(Tag::Heading(level, Some(_), _)) => {
                self.state = State::InBody;
                if let Some(doc) = self.docs.last_mut() {
                    self.breadcrumb_stack.push(Heading { level, name: doc.title.clone() });
                }

                let breadcrumb_string = self.breadcrumb_string();
                if let Some(doc) = self.docs.last_mut() {
                    doc.breadcrumb = breadcrumb_string;
                }
            },
            _ => { /* skip */ }
        }

        Some(event)
    }
}

impl Plugin for &mut LunrIndexer {
    fn remap<'a, I>(&'a mut self, events: I) -> Box<dyn Iterator<Item = Event<'a>> + 'a>
        where I: Iterator<Item = Event<'a>> + 'a
    {
        Box::new(IndexerIterator {
            breadcrumb_stack: vec![],
            docs: &mut self.docs,
            state: State::InBody,
            inner: events,
        })
    }
}

impl LunrDocument {
    pub const FIELDS: [&str; 3] = ["title", "breadcrumb", "body"];

    pub fn id(&self) -> &str {
        &self.id
    }

    pub fn fields(&self) -> [&str; 3] {
        [&self.title, &self.breadcrumb, &self.body]
    }
}