commit | 46578f273c5eb33059fc72b591bf4479ccdcd347 | [log] [tgz] |
---|---|---|
author | Matt Lee <matthewhlee@google.com> | Tue Dec 06 21:36:27 2022 -0800 |
committer | Matt Lee <matthewhlee@google.com> | Tue Dec 06 21:36:27 2022 -0800 |
tree | eda2c3bcc49d645d0edc2b67d1b0dd8ce05e8ec4 | |
parent | ca462e51b3f4ef879421a6ee05a13660de714273 [diff] | |
parent | 3cf0d92f5b2e1b6113aad338f46f4fb345a37a73 [diff] |
Merge t-qpr-2022-12 Change-Id: I4cceaf3639d405dbd05ec881283a69015f9707c2
This crate contains protobuf code generator implementation and a protoc-gen-rust
protoc
plugin.
This crate:
protoc-gen-rust
plugin for protoc
commandThis crate is not meant to be used directly, in fact, it does not provide any public API (except for protoc-gen-rust
binary).
Code can be generated with either:
protoc-gen-rust
plugin for protoc
orprotoc-rust
crate (code generator which depends on protoc
binary for parsing of .proto
files)protobuf-codegen-pure
crate, similar API to protoc-rust
, but uses pure rust parser of .proto
files.protoc-gen-rust
plugin for protoc
When non-cargo build system is used, consider using standard protobuf code generation pattern: protoc
command does all the work of handling paths and parsing .proto
files. When protoc
is invoked with --rust_out=
option, it invokes protoc-gen-rust
plugin. provided by this crate.
When building with cargo, consider using protoc-rust
or protobuf-codegen-pure
crates.
protoc-gen-rust
if you have to(Note protoc
can be invoked programmatically with protoc crate)
protoc
binary.On OS X Homebrew can be used:
brew install protobuf
On Ubuntu, protobuf-compiler
package can be installed:
apt-get install protobuf-compiler
Protobuf is needed only for code generation, rust-protobuf
runtime does not use protobuf
library.
protoc-gen-rust
program (which is protoc
plugin)It can be installed either from source or with cargo install protobuf
command.
protoc-gen-rust
to $PATHIf you installed it with cargo, it should be
PATH="$HOME/.cargo/bin:$PATH"
protoc --rust_out . foo.proto
This will generate .rs files in current directory.
This is documentation for version 2 of the crate.
Version 3 of the crate (currently in development) encapsulates both protoc
and pure codegens in this crate.