rrule 0.14.0

A pure Rust implementation of recurrence rules as defined in the iCalendar RFC.
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

use crate::parser::{regex::get_property_name, ParseError};

use super::PropertyName;

#[derive(Debug, PartialEq, Clone)]
pub(crate) struct ContentLineCaptures<'a> {
    pub property_name: PropertyName,
    pub parameters: Option<&'a str>,
    pub value: &'a str,
}

impl<'a> ContentLineCaptures<'a> {
    pub(crate) fn new(line: &'a str) -> Result<Self, ParseError> {
        // Default property name to RRULE.
        let property_name = get_property_name(line)?.unwrap_or(PropertyName::RRule);
        match property_name {
            // If the line did not contain a property name (i.e. no ':'), then the
            // entire line is interpreted as the value
            PropertyName::RRule if !line.contains(':') => Ok(ContentLineCaptures {
                property_name: PropertyName::RRule,
                parameters: None,
                value: line,
            }),
            property_name => {
                let mut parameters = None;
                if line.starts_with(&format!("{};", property_name)) {
                    let only_colon_idx = line.find(':');
                    if let Some(only_colon_idx) = only_colon_idx {
                        parameters =
                            Some(&line[property_name.to_string().len() + 1..only_colon_idx]);
                    }
                }

                Ok(Self {
                    property_name,
                    parameters,
                    value: line
                        .split_once(':')
                        .map(|(_name, val)| val)
                        .unwrap_or_default(),
                })
            }
        }
    }
}

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

    #[test]
    fn parses_content_line_parts() {
        let tests = [
            (
                "DTSTART;TZID=America/Everywhere:20120251T023000Z",
                ContentLineCaptures {
                    property_name: PropertyName::DtStart,
                    parameters: Some("TZID=America/Everywhere"),
                    value: "20120251T023000Z",
                },
            ),
            (
                "DTSTART:20120251T023000Z",
                ContentLineCaptures {
                    property_name: PropertyName::DtStart,
                    parameters: None,
                    value: "20120251T023000Z",
                },
            ),
            (
                "DTSTART;TZID=America/Everywhere:20120251T023000Z",
                ContentLineCaptures {
                    property_name: PropertyName::DtStart,
                    parameters: Some("TZID=America/Everywhere"),
                    value: "20120251T023000Z",
                },
            ),
            (
                "RDATE:19970714T123000Z",
                ContentLineCaptures {
                    property_name: PropertyName::RDate,
                    parameters: None,
                    value: "19970714T123000Z",
                },
            ),
            (
                "RDATE;VALUE=DATE:19970101,19970120,19970217,19970421",
                ContentLineCaptures {
                    property_name: PropertyName::RDate,
                    parameters: Some("VALUE=DATE"),
                    value: "19970101,19970120,19970217,19970421",
                },
            ),
            (
                "RRULE:FREQ=DAILY;COUNT=10",
                ContentLineCaptures {
                    property_name: PropertyName::RRule,
                    parameters: None,
                    value: "FREQ=DAILY;COUNT=10",
                },
            ),
            (
                "FREQ=DAILY;COUNT=10",
                ContentLineCaptures {
                    // Defaults to RRULE
                    property_name: PropertyName::RRule,
                    parameters: None,
                    value: "FREQ=DAILY;COUNT=10",
                },
            ),
        ];
        for (input, expected_output) in tests {
            let output = ContentLineCaptures::new(input);
            assert_eq!(output, Ok(expected_output));
        }
    }
}