2 unstable releases
0.2.0 | Sep 27, 2023 |
---|---|
0.1.0 | Sep 1, 2023 |
#4 in #rotor
7KB
102 lines
Rotors
Rust PROTO
cols without the P
ain
Why should I use this library?
You probably shouldn't, because this library is under development and has not gone through serious scrutiny yet.
However, if you would like an easier way to use native Rust types inside a
tonic
project, this might be useful to you.
How should I use this library?
Instead of writing a gRPC xyz.proto
file and using the tonic-build
tools in your build.rs
,
you can just use a simple macro in your code, and let the macro do most of the heavy lifting!
use rotors::rotors;
use serde::{Deserialize, Serialize};
#[derive(Clone, Debug, Deserialize, Serialize)]
pub struct HelloRequest {
pub name: String,
}
#[derive(Clone, Debug, Deserialize, Serialize)]
pub struct HelloReply {
pub message: String,
}
rotors! {
package helloworld;
service Greeter {
rpc SayHello (super::HelloRequest) returns (super::HelloReply);
}
}
The rotors!()
macro will define two new rust modules, containing the tonic client
and server structures. From there onwards, everything will be just like
the tonic you are used to, except that you are finally free to write your
own enum
s without the tedious boilerplate required by gRPC.
When should I use this library?
When using rotors
you are creating some RPC code that is now NOT COMPATIBLE
with gRPC. If this is fine for you, then go for it!
On the other hand, if you are writing a big project, or want to communicate between instances running different versions of your software, or even sofware written in different languages, this crate won't be of much use to you.
Dependencies
~5–6.5MB
~118K SLoC