Gitiles
Code Review Sign In
gerrit-public.fairphone.software / platform / external / rust / crates / protobuf-codegen / 878a689fbc44656329651c5397d909782b63a3ee
commit878a689fbc44656329651c5397d909782b63a3ee[log] [tgz]
authorJulien Desprez <jdesprez@google.com>Wed Feb 10 05:15:30 2021 +0000
committerAutomerger Merge Worker <android-build-automerger-merge-worker@system.gserviceaccount.com>Wed Feb 10 05:15:30 2021 +0000
tree85b2bca23b8a8bba83dc6c5141257c75bfe83e4f
parent3d4a67603ef7dfa3e248e89503175f425bf4fb65 [diff]
parentaf4529ec5abb0e01f2f9fb85e73e3fb869664ed5 [diff]
Clean up rust_test_host TEST_MAPPING after default update am: 5e39018bbf am: af4529ec5a

Original change: https://android-review.googlesource.com/c/platform/external/rust/crates/protobuf-codegen/+/1582279

MUST ONLY BE SUBMITTED BY AUTOMERGER

Change-Id: I041047e92b7fd3f197c8d46f31bc688ab19df666
tree: 85b2bca23b8a8bba83dc6c5141257c75bfe83e4f
  1. src/
  2. LICENSE ⇨ LICENSE.txt
  3. NOTICE ⇨ LICENSE
  4. .cargo_vcs_info.json
  5. Android.bp
  6. Cargo.lock
  7. Cargo.toml
  8. Cargo.toml.orig
  9. LICENSE.txt
  10. METADATA
  11. MODULE_LICENSE_MIT
  12. OWNERS
  13. README.android
  14. README.md
README.md

protobuf-codegen

This crate contains protobuf code generator and a protoc-gen-rust protoc plugin.

protoc-gen-rust

protoc-gen-rust implements standard protobuf protoc plugin conventions.

Probably you do not want to use it directly in Rust environment, there are easier to use alternatives:

  • protoc-rust crate which can be invoked programmatically from build.rs of your project which requires only protoc in $PATH but not protoc-gen-rust.
  • protobuf-codegen-pure crate which behaves like protoc-rust, but does not depend on protoc binary

But if you really want to use that plugin, here's the instruction

(Note protoc can be invoked programmatically with protoc crate)

  1. Install protobuf for 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.

  1. Install protoc-gen-rust program (which is protoc plugin)

It can be installed either from source or with cargo install protobuf command.

  1. Add protoc-gen-rust to $PATH

If you installed it with cargo, it should be

PATH="$HOME/.cargo/bin:$PATH"
  1. Generate .rs files:
protoc --rust_out . foo.proto

This will generate .rs files in current directory.