What is this?
tonic — a native Rust gRPC client and server implementation. It runs over HTTP/2 with first-class async/await support and is built as a core building block for production systems written in Rust.
tonic — a native Rust gRPC client and server implementation. It runs over HTTP/2 with first-class async/await support and is built as a core building block for production systems written in Rust.Is it a library I code against, or an app I deploy?A library, not a deployed app. It has three main parts: the generic gRPC implementation, a fast HTTP/2 implementation based on hyper and tokio, and prost-powered codegen that builds clients and servers from protobuf definitions.
A library, not a deployed app. It has three main parts: the generic gRPC implementation, a fast HTTP/2 implementation based on hyper and tokio, and prost-powered codegen that builds clients and servers from protobuf definitions.How do I get started with it?Start with the helloworld tutorial — a basic example aimed at first-time users — then routeguide for a complete example covering all features. The examples directory shows TLS, load balancing and bi-directional streaming.
Start with the helloworld tutorial — a basic example aimed at first-time users — then routeguide for a complete example covering all features. The examples directory shows TLS, load balancing and bi-directional streaming.What do I need installed besides Rust?Rust 1.88 or newer (the stated MSRV), plus protoc — the Protocol Buffers compiler — since some tonic-build APIs such as tonic_build::compile_protos() use it to compile .proto files.
Rust 1.88 or newer (the stated MSRV), plus protoc — the Protocol Buffers compiler — since some tonic-build APIs such as tonic_build::compile_protos() use it to compile .proto files.Is the master branch safe to build on right now?Not exactly: the master branch is currently preparing breaking changes. For the most recently released code, the README points to the 0.14.x branch.
Not exactly: the master branch is currently preparing breaking changes. For the most recently released code, the README points to the 0.14.x branch.What gRPC features does it support out of the box?Bi-directional streaming, TLS backed by rustls, load balancing, custom metadata, authentication and health checking, all on high-performance async I/O. A set of generic traits also lets it run over any HTTP/2 implementation and with any encoding.
Bi-directional streaming, TLS backed by rustls, load balancing, custom metadata, authentication and health checking, all on high-performance async I/O. A set of generic traits also lets it run over any HTTP/2 implementation and with any encoding.Why was tonic created instead of using an existing gRPC library?The README says it was created to have first-class async/await support and to act as a core building block for production systems written in Rust, layering its gRPC implementation on the tokio and hyper stack.
The README says it was created to have first-class async/await support and to act as a core building block for production systems written in Rust, layering its gRPC implementation on the tokio and hyper stack.Can it talk to gRPC services written in other languages?Yes. Interoperability is a listed design goal, and the repo ships a dedicated interop test suite exercising many gRPC features, so it works with standard-conformant gRPC implementations.
Yes. Interoperability is a listed design goal, and the repo ships a dedicated interop test suite exercising many gRPC features, so it works with standard-conformant gRPC implementations.What do tonic-health and tonic-reflection add?tonic-health implements the standard gRPC health checking service (and doubles as an example of unary and response-streaming calls), tonic-reflection adds gRPC reflection, and tonic-types provides gRPC Well Known Types utilities.
tonic-health implements the standard gRPC health checking service (and doubles as an example of unary and response-streaming calls), tonic-reflection adds gRPC reflection, and tonic-types provides gRPC Well Known Types utilities.What are similar projects?grpc-java, grpc-go, protobuf.js, flatbuffers, grpc-gateway, pingora, actix-web, kratos
grpc-java, grpc-go, protobuf.js, flatbuffers, grpc-gateway, pingora, actix-web, kratosWhich topics is it in?protocol-buffers, protobuf, http2, client, rpc, grpc, code-generation, async, tls, authentication, streaming, developers
protocol-buffers, protobuf, http2, client, rpc, grpc, code-generation, async, tls, authentication, streaming, developers