postcard-bytes 0.1.0

A no_std + serde compatible message library for Rust (+ faster byte array (de-)serialization)
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

#![allow(unused_imports)]

#[cfg(feature = "experimental-derive")]
mod tests {
    use postcard::experimental::max_size::MaxSize;
    use postcard::to_slice;
    use serde::Serialize;

    #[test]
    fn test_struct_max_size() {
        #[derive(MaxSize)]
        struct Foo {
            _a: u16,
            _b: Option<u8>,
        }

        assert_eq!(Foo::POSTCARD_MAX_SIZE, 5);
    }

    #[test]
    fn test_enum_max_size() {
        #[allow(dead_code)]
        #[derive(MaxSize, Serialize)]
        enum Bar {
            A(u16),
            B(u8),
        }

        assert_eq!(Bar::POSTCARD_MAX_SIZE, 4);
        let mut buf = [0u8; 128];
        let used = to_slice(&Bar::A(0xFFFF), &mut buf).unwrap();
        assert!(
            used.len() <= Bar::POSTCARD_MAX_SIZE,
            "FAIL {} > {}",
            used.len(),
            Bar::POSTCARD_MAX_SIZE
        );

        #[derive(MaxSize)]
        enum Baz {}

        assert_eq!(Baz::POSTCARD_MAX_SIZE, 0);
    }

    #[test]
    fn test_ref() {
        #[allow(dead_code)]
        #[derive(MaxSize)]
        struct Foo {
            a: &'static u32,
        }
    }

    #[cfg(feature = "heapless")]
    #[test]
    fn test_vec_edge_cases() {
        #[track_caller]
        fn test_equals<const N: usize>(buf: &mut [u8]) {
            let mut v = heapless::Vec::<u8, N>::new();
            for _ in 0..N {
                v.push(0).unwrap();
            }

            let serialized = postcard::to_slice(&v, buf).unwrap();

            assert_eq!(heapless::Vec::<u8, N>::POSTCARD_MAX_SIZE, serialized.len());
        }

        let mut buf = [0; 16400];

        test_equals::<1>(&mut buf);
        test_equals::<2>(&mut buf);

        test_equals::<127>(&mut buf);
        test_equals::<128>(&mut buf);
        test_equals::<129>(&mut buf);

        test_equals::<16383>(&mut buf);
        test_equals::<16384>(&mut buf);
        test_equals::<16385>(&mut buf);
    }

    // #[cfg(feature = "experimental-derive")]
    // #[test]
    // fn test_union_max_size() {
    //     #[derive(postcard::MaxSize)]
    //     union Foo {
    //         a: u16,
    //         b: Option<u8>,
    //     }
    // }

    // #[cfg(feature = "experimental-derive")]
    // #[test]
    // fn test_not_implemented() {
    //     #[derive(postcard::MaxSize)]
    //     struct Foo {
    //         a: &'static str,
    //     }
    // }
}