tosca 0.1.1

A library that acts as an interface between a device and its controller.
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

macro_rules! map {
    (
        /// $desc:expr
        $(#[$attrs:meta])*
        pub struct $name:ident$(<$a:lifetime>)?(IndexMap<$key:ty, $value:ty, DefaultHashBuilder>);
    ) => {
        ///
        $(#[$attrs])*
        pub struct $name$(<$a>)?(IndexMap<$key, $value, DefaultHashBuilder>);

        impl<$($a,)? 'b> IntoIterator for &'b $name$(<$a>)? {
            type Item = (&'b $key, &'b $value);
            type IntoIter = Iter<'b, $key, $value>;

            fn into_iter(self) -> Self::IntoIter {
                self.iter()
            }
        }

        impl$(<$a>)? Default for $name$(<$a>)? {
            fn default() -> Self {
                Self::new()
            }
        }

        impl$(<$a>)? $name$(<$a>)? {
            #[doc = concat!("Creates an empty [`", stringify!($name), "`].")]
            #[must_use]
            #[inline]
            pub fn new() -> Self {
                Self(IndexMap::with_hasher(DefaultHashBuilder::default()))
            }

            #[doc = concat!("Initializes [`", stringify!($name), "`] with a specific element.")]
            #[must_use]
            #[inline]
            pub fn init(key: $key, value: $value) -> Self {
                Self::new().insert(key, value)
            }

            #[doc = concat!("Inserts a new element into [`", stringify!($name), "`].")]
            #[must_use]
            #[inline]
            pub fn insert(mut self, key: $key, value: $value) -> Self {
                self.0.insert(key, value);
                self
            }

            #[doc = concat!("Adds a new element into [`", stringify!($name), "`].")]
            #[doc = ""]
            #[doc = concat!("Unlike [`Self::insert`], this method does not return a modified [`", stringify!($name), "`].")]
            #[inline]
            pub fn add(&mut self, key: $key, value: $value) {
                self.0.insert(key, value);
            }

            #[doc = concat!("Checks if [`", stringify!($name), "`] is empty.")]
            #[must_use]
            #[inline]
            pub fn is_empty(&self) -> bool {
                self.0.is_empty()
            }

            #[doc = concat!("Provides the number of elements in [`", stringify!($name), "`].")]
            #[must_use]
            #[inline]
            pub fn len(&self) -> usize {
                self.0.len()
            }

            #[doc = concat!("Returns an iterator over [`", stringify!($name), "`].")]
            #[doc = ""]
            #[doc = "**Iterates over the elements in the order they were inserted.**"]
            #[must_use]
            #[inline]
            pub fn iter(&self) -> Iter<'_, $key, $value> {
                self.0.iter()
            }
        }
    };
}

pub(crate) use map;