wot-td 0.6.2

Web of Things (WoT) Thing Description manipulation
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
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150

//! Human readable information and semantic tagging
//!
//! This module contains the logic shared across multiple builders for the respective
//! Thing Description Vocabulary definitions.

use alloc::{string::*, vec::Vec};

use super::MultiLanguageBuilder;

/// Human readable informations and semantic tagging
#[derive(Debug, Default, Clone, PartialEq, Eq)]
pub struct HumanReadableInfo {
    /// JSON-LD @type
    /// The meaning of each @type is given by the current JSON-LD @context.
    pub(super) attype: Option<Vec<String>>,
    /// Human readable title in the default language
    pub(super) title: Option<String>,
    /// Human redable title, multilanguage
    pub(super) titles: Option<MultiLanguageBuilder<String>>,
    /// Human readable description in the default language
    pub(super) description: Option<String>,
    /// Human readable description, multilanguage
    pub(super) descriptions: Option<MultiLanguageBuilder<String>>,
}

/// Trait shared across builders dealing with the same information
pub trait BuildableHumanReadableInfo {
    /// Set JSON-LD @type
    ///
    /// It can be called as many times as needed to add multiple @types.
    fn attype(self, value: impl Into<String>) -> Self;

    /// Set the title
    ///
    /// Calling it multiple times overwrites the field.
    fn title(self, value: impl Into<String>) -> Self;

    /// Set the translations of the title
    ///
    /// Calling it multiple times overwrites the field.
    ///
    /// See [`ThingBuilder::titles`] for examples.
    ///
    /// [`ThingBuilder::titles`]: crate::builder::ThingBuilder::titles
    fn titles<F>(self, f: F) -> Self
    where
        F: FnOnce(&mut MultiLanguageBuilder<String>) -> &mut MultiLanguageBuilder<String>;

    /// Set the description
    ///
    /// Calling it multiple times overwrites the field.
    fn description(self, value: impl Into<String>) -> Self;

    /// Set the translations of the description
    ///
    /// Calling it multiple times overwrites the field.
    ///
    /// See [`ThingBuilder::titles`] for examples.
    ///
    /// [`ThingBuilder::titles`]: crate::builder::ThingBuilder::titles
    fn descriptions<F>(self, f: F) -> Self
    where
        F: FnOnce(&mut MultiLanguageBuilder<String>) -> &mut MultiLanguageBuilder<String>;
}

impl BuildableHumanReadableInfo for HumanReadableInfo {
    fn attype(mut self, value: impl Into<String>) -> Self {
        self.attype
            .get_or_insert_with(Default::default)
            .push(value.into());
        self
    }

    fn title(mut self, value: impl Into<String>) -> Self {
        self.title = Some(value.into());
        self
    }

    fn titles<F>(mut self, f: F) -> Self
    where
        F: FnOnce(&mut MultiLanguageBuilder<String>) -> &mut MultiLanguageBuilder<String>,
    {
        let mut builder = MultiLanguageBuilder::default();
        f(&mut builder);
        self.titles = Some(builder);
        self
    }

    fn description(mut self, value: impl Into<String>) -> Self {
        self.description = Some(value.into());
        self
    }

    fn descriptions<F>(mut self, f: F) -> Self
    where
        F: FnOnce(&mut MultiLanguageBuilder<String>) -> &mut MultiLanguageBuilder<String>,
    {
        let mut builder = MultiLanguageBuilder::default();
        f(&mut builder);
        self.descriptions = Some(builder);
        self
    }
}

macro_rules! impl_delegate_buildable_hr_info {
    ($( $ty:ident $( < $( $generic:ident $(: $bound:ident)? ),+ > )? on $($inner_path:ident).+ ),+ $(,)?) => {
        $(
            impl $(< $($generic $(: $bound)? ),+ >)? BuildableHumanReadableInfo for $ty $(< $($generic),+ >)?
            {
                #[inline]
                fn attype(mut self, value: impl Into<String>) -> Self {
                    self. $($inner_path).+ = self. $($inner_path).+ .attype(value);
                    self
                }

                #[inline]
                fn title(mut self, value: impl Into<String>) -> Self {
                    self. $($inner_path).+ = self. $($inner_path).+ .title(value);
                    self
                }

                #[inline]
                fn titles<F>(mut self, f: F) -> Self
                where
                    F: FnOnce(&mut MultiLanguageBuilder<String>) -> &mut MultiLanguageBuilder<String>,
                {
                    self. $($inner_path).+ = self. $($inner_path).+ .titles(f);
                    self
                }

                #[inline]
                fn description(mut self, value: impl Into<String>) -> Self {
                    self. $($inner_path).+ = self. $($inner_path).+ .description(value);
                    self
                }

                #[inline]
                fn descriptions<F>(mut self, f: F) -> Self
                where
                    F: FnOnce(&mut MultiLanguageBuilder<String>) -> &mut MultiLanguageBuilder<String>,
                {
                    self. $($inner_path).+ = self. $($inner_path).+ .descriptions(f);
                    self
                }
            }
        )+
    };
}

pub(super) use impl_delegate_buildable_hr_info;