commit | 47c6ba213aab0b9c74bf619b71814abac5527b22 | [log] [tgz] |
---|---|---|
author | Android Build Coastguard Worker <android-build-coastguard-worker@google.com> | Sat Apr 01 06:20:29 2023 +0000 |
committer | Android Build Coastguard Worker <android-build-coastguard-worker@google.com> | Sat Apr 01 06:20:29 2023 +0000 |
tree | b50a997b739f6671b8dc0e6d8d7402b7d61e47b2 | |
parent | 7f9a2ab0d3a7d1a8bc7276d4578b640ec6e0d3d3 [diff] | |
parent | c09e48776e55c179c7f8970cbcc01dc826239b10 [diff] |
Snap for 9867821 from c09e48776e55c179c7f8970cbcc01dc826239b10 to udc-release Change-Id: Ia3d541def66c33f096de20507d58f11c12f5448e
Currently developed branch of rust-protobuf is 3. It has the same spirit as version 2, but contains numerous improvements like:
Stable version of rust-protobuf will be supported until version 3 released.
There are several ways to generate rust code from .proto
files
protoc
programmatically with protoc-rust crate (recommended)Have a look at readme in protoc-rust crate.
Readme should be in protobuf-codegen-pure crate.
Readme is here.
Have a look at generated files (for current development version), used internally in rust-protobuf:
Rust-protobuf can be used with bytes crate.
To enable Bytes
you need to:
with-bytes
feature in rust-protobuf:[dependencies] protobuf = { version = "~2.0", features = ["with-bytes"] }
with Customize
when codegen is invoked programmatically:
protoc_rust::run(protoc_rust::Args { ... customize: Customize { carllerche_bytes_for_bytes: Some(true), carllerche_bytes_for_string: Some(true), ..Default::default() }, });
or in .proto
file:
import "rustproto.proto"; option (rustproto.carllerche_bytes_for_bytes_all) = true; option (rustproto.carllerche_bytes_for_string_all) = true;
With these options enabled, fields of type bytes
or string
are generated as Bytes
or Chars
respectively. When CodedInputStream
is constructed from Bytes
object, fields of these types get subslices of original Bytes
object, instead of being allocated on heap.
protoc-rust
and protobuf-codegen-pure
can be used to rust code from .proto
crates.protobuf-codegen
for protoc-gen-rust
protoc plugin.protoc
crate can be used to invoke protoc
programmatically.protoc-bin-vendored
contains protoc
command packed into the crate.