| <!-- cargo-sync-readme start --> |
| |
| # Library to read and write protocol buffers data |
| |
| ## Features |
| |
| This crate has one feature, which is `with-bytes`. |
| |
| `with-bytes` enables `protobuf` crate support for |
| [`bytes` crate](https://github.com/tokio-rs/bytes): |
| when parsing bytes or strings from `bytes::Bytes`, |
| `protobuf` will be able to reference the input instead of allocating subarrays. |
| |
| Note, codegen also need to be instructed to generate `Bytes` or `Chars` for |
| `bytes` or `string` protobuf types instead of default `Vec<u8>` or `String`, |
| just enabling option on this crate is not enough. |
| |
| See `Customize` struct in [`protobuf-codegen` crate](https://docs.rs/protobuf-codegen). |
| |
| ## Accompanying crates |
| |
| * [`protobuf-json-mapping`](https://docs.rs/protobuf-json-mapping) |
| implements JSON parsing and serialization for protobuf messages. |
| * [`protobuf-codegen`](https://docs.rs/protobuf-codegen) |
| can be used to rust code from `.proto` crates. |
| * [`protoc-bin-vendored`](https://docs.rs/protoc-bin-vendored) |
| contains `protoc` command packed into the crate. |
| * [`protobuf-parse`](https://docs.rs/protobuf-parse) contains |
| `.proto` file parser. Rarely need to be used directly, |
| but can be used for mechanical processing of `.proto` files. |
| |
| <!-- cargo-sync-readme end --> |
