writings 0.1.0

The Bahá’í Sacred Writings for use in Rust projects and APIs
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

#![cfg(feature = "_visitors")]

use std::sync::LazyLock;

use crate::{
    scraper_ext::{ClassList, ElementExt},
    writings_visitor::{VisitorAction, WritingsVisitor},
};

use super::MeditationParagraph;

#[derive(Debug, Default)]
pub struct MeditationsVisitor {
    number: u32,
    paragraph: u32,
    seen_first: bool,
    meditation_text: Vec<MeditationParagraph>,
}

static FOOTER_CLASS: LazyLock<ClassList> = LazyLock::new(|| "wf".parse().unwrap());
static ROMAN_NUMBER_CLASS: LazyLock<ClassList> = LazyLock::new(|| "c q".parse().unwrap());

impl WritingsVisitor for MeditationsVisitor {
    type Writings = MeditationParagraph;

    const URL: &str = "https://www.bahai.org/library/authoritative-texts/bahaullah/prayers-meditations/prayers-meditations.xhtml";
    const EXPECTED_COUNT: usize = 877;

    fn get_visited(&self) -> &[Self::Writings] {
        &self.meditation_text
    }

    fn visit(&mut self, element: &scraper::ElementRef, _level: usize) -> VisitorAction {
        if element.class_list() == *ROMAN_NUMBER_CLASS {
            self.seen_first = true;
            self.number += 1;
            self.paragraph = 0;
            assert_eq!(
                element
                    .trimmed_text(0, true)
                    .chars()
                    .filter(char::is_ascii_uppercase)
                    .collect::<String>(),
                crate::roman::to(self.number).unwrap()
            );
            return VisitorAction::SkipChildren;
        }

        if !self.seen_first {
            return VisitorAction::VisitChildren;
        }

        // Skip footer
        if element.class_list() == *FOOTER_CLASS {
            return VisitorAction::Stop;
        }

        if element.name() != "p" {
            return VisitorAction::VisitChildren;
        }

        self.paragraph += 1;
        let text = element.trimmed_text(4, true);
        let ref_id = self.get_ref_id(element);
        let paragraph = MeditationParagraph {
            number: self.number,
            roman: crate::roman::to(self.number).unwrap(),
            paragraph: self.paragraph,
            text,
            ref_id,
        };
        self.meditation_text.push(paragraph);

        VisitorAction::VisitChildren
    }
}

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

    #[tokio::test]
    async fn test_meditations_visitor() {
        test_visitor::<MeditationsVisitor>().await;
    }
}