27 releases

0.8.3 Mar 28, 2021
0.8.2 Sep 20, 2020
0.8.1 May 25, 2020
0.6.2 Jan 14, 2020
0.0.1 Aug 23, 2016

#20 in #http2

Download history 2521/week @ 2022-11-28 1539/week @ 2022-12-05 1910/week @ 2022-12-12 3806/week @ 2022-12-19 1642/week @ 2022-12-26 4253/week @ 2023-01-02 2482/week @ 2023-01-09 2984/week @ 2023-01-16 2868/week @ 2023-01-23 3752/week @ 2023-01-30 2342/week @ 2023-02-06 2572/week @ 2023-02-13 4396/week @ 2023-02-20 3738/week @ 2023-02-27 6511/week @ 2023-03-06 7859/week @ 2023-03-13

22,771 downloads per month
Used in fewer than 17 crates

MIT/Apache

120KB
3K SLoC

grpc-rust

Build Status License crates.io

Rust implementation of gRPC protocol, under development.

Some development questions in FAQ.

Current status

It basically works, but not suitable for production use.

See grpc-examples/src/bin/greeter_{client,server}.rs. It can be tested for example with go client:

# start greeter server implemented in rust
$ cargo run --bin greeter_server

# ... or start greeter server implemented in go
$ go get -u google.golang.org/grpc/examples/helloworld/greeter_client
$ greeter_server

# start greeter client implemented in rust
$ cargo run --bin greeter_client rust
> message: "Hello rust"

# ... or start greeter client implemented in go
$ go get -u google.golang.org/grpc/examples/helloworld/greeter_client
$ greeter_client rust
> 2016/08/19 05:44:45 Greeting: Hello rust

Route guide

Route guide example implementation in grpc-rust is in grpc-examples folder.

How to generate rust code

There are two ways to generate rust code from .proto files

Invoke protoc programmatically with protoc-rust-grpc crate

(Recommended)

Have a look at readme in protoc-rust-grpc crate.

With protoc command and protoc-gen-rust-grpc plugin

Readme

Use generated protos in your project:

In Cargo.toml:

[dependencies]
grpc            = "~0.7"
protobuf        = "~2"
futures         = "~0.3"

[build-dependencies]
protoc-rust-grpc = "~0.7"

TODO

  • Fix performance
  • More tests
  • In particular, add more compatibility tests, they live in interop directory
  • Fix all TODO in sources
  • grpc-rs — alternative implementation of gRPC in Rust, a wrapper to C++ implementation
  • httpbis — implementation of HTTP/2, which is used by this implementation of gRPC
  • rust-protobuf — implementation of Google Protocol Buffers

Dependencies

~5.5MB
~94K SLoC