simple_parse

simple_parse is a declarative encoder/decoder for Rust structs to/from binary.

It provides basic implementations for most standard Rust types and also provides a derive macro to automatically implement the trait on your own Rust types !

For lower level control, take a look at deku.

Usage

use ::simple_parse::{SpRead, SpWrite};

#[derive(SpRead, SpWrite)]
pub struct SomeStruct {
    pub some_field: u8,
    nitems: u16,
    #[sp(count="nitems", endian="big")]
    pub items: Vec<u32>,
}

let mut cursor: &[u8] = &[
    0x01,                   // some_field
    0x00,0x02,              // nitems (Field holding the number of Vec items)
    0xDE,0xAD,0xBE,0xEF,    // items[0]
    0xBA,0xDC,0x0F,0xFE     // items[1]
];

// Decode bytes into a struct
let mut my_struct = SomeStruct::from_bytes(&mut cursor)?;

/// Modify the struct
my_struct.items.push(0xFFFFFFFF);

/// Encode modified struct into bytes
let mut dst_buf: Vec<u8> = Vec::new();
my_struct.to_bytes(&mut dst_buf)?;
//dst_buf == [0x01,0x00,0x03,0xDE,0xAD,0xBE,0xEF,0xBA,0xDC,0x0F,0xFE,0xFF,0xFF,0xFF,0xFF]

For complete examples see : examples

Default Impls