ics-core 0.0.0

Typed iCalendar (RFC 5545) model with vendor-extension support — shared core for makeholiday and future consumers. Placeholder version; first real release planned at v0.2.0.
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

use crate::profile::{google, icloud, microsoft};
use crate::raw::{RawComponent, RawProperty};
use chrono::{NaiveDate, NaiveDateTime};
use serde::Serialize;

#[derive(Debug, Clone, Copy, PartialEq, Serialize)]
#[serde(rename_all = "lowercase")]
pub enum EventClass {
    Public,
    Private,
    Confidential,
}

impl EventClass {
    pub fn ics_value(self) -> &'static str {
        match self {
            EventClass::Public => "PUBLIC",
            EventClass::Private => "PRIVATE",
            EventClass::Confidential => "CONFIDENTIAL",
        }
    }

    pub fn from_ics(s: &str) -> Option<Self> {
        match s {
            "PUBLIC" => Some(EventClass::Public),
            "PRIVATE" => Some(EventClass::Private),
            "CONFIDENTIAL" => Some(EventClass::Confidential),
            _ => None,
        }
    }
}

/// RFC 5545 §3.8.2.7 `TRANSP` — time-transparency for free/busy lookups.
#[derive(Debug, Clone, Copy, PartialEq, Eq, Serialize)]
#[serde(rename_all = "lowercase")]
pub enum Transp {
    Transparent,
    Opaque,
}

impl Transp {
    pub fn ics_value(self) -> &'static str {
        match self {
            Transp::Transparent => "TRANSPARENT",
            Transp::Opaque => "OPAQUE",
        }
    }

    pub fn from_ics(s: &str) -> Option<Self> {
        match s {
            "TRANSPARENT" => Some(Transp::Transparent),
            "OPAQUE" => Some(Transp::Opaque),
            _ => None,
        }
    }
}

#[derive(Debug, Clone, PartialEq, Serialize)]
pub struct VEvent {
    pub uid: String,
    #[serde(serialize_with = "serialize_dtstamp")]
    pub dtstamp: NaiveDateTime,
    #[serde(serialize_with = "serialize_date")]
    pub dtstart: NaiveDate,
    #[serde(serialize_with = "serialize_date")]
    pub dtend: NaiveDate,
    pub summary: String,
    /// RFC 5545 `TRANSP`.
    #[serde(skip_serializing_if = "Option::is_none")]
    pub transp: Option<Transp>,
    #[serde(skip_serializing_if = "Option::is_none")]
    pub class: Option<EventClass>,
    #[serde(skip_serializing_if = "Vec::is_empty")]
    pub categories: Vec<String>,

    /// Microsoft / Outlook event extension bundle. `X-MICROSOFT-CDO-BUSYSTATUS`
    /// lives in `microsoft.busystatus` after ADR-001 Migration Step 4.
    #[serde(skip_serializing_if = "Option::is_none")]
    pub microsoft: Option<microsoft::EventExtensions>,

    /// Google calendar event extension bundle. Step 7 skeleton: no typed
    /// fields yet; all matched properties land in `google.unrecognized`.
    #[serde(skip_serializing_if = "Option::is_none")]
    pub google: Option<google::EventExtensions>,

    /// Apple / iCloud event extension bundle. Step 7 skeleton: no typed
    /// fields yet; all matched properties land in `icloud.unrecognized`.
    #[serde(skip_serializing_if = "Option::is_none")]
    pub icloud: Option<icloud::EventExtensions>,

    /// Properties matching no registered vendor prefix (ADR-001 rule 4).
    #[serde(skip_serializing_if = "Vec::is_empty")]
    pub unknown: Vec<RawProperty>,

    /// Nested components the typed model does not understand (e.g.
    /// `VALARM`). Preserved verbatim for ADR-001 / ADR-018 round-trip.
    #[serde(skip_serializing_if = "Vec::is_empty")]
    pub unrecognized_components: Vec<RawComponent>,
}

fn serialize_date<S: serde::Serializer>(date: &NaiveDate, s: S) -> Result<S::Ok, S::Error> {
    s.serialize_str(&date.format("%Y-%m-%d").to_string())
}

fn serialize_dtstamp<S: serde::Serializer>(dt: &NaiveDateTime, s: S) -> Result<S::Ok, S::Error> {
    s.serialize_str(&dt.format("%Y-%m-%dT%H:%M:%SZ").to_string())
}