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
88
89
90
91
92
93
94
95
96

use serde::{Deserialize, Serialize};

use crate::{WritingsTrait, author::Author};

/// A single paragraph from <a href="https://www.bahai.org/library/authoritative-texts/prayers/bahai-prayers/" target="_blank">_Gleanings from the Writings of Bahá’u’lláh_</a>
#[derive(Debug, Clone, PartialEq, Eq, Serialize, Deserialize)]
#[serde(rename_all = "camelCase")]
#[cfg_attr(feature = "poem", derive(poem_openapi::Object))]
#[cfg_attr(
    feature = "utoipa",
    derive(utoipa::ToSchema),
    schema(
        example = json!(GleaningsParagraph {
            number: 2,
            roman: "II".to_string(),
            paragraph: 1,
            ref_id: "958506325".to_string(),
            text: "The beginning of all things is the knowledge of God, and the end of all things is strict observance of whatsoever hath been sent down from the empyrean of the Divine Will that pervadeth all that is in the heavens and all that is on the earth.".to_string(),
        }),
    ),
)]
pub struct GleaningsParagraph {
    /// The reference ID from the official Bahá'í Reference Library:
    /// <https://www.bahai.org/r/`ref_id`>
    pub ref_id: String,

    /// The Gleaning number in decimal format.
    pub number: u32,

    /// The Gleaning number in Roman Numeral format.
    pub roman: String,

    /// The number of the paragraph within the Gleaning, starting at 1.
    pub paragraph: u32,

    /// The actual Text of this paragraph of the Gleaning.
    pub text: String,
}

impl WritingsTrait for GleaningsParagraph {
    fn ref_id(&self) -> String {
        self.ref_id.clone()
    }

    fn title(&self) -> String {
        "Gleanings from the Writings of Bahá'u'lláh".to_string()
    }

    fn subtitle(&self) -> Option<String> {
        None
    }

    fn author(&self) -> crate::author::Author {
        Author::Bahaullah
    }

    fn number(&self) -> Option<u32> {
        Some(self.number)
    }

    fn paragraph(&self) -> u32 {
        self.paragraph
    }

    fn text(&self) -> String {
        self.text.clone()
    }
}

impl GleaningsParagraph {
    pub fn roman(&self) -> String {
        crate::roman::to(self.number).unwrap_or_else(|| {
            panic!("invalid Gleaning number -> Roman Numeral invalid: {self:#?} -- this error should never occur")
        })
    }
}

#[cfg(feature = "indicium")]
impl indicium::simple::Indexable for GleaningsParagraph {
    fn strings(&self) -> Vec<String> {
        [
            self.ref_id.as_str(),
            self.roman.as_str(),
            &diacritics::remove_diacritics(&self.text),
        ]
        .iter()
        .filter_map(|s| {
            if s.is_empty() {
                None
            } else {
                Some(s.to_string())
            }
        })
        .collect()
    }
}