#byte-buffer #byte #io #buffer #endian #utility


Bytey provides a convenient and easy to use byte storage

5 releases (3 breaking)

0.3.0 Apr 2, 2022
0.2.0 Feb 8, 2022
0.1.1 Jan 28, 2022
0.1.0 Jan 28, 2022
0.0.0 Dec 28, 2021

#2264 in Encoding

25 downloads per month

MIT license

527 lines


Bytey provides a convenient and easy to use byte storage.


A link to the documentation can be found here.


To start using this crate all you have to do is add it to your Cargo.toml:

bytey = "0.3.0"


use bytey::ByteBuffer;

fn main() {
    let mut buffer = ByteBuffer::new().unwrap();

    let value1: u16 = 1234;
    let value2: i32 = -2000;
    let value3: usize = usize::MAX;

    // Initially the buffer will have a size of 8 bytes, unless you create the buffer using the with_capacity method
    // The buffer will resize itself to fit all data inside of it

    // When you write a value to the buffer, the cursor will move along
    // So if we want to read the values we just put in, we have to move it back to 0

    // Read and print the values stored inside the buffer
    println!("{}", buffer.read::<u16>().unwrap()); // prints "1234"
    println!("{}", buffer.read::<i32>().unwrap()); // prints "-2000"
    println!("{}", buffer.read::<usize>().unwrap()); // prints what the MAX is for usize on the system

Any value written to the ByteBuffer will have to implement the ByteBufferWrite trait. By default, this trait is implemented on all numerical primitives(u8, u16, i8, i16, etc...).

Reading a type from the ByteBuffer requires that type to implement the ByteBufferRead trait, this has also been implemented by default on all numeral primitives.

If you would like to see more default implementations of these traits let me know in an issue on GitHub!


Bytey comes with 2 derive macros with the same name as the traits ByteBufferWrite and ByteBufferRead that you can use on your own structs and enums.

use bytey::{ByteBuffer, ByteBufferRead, ByteBufferWrite};

fn main() {
    #[derive(ByteBufferRead, ByteBufferWrite, Debug, PartialEq)]
    struct Test {
      a: u8,
      b: u16,
      c: isize,

    let mut buffer = ByteBuffer::new().unwrap();
    let val = Test { a: 1, b: 2, c: 3 };


    assert_eq!(val, buffer.read::<Test>().unwrap());

Keep in mind that all the fields inside the struct or enum must implement the trait as well, else you will get an error.


  • 0.3.0

    • Added derive macros for the ByteBufferWrite and ByteBufferRead traits
  • 0.2.0

    • Added feature-gated Bincode support
    • Added Clone trait to ByteBuffer
    • Added truncate method to ByteBuffer


Feel free to contribute by sending pull requests. For major changes or if you have an idea that could help improve Bytey, please open an issue!

Please make sure if you do contribute that tests are updated appropriately.




~36K SLoC