binrw 0.15.1

A Rust crate for helping read structs from binary data using ✨macro magic✨
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

#[cfg(feature = "std")]
#[test]
fn dbg() {
    use binrw::{io::Cursor, BinRead};

    #[allow(dead_code)]
    #[derive(BinRead, Debug)]
    struct Inner(u32);

    #[allow(dead_code)]
    #[derive(BinRead)]
    #[br(big)]
    struct Test {
        before: u16,
        #[br(dbg, pad_before = 2, pad_after = 1)]
        value: u32,
        #[br(dbg, align_before = 10, align_after = 16)]
        inner: Inner,
        #[br(dbg, pad_size_to = 4)]
        last: u8,
        #[br(dbg)]
        terminator: u8,
    }

    // 🥴
    if let Some("1") = option_env!("BINRW_IN_CHILD_PROC") {
        Test::read(&mut Cursor::new(
            b"\0\0\xff\xff\0\0\0\x04\xff\xff\0\x0e\xff\xed\xff\xff\x42\0\0\0\x69",
        ))
        .unwrap();
    } else {
        use std::process::{Command, Stdio};

        let result = Command::new(env!("CARGO"))
            .env("BINRW_IN_CHILD_PROC", "1")
            .args(["test", "-q", "--test", "dbg", "--", "--nocapture"])
            .stdin(Stdio::null())
            .stdout(Stdio::null())
            .output()
            .unwrap()
            .stderr;

        assert_eq!(
            std::str::from_utf8(&result).unwrap(),
            format!(
                concat!(
                    "[{file}:{offset_0} | pad_before 0x2]\n",
                    "[{file}:{offset_0} | offset 0x4] value = 0x4\n",
                    "[{file}:{offset_0} | pad_after 0x1]\n",
                    "[{file}:{offset_1} | align_before 0xa]\n",
                    "[{file}:{offset_1} | offset 0xa] inner = Inner(\n",
                    "    0xeffed,\n",
                    ")\n",
                    "[{file}:{offset_1} | align_after 0x10]\n",
                    "[{file}:{offset_2} | offset 0x10] last = 0x42\n",
                    "[{file}:{offset_2} | pad_size_to 0x4]\n",
                    "[{file}:{offset_3} | offset 0x14] terminator = 0x69\n",
                ),
                file = core::file!(),
                offset_0 = if cfg!(nightly) { 16 } else { 11 },
                offset_1 = if cfg!(nightly) { 18 } else { 11 },
                offset_2 = if cfg!(nightly) { 20 } else { 11 },
                offset_3 = if cfg!(nightly) { 22 } else { 11 },
            )
        );
    }
}