#protobuf #codec #proto #proto3 #low-level #protobuf3

no-std anybuf

A minimal, zero dependency proto3 encoder to encode anything

6 releases (breaking)

0.5.0 Jun 4, 2024
0.4.0 Feb 10, 2024
0.3.0 Nov 1, 2023
0.3.0-rc.1 Oct 29, 2023
0.1.0 Apr 28, 2023

#208 in Encoding

Download history 160/week @ 2024-05-21 264/week @ 2024-05-28 341/week @ 2024-06-04 225/week @ 2024-06-11 863/week @ 2024-06-18 180/week @ 2024-06-25 254/week @ 2024-07-02 182/week @ 2024-07-09 456/week @ 2024-07-16 245/week @ 2024-07-23 454/week @ 2024-07-30 391/week @ 2024-08-06 634/week @ 2024-08-13 152/week @ 2024-08-20 287/week @ 2024-08-27 304/week @ 2024-09-03

1,441 downloads per month
Used in cw-ica-controller

Apache-2.0

115KB
1.5K 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