ical-rs 0.5.1

iCalendar parser, validator, editor, merger and builder library
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

//! # Binary value
//!
//! The decoded binary value kind.
//!
//! Backs the binary-bearing properties (`ATTACH`, `IMAGE`, `STRUCTURED-DATA`)
//! where the value is inline base64 rather than an external URI reference
//! (the BINARY value, RFC 5545 3.3.1, carried with `ENCODING=BASE64`).
//!
//! A property referencing an external URI decodes to
//! [`IcalUri`](crate::value::uri::IcalUri) instead. The form is told by the
//! line's `VALUE` / `ENCODING` parameters, and the payload is kept verbatim
//! (base64 is not decoded to bytes).

use alloc::borrow::Cow;
#[cfg(feature = "base64")]
use alloc::vec::Vec;

/// A decoded binary value: an external URI reference, or inline base64 kept as
/// its raw text.
#[derive(Clone, Debug, PartialEq, Eq)]
pub enum IcalBinary<'a> {
    /// An external URI reference.
    Uri(Cow<'a, str>),
    /// Inline base64 data, kept verbatim (not decoded to bytes).
    Base64(Cow<'a, str>),
}

#[cfg(feature = "base64")]
impl IcalBinary<'_> {
    /// Decode the inline [`Base64`](Self::Base64) payload to raw bytes; `None`
    /// for a [`Uri`](Self::Uri) reference, which embeds no data. Requires the
    /// `base64` feature.
    pub fn decode_base64(&self) -> Option<Result<Vec<u8>, base64::DecodeError>> {
        use base64::prelude::{BASE64_STANDARD, Engine};

        match self {
            IcalBinary::Base64(data) => Some(BASE64_STANDARD.decode(data.as_bytes())),
            IcalBinary::Uri(_) => None,
        }
    }
}

#[cfg(all(test, feature = "base64"))]
mod tests {
    use alloc::borrow::Cow;

    use crate::value::binary::IcalBinary;

    #[test]
    fn decodes_inline_base64_but_not_a_uri() {
        let inline = IcalBinary::Base64(Cow::Borrowed("Zm9v"));
        assert_eq!(inline.decode_base64().unwrap().unwrap(), b"foo");

        let reference = IcalBinary::Uri(Cow::Borrowed("http://example.com/p.png"));
        assert!(reference.decode_base64().is_none());
    }
}