zbus 6.2.0

API for D-Bus communication and its wire format
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

// Test through both generic and specific API (wrt byte order)
#[macro_export]
macro_rules! basic_type_test {
    ($endian:expr, $test_value:expr, $expected_len:expr, $expected_ty:ty, $align:literal) => {{
        // Lie that we're starting at byte 1 in the overall message to test padding
        let ctxt = zbus::wire::serialized::Context::new($endian, 1);
        let encoded = zbus::wire::to_bytes(ctxt, &$test_value).unwrap();
        let padding = zbus::wire::padding_for_n_bytes(1, $align);

        assert_eq!(
            encoded.len(),
            $expected_len + padding,
            "invalid encoding using `to_bytes`"
        );
        let (decoded, parsed): ($expected_ty, _) = encoded.deserialize().unwrap();
        assert!(decoded == $test_value, "invalid decoding");
        assert!(parsed == encoded.len(), "invalid parsing");

        // Now encode w/o padding
        let ctxt = zbus::wire::serialized::Context::new($endian, 0);
        let encoded = zbus::wire::to_bytes(ctxt, &$test_value).unwrap();
        assert_eq!(
            encoded.len(),
            $expected_len,
            "invalid encoding using `to_bytes`"
        );

        encoded
    }};
    (
        $endian:expr,
        $test_value:expr,
        $expected_len:expr,
        $expected_ty:ty,
        $align:literal,
        $kind:ident,
        $expected_value_len:expr
    ) => {{
        let encoded = basic_type_test!($endian, $test_value, $expected_len, $expected_ty, $align);

        // As Variant
        let v: zbus::Variant<'_> = $test_value.into();
        assert_eq!(
            v.value_signature(),
            <$expected_ty as zbus::Basic>::SIGNATURE_STR
        );
        assert_eq!(v, zbus::Variant::$kind($test_value));
        value_test!($endian, v, $expected_value_len);

        let v: $expected_ty = v.try_into().unwrap();
        assert_eq!(v, $test_value);

        encoded
    }};
}

#[macro_export]
macro_rules! value_test {
    ($endian:expr, $test_value:expr, $expected_len:expr) => {{
        let ctxt = zbus::wire::serialized::Context::new($endian, 0);
        let encoded = zbus::wire::to_bytes(ctxt, &$test_value).unwrap();
        assert_eq!(
            encoded.len(),
            $expected_len,
            "invalid encoding using `to_bytes`"
        );
        let (decoded, parsed): (zbus::Variant<'_>, _) = encoded.deserialize().unwrap();
        assert!(decoded == $test_value, "invalid decoding");
        assert!(parsed == encoded.len(), "invalid parsing");

        encoded
    }};
}

#[cfg(unix)]
#[macro_export]
macro_rules! fd_value_test {
    (
        $endian:expr,
        $test_value:expr,
        $expected_len:expr,
        $align:literal,
        $expected_value_len:expr
    ) => {{
        use std::os::fd::AsFd;

        // Lie that we're starting at byte 1 in the overall message to test padding
        let ctxt = zbus::wire::serialized::Context::new($endian, 1);
        let encoded = zbus::wire::to_bytes(ctxt, &$test_value).unwrap();
        let padding = zbus::wire::padding_for_n_bytes(1, $align);
        assert_eq!(
            encoded.len(),
            $expected_len + padding,
            "invalid encoding using `to_bytes`"
        );
        #[cfg(unix)]
        let (_, parsed): (zbus::Fd<'_>, _) = encoded.deserialize().unwrap();
        assert!(
            parsed == encoded.len(),
            "invalid parsing using `from_slice`"
        );

        // Now encode w/o padding
        let ctxt = zbus::wire::serialized::Context::new($endian, 0);
        let encoded = zbus::wire::to_bytes(ctxt, &$test_value).unwrap();
        assert_eq!(
            encoded.len(),
            $expected_len,
            "invalid encoding using `to_bytes`"
        );

        // As Variant
        let v: zbus::Variant<'_> = $test_value.into();
        assert_eq!(v.value_signature(), zbus::Fd::SIGNATURE_STR);
        assert_eq!(v, zbus::Variant::Fd($test_value));
        let encoded = zbus::wire::to_bytes(ctxt, &v).unwrap();
        assert_eq!(encoded.fds().len(), 1, "invalid encoding using `to_bytes`");
        assert_eq!(
            encoded.len(),
            $expected_value_len,
            "invalid encoding using `to_bytes`"
        );
        let (decoded, parsed): (zbus::Variant<'_>, _) = encoded.deserialize().unwrap();
        assert_eq!(
            decoded,
            zbus::Fd::from(encoded.fds()[0].as_fd()).into(),
            "invalid decoding using `from_slice`"
        );
        assert_eq!(parsed, encoded.len(), "invalid parsing using `from_slice`");

        let v: zbus::Fd<'_> = v.try_into().unwrap();
        assert_eq!(v, $test_value);
    }};
}