grpc-rust
Rust implementation of gRPC protocol, under development.
Some development questions in FAQ.
Current status
Client and server without streaming can be done with rust-grpc,
see grpc-examples/src/bin/greeter_{client,server}{,_async}.rs
. It can be tested
for example with go client:
# start greeter server implemented in rust
$ cargo run --bin greeter_server
# .. or start async server
$ cargo run --bin greeter_server_async
# ... 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 async client
$ cargo run --bin greeter_client_async 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
Client and server are implemented asynchronously, and sync versions are thin wrappers around async counterparts.
How to use gRPC compiler
Build & install Rust protobuf compiler:
This command installs protoc-gen-rust
to ~/.cargo/bin
, which
should be added to $PATH
.
Build & install gRPC compiler:
Installs protoc-gen-rust-grpc
to ~/.cargo/bin
.
Compile your proto & gRPC to Rust:
Use compiled protos in your project:
In Cargo.toml:
[dependencies]
grpc = { git = "https://github.com/stepancheg/grpc-rust" }
protobuf = { git = "http://github.com/stepancheg/rust-protobuf" }
futures = "0.1"
futures-cpupool = "0.1"
In lib.rs
or main.rs
(or any other submodule):
extern crate protobuf;
extern crate grpc;
extern crate futures;
extern crate futures_cpupool;
Compiling protos manually is silly. Can Cargo do all of above for me?
It seems possible, but looks like it requires some more work.
See https://github.com/stepancheg/rust-protobuf/issues/57 and https://github.com/dwrensha/capnpc-rust for more details.
TODO
- Tests
- Proper error handling
- Upload to crates
- Performance