protokit_binformat 0.2.0

Usable protocol buffers
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46

# Protokit

[![crates.io](https://img.shields.io/crates/v/protokit.svg)](https://crates.io/crates/protokit)
[![img](https://img.shields.io/docsrs/protokit)](https://docs.rs/protokit/latest)
[![example workflow](https://github.com/semtexzv/protokit/actions/workflows/rust.yml/badge.svg)](https://github.com/semtexzv/protokit/actions/workflows/rust.yml)

Implementation of protocol buffers for rust.

## Why not prost/pb-j/rust-protobuf?

Started with my need for
proper [textformat](https://protobuf.dev/reference/protobuf/textformat-spec/#any)
support.

```prototext
any_value {
  [type.googleapis.com/com.example.SomeType] {
    field1: "hello"
  }
}
```

After I investigated other crates, I found out that they had other issues (
required
boxing in rust-protobuf, messy codegen in prost).

## Features

- Binary(100% conformance) + Text(90% conformance) format support
- No message boxing required
- GRPC (usable with tonic)
- Nice derive macro for creating message implementations without proto compiler:

```rust
#[derive(Default, Debug, Clone, BinProto)]
pub struct FieldPath {
    #[field(1, varint, packed)]
    pub fields: Vec<u32>,
}

#[derive(Default, Debug, Clone, BinProto)]
pub struct FieldMask {
    #[field(1, nested, repeated)]
    pub paths: Vec<FieldPath>,
}
```