tag | 166c426b5b3ff70bcf956a64f5b8c81f23b5b1d7 | |
---|---|---|
tagger | The Android Open Source Project <initial-contribution@android.com> | Wed Oct 26 18:47:36 2022 -0700 |
object | 0e0b76433d0eac3da0ed8a88f90f08a1a548b9d1 |
t_frc_doc_330443060
commit | 0e0b76433d0eac3da0ed8a88f90f08a1a548b9d1 | [log] [tgz] |
---|---|---|
author | Android Build Coastguard Worker <android-build-coastguard-worker@google.com> | Mon May 09 06:00:54 2022 +0000 |
committer | Android Build Coastguard Worker <android-build-coastguard-worker@google.com> | Mon May 09 06:00:54 2022 +0000 |
tree | f0d3f05c18afd04b9824b485585518fe06641ee1 | |
parent | 3d79f9082eaa438534e0767c0a6b76641dc52f50 [diff] | |
parent | 0af506eab5a6d52635e775e0ad9b6439da826a3a [diff] |
Snap for 8558685 from 0af506eab5a6d52635e775e0ad9b6439da826a3a to tm-frc-documentsui-release Change-Id: Iad868f21d71ef4f70bad149b33e8a4540de8d9eb
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.