b3-rs

A Rust implementation of B3 (Better Binary Buffers).

This library is in very early stages of development! There is no guarantee of API stability until we reach v1.0.0.

Parts of this library are heavily based on the original Python B3 implementation.

Usage

```rust use b3_rs::item::{Item, ItemKey, ItemValue};

// Creating an item for a simple type let stringitem = Item::from("item value").withkey(ItemKey::from("item key")); let integeritem = Item::from(123456u64).withkey(ItemKey::from(0u64));

// Creating an item collection let dictitem = Item::new( ItemKey::NoKey, ItemValue::CompositeDict( vec![stringitem, integer_item] ), );

// Encoding items into the wire format let encoded = dict_item.encode()?;

// Decoding items from the wire format let (decoded, bytecount) = Item::decode(&encoded)?; asserteq!(bytecount, encoded.len()); asserteq!(dict_item, decoded); ```

Caveats

No derive macros

Currently, you have to construct b3_rs::item::Item instances manually.

Some From<T> implementations exist - for byte arrays, strings, booleans, and integers - so you can do something like this:

rust let item = Item::from("string value").with_key(ItemKey::from("string key"));

Unimplemented item types

The following item types are currently unimplemented:

• Decimal (type 10)
• Sched (type 13)
• Complex (type 16)

The error b3_rs::Error::UnimplementedB3TypeError will be returned when a message contains any of these types.

References

• B3 wire format documentation

License

The code in this project is licensed under the MIT license. See the LICENSE file in the root of the repository for more information.