sp_vcard 0.2.0

Simple vCard library will help you generate vCard
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

use super::super::parameters::{PrefParam, TypeParam, ValueParam};
use crate::common::VCardValue;
use sp_vcard_derive::{vcard_property_type, CommonTypeParamMixin};

#[vcard_property_type("ADR")]
#[derive(CommonTypeParamMixin)]
pub struct Address {
    street: ValueParam,
    locality: ValueParam,
    region: ValueParam,
    code: ValueParam,
    country: ValueParam,
    type_param: TypeParam,
    pref_param: PrefParam,
}

impl Address {
    pub fn new() -> Self {
        Self {
            street: ValueParam::new(),
            locality: ValueParam::new(),
            region: ValueParam::new(),
            code: ValueParam::new(),
            country: ValueParam::new(),
            type_param: TypeParam::new(),
            pref_param: PrefParam::new(),
        }
    }

    /// #### Set Street
    /// e.g., 123 Main Street
    pub fn street(mut self, street: &str) -> Self {
        self.street.set(street);
        self
    }

    /// #### Set Locality
    /// e.g., city
    pub fn locality(mut self, locality: &str) -> Self {
        self.locality.set(locality);
        self
    }

    /// #### Set Locality
    /// e.g., state or province
    pub fn region(mut self, region: &str) -> Self {
        self.region.set(region);
        self
    }

    /// #### Set Postal code
    /// e.g., 91921-1234
    pub fn code(mut self, code: &str) -> Self {
        self.code.set(code);
        self
    }

    /// #### Set Country
    /// e.g., Vietnam, U.S.A
    pub fn country(mut self, country: &str) -> Self {
        self.country.set(country);
        self
    }

    pub fn set_prefer(mut self, preferred: u8) -> Self {
        self.pref_param.set(preferred).unwrap();
        self
    }

    /// First two components should be empty
    ///
    /// Ref: `https://datatracker.ietf.org/doc/html/rfc6350#section-6.3.1`
    fn format_adr(&self) -> String {
        format!(
            ";;{};{};{};{};{}",
            self.street, self.locality, self.region, self.code, self.country
        )
    }
}

impl VCardValue for Address {
    fn format_value(&self) -> String {
        let value = self.format_adr();
        if value.len() > 6 {
            format!(
                "{}{}{}:{}\n",
                Self::get_value_type(),
                self.pref_param,
                self.type_param,
                value
            )
        } else {
            "".into()
        }
    }
}