#protobuf #codec #proto3 #encoder-decoder #protobuf3

no-std anybuf

A minimal, zero dependency proto3 encoder to encode/decode anything. No schemas needed.

8 releases (4 breaking)

0.5.2 Dec 6, 2024
0.5.1 Dec 5, 2024
0.5.0 Jun 4, 2024
0.4.0 Feb 10, 2024
0.1.0 Apr 28, 2023

#170 in Encoding

Download history 782/week @ 2024-12-04 729/week @ 2024-12-11 332/week @ 2024-12-18 101/week @ 2024-12-25 236/week @ 2025-01-01 607/week @ 2025-01-08 316/week @ 2025-01-15 419/week @ 2025-01-22 257/week @ 2025-01-29 688/week @ 2025-02-05 275/week @ 2025-02-12 361/week @ 2025-02-19 520/week @ 2025-02-26 579/week @ 2025-03-05 1167/week @ 2025-03-12 1062/week @ 2025-03-19

3,376 downloads per month
Used in 15 crates (5 directly)

Apache-2.0

120KB
2K SLoC

anybuf

anybuf on crates.io Docs

A minimal, zero dependency protobuf encoder and decoder to encode/decode anything. It is designed to create the value bytes of a protobuf Any, hence the name.

Due to its low level design, anybuf allows you to do things wrong in many ways and you should have a solid understanding of how protobuf encoding works in general to better understand the API.

The crate anybuf is split in two major components:

  • anybuf::Anybuf is a protobuf encoder
  • anybuf::Bufany is a protobuf decoder

Non goals

Supported

  • Varint fields (bool/uint32/uint64/sint32/sint64/int32/int64)
  • Variable length fields (string/bytes)
  • Nested messages: Just append an Anybuf instance
  • Repeated (bool/uint32/uint64/sint32/sint64/int32/int64/string/bytes/messages)

Not yet supported

How to use it

Encoding

use anybuf::Anybuf;

let data = Anybuf::new()
    .append_uint64(1, 4)        // field number 1 gets value 4
    .append_string(2, "hello")  // field number 2 gets a string
    .append_bytes(3, b"hello")  // field number 3 gets bytes
    .append_message(4, &Anybuf::new().append_bool(3, true)) // field 4 gets a message
    .append_repeated_uint64(5, &[23, 56, 192])              // field number 5 is a repeated uint64
    .into_vec();                // done

// data is now a serialized protobuf document

Decoding

use anybuf::Bufany;

let deserialized = Bufany::deserialize(&data).unwrap(); // data from above
let id = deserialized.uint64(1).unwrap(); // 4
let title = deserialized.string(2).unwrap(); // "hello"

no_std support

Since version 0.5.0 there is a default std feature. If you remove that, the library is built with no_std support. As the anybuf maintainers do not require no_std support this is provided at a best effort basis and might be broken.

[dependencies]
anybuf = { version = "0.5.0", default-features = false }

No runtime deps