#magic #binary-data #macro #binary #struct #data #write #structs

binwrite

A Rust crate for helping write structs as binary data using ✨macro magic✨

8 releases

0.2.1 Feb 7, 2020
0.2.0 Feb 7, 2020
0.1.5 Dec 11, 2019
0.1.3 Nov 3, 2019

#758 in Encoding

Download history 249/week @ 2022-12-02 328/week @ 2022-12-09 245/week @ 2022-12-16 397/week @ 2022-12-23 441/week @ 2022-12-30 185/week @ 2023-01-06 323/week @ 2023-01-13 288/week @ 2023-01-20 448/week @ 2023-01-27 464/week @ 2023-02-03 455/week @ 2023-02-10 774/week @ 2023-02-17 1229/week @ 2023-02-24 513/week @ 2023-03-03 283/week @ 2023-03-10 364/week @ 2023-03-17

2,543 downloads per month
Used in 21 crates (15 directly)

MIT license

18KB
225 lines

binwrite

A Rust crate for helping write structs as binary data using ✨macro magic✨

Usage

BinWrite uses a derive macro for declaratively defining binary writing methods for structs.

Basic Example

use binwrite::BinWrite;

#[derive(BinWrite)]
#[binwrite(little)]
struct Rect {
    x: i32,
    y: i32,
    #[binwrite(big)]
    size: (u16, u16),
}

fn main() {
    let rects = vec![
        Rect { x: 1, y: -2, size: (3, 4) },
        Rect { x: 20, y: 4, size: (5, 7) }
    ];
    let mut bytes = vec![];
    rects.write(&mut bytes).unwrap();
    assert_eq!(
        bytes,
        vec![
        //  [  x (little endian) ]  [  y (little endian) ]  [ size.0 ]  [ size.1 ]
            0x01, 0x00, 0x00, 0x00, 0xFE, 0xFF, 0xFF, 0xFF, 0x00, 0x03, 0x00, 0x04,
            0x14, 0x00, 0x00, 0x00, 0x04, 0x00, 0x00, 0x00, 0x00, 0x05, 0x00, 0x07,
        ]
    );
}

more examples can be found in the BinWrite documentation.

Dependencies

~0.7–1MB
~26K SLoC