#parser #binary-data #binary-parser #binary-encoding #binary

no-std byte

A low-level, zero-copy and panic-free serializer and deserializer for binary

8 releases

0.2.7 Feb 7, 2024
0.2.6 Apr 11, 2021
0.2.4 Jun 23, 2019
0.2.3 Mar 2, 2018
0.2.1 Jun 28, 2017

#446 in Parser implementations

Download history 1629/week @ 2024-06-17 1917/week @ 2024-06-24 1769/week @ 2024-07-01 1645/week @ 2024-07-08 2922/week @ 2024-07-15 1929/week @ 2024-07-22 1894/week @ 2024-07-29 2248/week @ 2024-08-05 2397/week @ 2024-08-12 1868/week @ 2024-08-19 2394/week @ 2024-08-26 2925/week @ 2024-09-02 1966/week @ 2024-09-09 2498/week @ 2024-09-16 1857/week @ 2024-09-23 1336/week @ 2024-09-30

7,770 downloads per month
Used in 18 crates (10 directly)

MIT/Apache

27KB
362 lines

Byte

build status crates.io docs.rs

A low-level, zero-copy and panic-free binary serializer and deserializer.

Documentation

Usage

Add the following to your Cargo.toml:

[dependencies]
byte = "0.2"

Byte is a no_std library; it can be used in any #![no_std] situation or crate.

Overview

Byte is designed to encode or decode binary data in a fast and low-level way. A classical use case is I2C communication en/decoding.

Byte provides two core traits TryRead and TryWrite. Types that implement these traits can be serialized into or deserialized from byte slices.

The library is meant to be simple, and it will always be.

Example

use byte::*;

let bytes: &[u8] = &[0xde, 0xad, 0xbe, 0xef];

let offset = &mut 0;
let num = bytes.read_with::<u32>(offset, BE).unwrap();
assert_eq!(num, 0xdeadbeef);
assert_eq!(*offset, 4);
use byte::*;
use byte::ctx::{Str, NULL};

let bytes: &[u8] = b"hello, world!\0dump";

let offset = &mut 0;
let str = bytes.read_with::<&str>(offset, Str::Delimiter(NULL)).unwrap();
assert_eq!(str, "hello, world!");
assert_eq!(*offset, 14);

Contribution

All kinds of contribution are welcomed.

  • Issues. Feel free to open an issue when you find typos, bugs, or have any question.
  • Pull requests. New collection, better implementation, more tests, more documents and typo fixes are all welcomed.

License

Licensed under MIT license (LICENSE-MIT or http://opensource.org/licenses/MIT)

No runtime deps