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
//! A utility crate built for the libqaul ecosystem
//!
//! Note: unfortunately `serde` is very re-export unfriendly, so you
//! will want to include `serde = { version = "1.0", features =
//! ["derive"] }` to your crate manually!

pub use postcard::{
    flavors::{Cobs, StdVec},
    Error, Result,
};

use serde::{de::DeserializeOwned, Serialize};
use std::fmt::Debug;

/// Serialise any iteratable into a compacted binary payload
pub fn serialise<S>(data: &S) -> Result<Vec<u8>>
where
    S: Serialize + Debug,
{
    postcard::to_stdvec(data)
}

/// Deserialise a byte array payload into a concrete type
pub fn deserialise<D>(data: &Vec<u8>) -> Result<D>
where
    D: DeserializeOwned,
{
    postcard::from_bytes(&data)
}

#[cfg(test)]
mod tests {

    #[test]
    fn serialise() {
        use serde::Serialize;

        #[derive(Debug, Serialize)]
        struct Foo(usize);

        let foo = Foo(1312);
        let v = crate::serialise(&foo).unwrap();
        assert_eq!(v.len(), 10);
    }

    #[test]
    fn deserialise() {
        use serde::Deserialize;

        #[derive(Deserialize)]
        struct Foo(usize);

        let v = vec![32, 5, 0, 0, 0, 0, 0, 0];
        let f: Foo = crate::deserialise(&v).unwrap();

        assert_eq!(f.0, 1312);
    }
}