Skip to content

Latest commit

 

History

History
31 lines (21 loc) · 2.17 KB

tonic.md

File metadata and controls

31 lines (21 loc) · 2.17 KB
Raw

Crate tonic

A Rust implementation of gRPC, a high performance, open source, general RPC framework that puts mobile and HTTP/2 first. And it is a gRPC over HTTP/2 implementation focused on:

  • high performance
  • interoperability
  • flexibility

And the library was created to have first class support of async/await and to act as a core building block for production systems wriiten in Rust.

Features Flags

  • transport Enable the fully featured, batteries included client and serber implementation based on the hyper, tower and tokio crate. Enabled by default.
  • channel Enables just the full featured channel/client portion of the transport feature
  • codegen Enables all the required exports and optional dependencies required for tonic-build. Enabled by default.
  • tls Enables the rustls based TLS options for the transport feature. Not enabled by default.
  • tls-roots Adds system trust roots to rustls based gRPC client using the rustls-native-certs crate. Not enabled by default.
  • tls-webpki-roots Add the standard trust roots from the webpki-roots crate to rustls based gRPC clients. Not enabled by default.
  • prost Enables the prost based gRPC Codec implementation
  • gzip Enables compressing requests, responses, and streams. Depends on flate2. Not enabled by default. Replaces the compression flag from earlier versions of tonic(<=0.7>).

Usage

Tower provides an abstraction layer, and generic implementation of various middleware. This menas that the tower crate on its own does not provide a working implementation of a network client ot server. Instead, Tower's Service trait provides an integration point between application code, libraries providing middleware implementations, and libraries that implement servers and/or clients for various network protocols.

Depending on your particulat use case, you might use Tower in several ways:

  • Implementing application logic for a networked program
  • Implementing middleware to add custom behavior to network clients and servers in a reusable manner
  • Implementing a network protocol