https://github.com/stepancheg/grpc-rust

Rust implementation of gRPC
https://github.com/stepancheg/grpc-rust

grpc http2 protobuf tokio-rs

Last synced: about 1 month ago
JSON representation

Rust implementation of gRPC

• Host: GitHub
• URL: https://github.com/stepancheg/grpc-rust
• Owner: stepancheg
• License: mit
• Archived: true
• Created: 2015-06-28T19:26:35.000Z (over 9 years ago)
• Default Branch: master
• Last Pushed: 2024-04-08T23:37:29.000Z (7 months ago)
• Last Synced: 2024-09-26T03:32:54.139Z (about 1 month ago)
• Topics: grpc, http2, protobuf, tokio-rs
• Language: Rust
• Homepage:
• Size: 1.25 MB
• Stars: 1,376
• Watchers: 33
• Forks: 124
• Open Issues: 60
• Metadata Files:
  • Readme: README.md
  • Changelog: CHANGELOG.md
  • License: LICENSE.txt

Awesome Lists containing this project

• awesome-grpc - grpc-rust - Rust implementation of gRPC (Language-Specific / Rust)

README

        
grpc-rust

=========

# The project is dead; long live the new project

gRPC team is [developing shiny new gRPC implementation in Rust](https://groups.google.com/g/grpc-io/c/ExbWWLaGHjI/m/TJssglLiBgAJ),

`grpc` crate name is transferred to them.

This code is no longer maintained.

# Original README.md

[![Build Status](https://img.shields.io/travis/stepancheg/grpc-rust.svg)](https://travis-ci.org/stepancheg/grpc-rust)

[![License](https://img.shields.io/crates/l/grpc.svg)](https://github.com/stepancheg/grpc-rust/blob/master/LICENSE.txt)

[![crates.io](https://img.shields.io/crates/v/grpc.svg)](https://crates.io/crates/grpc)

Rust implementation of [gRPC](http://www.grpc.io/) protocol, under development.

Some development questions in [FAQ](/docs/FAQ.md).

## 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](https://github.com/grpc/grpc-go/tree/master/examples/helloworld):

```shell

# 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](https://github.com/grpc/grpc-go/tree/master/examples/route_guide)

example implementation in grpc-rust is in

[grpc-examples folder](https://github.com/stepancheg/grpc-rust/tree/master/grpc-examples/route_guide).

## 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](https://github.com/stepancheg/grpc-rust/tree/master/protoc-rust-grpc).

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

[Readme](https://github.com/stepancheg/grpc-rust/tree/master/grpc-compiler)

### Use generated protos in your project

In Cargo.toml:

```ini

[dependencies]

grpc            = "~0.8"

protobuf        = "2.23"

futures         = "~0.3"

[build-dependencies]

protoc-rust-grpc = "~0.8"

```

## TODO

* Fix performance

* More tests

* In particular, add more compatibility tests, they live in `interop` directory

* Fix all TODO in sources

## Related projects

* [grpc-rs](https://github.com/pingcap/grpc-rs) — alternative implementation of gRPC in Rust,

  a wrapper to C++ implementation

* [httpbis](https://github.com/stepancheg/rust-http2) — implementation of HTTP/2,

  which is used by this implementation of gRPC

* [rust-protobuf](https://github.com/stepancheg/rust-protobuf/) — implementation of Google Protocol Buffers