ical-rs 0.2.0

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

//! # Text value codec (RFC 5545 3.3.11)
//!
//! [`Codec`] for a single text value and a comma-separated text list.

use alloc::vec;

use crate::{
    tree::{
        codec::{
            Codec,
            encode::{encode_component, scalar_node},
            mode::Escaper,
        },
        value::node::IcalValueNode,
    },
    value::text::{IcalText, IcalTextList},
};

impl<'v> Codec<'v> for IcalText<'v> {
    fn decode(node: &'v IcalValueNode<'_>) -> Self {
        // NOTE: A single text value has no list to be separated into, so an
        // unescaped comma in one is data rather than a separator. RFC 5545
        // 3.3.11 says it should have been escaped; truncating the value at it
        // would be strictness applied to the wrong end of Postel's law.
        IcalText(node.decode_joined_at(0))
    }

    fn encode(&self, escaper: Escaper) -> IcalValueNode<'static> {
        scalar_node(&self.0, escaper)
    }
}

impl<'v> Codec<'v> for IcalTextList<'v> {
    fn decode(node: &'v IcalValueNode<'_>) -> Self {
        IcalTextList(node.decode_at(0))
    }

    fn encode(&self, escaper: Escaper) -> IcalValueNode<'static> {
        IcalValueNode::from_components(vec![encode_component(&self.0, escaper)], escaper)
    }
}