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

//! Microsoft / Outlook profile bundle (`X-MICROSOFT-CDO-*`, `X-MICROSOFT-*`).
//!
//! Houses the typed `MsBusyStatus` (RFC `TRANSP` has 2 values; Microsoft's
//! busy state has 5 — they are not interchangeable, which is why this
//! sits in a vendor bundle, not on `VEvent` directly).

use serde::Serialize;

use crate::raw::RawProperty;

/// Property name prefixes owned by this profile. Longest match wins per
/// ADR-001 rule 3.
pub const PREFIXES: &[&str] = &["X-MICROSOFT-CDO-", "X-MICROSOFT-"];

/// True if `name` starts with any of this profile's registered prefixes.
pub fn owns_property(name: &str) -> bool {
    super::matches_prefixes(name, PREFIXES)
}

/// Microsoft's `X-MICROSOFT-CDO-BUSYSTATUS` value space.
#[derive(Debug, Clone, Copy, PartialEq, Eq, Serialize)]
#[serde(rename_all = "lowercase")]
pub enum MsBusyStatus {
    Free,
    Tentative,
    Busy,
    Oof,
    #[serde(rename = "working")]
    WorkingElsewhere,
}

impl MsBusyStatus {
    /// Derive the matching RFC 5545 `TRANSP` value. Used as a fallback
    /// by the formatter when `VEvent.transp` is `None`.
    pub fn transp(self) -> &'static str {
        match self {
            MsBusyStatus::Free => "TRANSPARENT",
            _ => "OPAQUE",
        }
    }

    pub fn cdo_value(self) -> &'static str {
        match self {
            MsBusyStatus::Free => "FREE",
            MsBusyStatus::Tentative => "TENTATIVE",
            MsBusyStatus::Busy => "BUSY",
            MsBusyStatus::Oof => "OOF",
            MsBusyStatus::WorkingElsewhere => "WORKINGELSEWHERE",
        }
    }

    pub fn from_cdo(s: &str) -> Option<Self> {
        match s {
            "FREE" => Some(MsBusyStatus::Free),
            "TENTATIVE" => Some(MsBusyStatus::Tentative),
            "BUSY" => Some(MsBusyStatus::Busy),
            "OOF" => Some(MsBusyStatus::Oof),
            "WORKINGELSEWHERE" => Some(MsBusyStatus::WorkingElsewhere),
            _ => None,
        }
    }
}

/// Microsoft event-level extension bundle (ADR-001 Option B).
///
/// `unrecognized` holds `X-MICROSOFT-*` properties whose specific name is
/// not yet typed. Promoting one of them into a typed field (in a future
/// step) is intra-bundle and never changes the `VEvent.unknown` slot.
#[derive(Debug, Clone, PartialEq, Eq, Default, Serialize)]
pub struct EventExtensions {
    #[serde(skip_serializing_if = "Option::is_none")]
    pub busystatus: Option<MsBusyStatus>,
    #[serde(skip_serializing_if = "Vec::is_empty")]
    pub unrecognized: Vec<RawProperty>,
}