Bug: 158620710

Clone this repo:
  1. 57694ec Upgrade rust/crates/protobuf-codegen to 2.18.1 am: b62512d3c6 by Haibo Huang · 8 weeks ago master
  2. b62512d Upgrade rust/crates/protobuf-codegen to 2.18.1 by Haibo Huang · 8 weeks ago
  3. 2e060e3 Mark ab/6881855 as merged by Xin Li · 9 weeks ago
  4. 88522b5 Merge "TEST_MAPPING: test dependers of this crate" am: 70530b281d by Treehugger Robot · 3 months ago
  5. 70530b2 Merge "TEST_MAPPING: test dependers of this crate" by Treehugger Robot · 3 months ago


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


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

  1. Generate .rs files:
protoc --rust_out . foo.proto

This will generate .rs files in current directory.