27 releases

0.17.0 May 23, 2024
0.16.0 Feb 28, 2023
0.15.1 Dec 19, 2022
0.15.0 Nov 16, 2022
0.1.2 Mar 30, 2020

#65 in Encoding

Download history 6778/week @ 2024-02-23 5647/week @ 2024-03-01 5870/week @ 2024-03-08 4764/week @ 2024-03-15 6044/week @ 2024-03-22 6543/week @ 2024-03-29 6499/week @ 2024-04-05 6783/week @ 2024-04-12 7290/week @ 2024-04-19 6322/week @ 2024-04-26 6935/week @ 2024-05-03 6616/week @ 2024-05-10 6157/week @ 2024-05-17 5639/week @ 2024-05-24 6781/week @ 2024-05-31 4495/week @ 2024-06-07

24,486 downloads per month
Used in 40 crates (30 directly)

MIT/Apache

190KB
3K SLoC

Deku

Latest Version Rust Documentation Actions Status codecov

Declarative binary reading and writing

This crate provides bit-level, symmetric, serialization/deserialization implementations for structs and enums

Why use Deku

Productivity: Deku will generate symmetric reader/writer functions for your type! Avoid the requirement of writing redundant, error-prone parsing and writing code for binary structs or network headers

Usage

Compiler support: requires rustc 1.71+

[dependencies]
deku = "0.17"

no_std:

[dependencies]
deku = { version = "0.17", default-features = false, features = ["alloc"] }

Example

See documentation or examples folder for more!

Read big-endian data into a struct, modify a value, and write it

use deku::prelude::*;

#[derive(Debug, PartialEq, DekuRead, DekuWrite)]
#[deku(endian = "big")]
struct DekuTest {
    #[deku(bits = 4)]
    field_a: u8,
    #[deku(bits = 4)]
    field_b: u8,
    field_c: u16,
}

fn main() {
    let data: Vec<u8> = vec![0b0110_1001, 0xBE, 0xEF];
    let (_rest, mut val) = DekuTest::from_bytes((data.as_ref(), 0)).unwrap();
    assert_eq!(DekuTest {
        field_a: 0b0110,
        field_b: 0b1001,
        field_c: 0xBEEF,
    }, val);

    val.field_c = 0xC0FE;

    let data_out = val.to_bytes().unwrap();
    assert_eq!(vec![0b0110_1001, 0xC0, 0xFE], data_out);
}

Changelog

See CHANGELOG.md

Dependencies

~1.8–2.6MB
~57K SLoC