brec 0.6.0

A flexible binary format for storing and streaming structured data as packets with CRC protection and recoverability from corruption. Built for extensibility and robustness.
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

use crate::csharp_feat::{CSharpObject, CSharpValue, from_csharp_object, to_csharp_object};
use crate::*;

impl<B: BlockDef + CSharpObject, P: PayloadDef<Inner>, Inner: PayloadInnerDef + CSharpObject>
    PacketDef<B, P, Inner>
{
    /// Reads packet bytes and converts to `CSharpValue` object.
    pub fn decode_csharp(
        bytes: &[u8],
        ctx: &mut <Inner as ProtocolSchema>::Context<'_>,
    ) -> Result<CSharpValue, Error> {
        let mut cursor = std::io::Cursor::new(bytes);
        let packet = <Self as ReadPacketFrom>::read(&mut cursor, ctx)?;
        Ok(to_csharp_object(&packet.blocks, packet.payload.as_ref())?)
    }

    /// Parses `CSharpValue` packet object and encodes into packet bytes.
    pub fn encode_csharp(
        value: CSharpValue,
        out: &mut Vec<u8>,
        ctx: &mut <Inner as ProtocolSchema>::Context<'_>,
    ) -> Result<(), Error> {
        let (blocks, payload) = from_csharp_object::<B, Inner>(value)?;
        let mut packet = Self::new(blocks, payload);
        packet.write_all(out, ctx)?;
        Ok(())
    }
}