commit | 5a721e9bef4bd141966ed67810520cf3b4ef054e | [log] [tgz] |
---|---|---|
author | Linux Build Service Account <lnxbuild@localhost> | Sun Jan 15 12:07:18 2023 -0800 |
committer | Linux Build Service Account <lnxbuild@localhost> | Sun Jan 15 12:07:18 2023 -0800 |
tree | eda2c3bcc49d645d0edc2b67d1b0dd8ce05e8ec4 | |
parent | 8f0419ace458261b94fbba158e4996ce2f1efee6 [diff] | |
parent | 7964f3db648bbb5e5bcc30813e5ac569af71557f [diff] |
Merge 7964f3db648bbb5e5bcc30813e5ac569af71557f on remote branch Change-Id: I16d7a517563c261a49b8f57191012ee446898691
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.