#grpc #bindings

sys grpcio-sys

FFI bindings to gRPC c core library

38 releases

0.13.0+1.56.2-patched Aug 25, 2023
0.12.1+1.46.5-patched Feb 14, 2023
0.12.0+1.46.5-patched Nov 4, 2022
0.10.3+1.44.0-patched Jun 28, 2022
0.1.0 Jul 27, 2017

#1612 in Network programming

Download history 5178/week @ 2023-11-04 5019/week @ 2023-11-11 4310/week @ 2023-11-18 4520/week @ 2023-11-25 4173/week @ 2023-12-02 4235/week @ 2023-12-09 3420/week @ 2023-12-16 2309/week @ 2023-12-23 3394/week @ 2023-12-30 4974/week @ 2024-01-06 4915/week @ 2024-01-13 4735/week @ 2024-01-20 3906/week @ 2024-01-27 3631/week @ 2024-02-03 3907/week @ 2024-02-10 3788/week @ 2024-02-17

15,894 downloads per month
Used in 65 crates (via grpcio)

Apache-2.0

20MB
416K SLoC

C++ 263K SLoC // 0.1% comments C 61K SLoC // 0.1% comments Python 29K SLoC // 0.2% comments Go 17K SLoC // 0.1% comments Unison 13K SLoC M4 10K SLoC // 0.2% comments Shell 7K SLoC // 0.5% comments Rust 5K SLoC // 0.0% comments Bitbake 3K SLoC // 0.1% comments Forge Config 2K SLoC // 0.6% comments Swift 2K SLoC // 0.0% comments Lua 1.5K SLoC // 0.1% comments Batch 803 SLoC // 0.0% comments Prolog 422 SLoC GNU Style Assembly 349 SLoC PHP 335 SLoC // 0.8% comments XSL 186 SLoC C# 181 SLoC // 0.3% comments Perl 155 SLoC // 0.1% comments Automake 128 SLoC // 0.2% comments Alex 84 SLoC Pan 44 SLoC // 0.1% comments SWIG 32 SLoC Ruby 23 SLoC // 0.7% comments AWK 18 SLoC // 0.3% comments CUDA 3 SLoC Objective-C 1 SLoC

Contains (JAR file, 55KB) gradle-wrapper.jar

gRPC-rs

gRPC-rs is a Rust wrapper of gRPC Core. gRPC is a high performance, open source universal RPC framework that puts mobile and HTTP/2 first.

Crates.io docs.rs Build Status Build Status

Status

This project is still under development. The following features with the check marks are supported:

  • Basic asynchronous unary/steaming call
  • SSL
  • Generic call
  • Connection level compression
  • Interoperability test
  • QPS benchmark
  • Custom metadata
  • Health check
  • Reflection
  • Authentication
  • Load balance, client side is fully supported, server side load report is not implemented yet.

Prerequisites

  • CMake >= 3.8.0
  • Rust >= 1.36.0
  • binutils >= 2.22
  • LLVM and Clang >= 3.9 if you need to generate bindings at compile time.

For Linux and MacOS, you also need to install gcc 7.3+ (or clang 6+) too.

Bindings are pre-generated for x86_64/arm64 Linux. For other platforms, bindings are generated at compile time.

For Windows, you also need to install following software:

  • Active State Perl
  • yasm
  • Visual Studio 2015+

Build

$ cargo xtask submodule # if you just cloned the repository
$ cargo build

Error linking OpenSSL

If you're getting linker errors when building your project using gRPC-rs, head down to the openssl feature section for a possible fix.

Usage

To generate the sources from proto files:

Option 1 - Manual Generation

  1. Install the protobuf compiler:
$ cargo install protobuf-codegen
  1. Install the gRPC compiler:
$ cargo install grpcio-compiler
  1. Generate the sources:
$ protoc --rust_out=. --grpc_out=. --plugin=protoc-gen-grpc=`which grpc_rust_plugin` example.proto

Option 2 - Programmatic Generation

Programmatic generation can be used to generate Rust modules from proto files via your build.rs by using protoc-grpcio.

For more information and examples see README.

To include this project as a dependency:

[dependencies]
grpcio = "0.13"

Feature boringssl

boringssl feature enables support for TLS encryption and some authentication mechanism. When you do not need it, for example when working in intranet, you can disable it by using the following configuration:

[dependencies]
grpcio = { version = "0.13", default-features = false, features = ["protobuf-codec"] }

Feature prost-codec and protobuf-codec

gRPC-rs uses protobuf crate by default. If you want to use prost instead, you can enable prost-codec feature. You probably only want to enable only one of the two features. Though grpcio is completely fine with both features enabled at the same time, grpcio-compiler will not going to work as expected.

Feature openssl and openssl-vendored

gRPC-rs comes vendored with gRPC Core, which by default uses BoringSSL instead of OpenSSL. This may cause linking issues due to symbol clashes and/or missing symbols when another one of your dependencies uses OpenSSL. To resolve this, you can tell gRPC-rs to use OpenSSL too by specifying "openssl" in your Cargo.toml's features list for gprcio, which requires openssl (>=1.0.2). E.g.:

[dependencies]
grpcio = { version = "0.13", features = ["openssl"] }

Feature openssl-vendored is the same as feature openssl except it will build openssl from bundled sources.

Performance

See benchmark to find out how to run a benchmark by yourself.

Cross Compile

See cross_compile

Contributing

Make sure to format and test the code before sending a PR.

If the content in grpc-sys/grpc is updated, you may need to regenerate bindings:

$ cargo xtask bindgen

Dependencies

~4–7MB
~119K SLoC