#codec #binary #decoding #framed #frame #wire

wire-framed-core

A library for encoding and decoding structures into a binary data format

9 releases (4 breaking)

0.5.0 Jul 3, 2023
0.4.0 May 30, 2023
0.3.0 May 30, 2023
0.2.0 May 30, 2023
0.1.4 May 17, 2023

#9 in #framed

Download history 18/week @ 2024-09-22 10/week @ 2024-09-29

123 downloads per month
Used in wire-framed

Custom license

30KB
724 lines

wire-framed

wire-framed is a library for encoding and decoding frames using a custom binary protocol. It prioritizes ease-of-use.

It reolves around two traits FromFrame and IntoFrame. These traits can be manually implemented relatively easily using the utilities provided in the utils module or automatically using the Encoding and Decoding macros.

Usage

use wire_framed::prelude::*;

#[derive(Debug, Encoding, Decoding, PartialEq, Eq)]
pub struct Foo {
    pub id: u32,
    pub name: String,
    pub description: String,
    pub created_at: u64,
}

fn send() -> Result<(), std::io::Error> {
    let foo = Foo {
        id: 1,
        name: "John".to_string(),
        description: "John is a legend".to_string(),
        created_at: 1234567890,
    };

    let frame = foo.into_frame();
    send_to_socket(frame)
}

fn recv() -> Result<(), std::io::Error> {
    let bytes = recv_from_socket();
    let foo = Foo::from_frame(bytes)?;

    // process foo
}

Dependencies

~2.5–8MB
~55K SLoC