tree-buf 0.10.0

A prototype binary serialization protocol for data
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

use crate::prelude::*;

#[cfg(feature = "encode")]
impl<T: Encodable> Encodable for Option<T> {
    type EncoderArray = NullableEncoder<T::EncoderArray>;
    fn encode_root<O: EncodeOptions>(&self, stream: &mut EncoderStream<'_, O>) -> RootTypeId {
        if let Some(value) = self {
            T::encode_root(value, stream)
        } else {
            RootTypeId::Void
        }
    }
}

#[cfg(feature = "decode")]
impl<T: Decodable> Decodable for Option<T> {
    type DecoderArray = Option<NullableDecoder<T::DecoderArray>>;
    fn decode(sticks: DynRootBranch<'_>, options: &impl DecodeOptions) -> DecodeResult<Self> {
        profile_method!(decode);
        match sticks {
            DynRootBranch::Void => Ok(None),
            _ => Ok(Some(T::decode(sticks, options)?)),
        }
    }
}

#[cfg(feature = "encode")]
#[derive(Default)]
pub struct NullableEncoder<V> {
    opt: <bool as Encodable>::EncoderArray,
    value: Option<V>,
}

#[cfg(feature = "encode")]
impl<T: Encodable> EncoderArray<Option<T>> for NullableEncoder<T::EncoderArray> {
    fn buffer_one<'a, 'b: 'a>(&'a mut self, value: &'b Option<T>) {
        self.opt.buffer_one(&value.is_some());
        if let Some(value) = value {
            self.value.get_or_insert_with(T::EncoderArray::default).buffer_one(value);
        }
    }
    fn flush<O: EncodeOptions>(self, stream: &mut EncoderStream<'_, O>) -> ArrayTypeId {
        profile_method!(flush);
        let Self { opt, value } = self;
        if let Some(value) = value {
            stream.encode_with_id(|stream| opt.flush(stream));
            stream.encode_with_id(|stream| value.flush(stream));
            ArrayTypeId::Nullable
        } else {
            ArrayTypeId::Void
        }
    }
}

#[cfg(feature = "decode")]
pub struct NullableDecoder<T> {
    opts: <bool as Decodable>::DecoderArray,
    values: T,
}

#[cfg(feature = "decode")]
impl<T: DecoderArray> DecoderArray for Option<NullableDecoder<T>> {
    type Decode = Option<T::Decode>;
    type Error = T::Error;
    fn new(sticks: DynArrayBranch<'_>, options: &impl DecodeOptions) -> DecodeResult<Self> {
        profile_method!(new);

        match sticks {
            DynArrayBranch::Nullable { opt, values } => {
                let (opts, values) = parallel(|| <bool as Decodable>::DecoderArray::new(*opt, options), || T::new(*values, options), options);
                let opts = opts?;
                let values = values?;
                Ok(Some(NullableDecoder { opts, values }))
            }
            DynArrayBranch::Void => Ok(None),
            _ => Err(DecodeError::SchemaMismatch),
        }
    }
    fn decode_next(&mut self) -> Result<Self::Decode, Self::Error> {
        Ok(if let Some(inner) = self {
            if inner.opts.decode_next_infallible() {
                Some(inner.values.decode_next()?)
            } else {
                None
            }
        } else {
            None
        })
    }
}