20 releases (8 breaking)
0.9.1 | Aug 12, 2022 |
---|---|
0.8.1 | Aug 5, 2022 |
0.8.0 | Apr 21, 2022 |
0.7.0 | Mar 3, 2022 |
0.5.2 | Nov 28, 2021 |
#518 in Concurrency
46 downloads per month
11KB
221 lines
norpc = not remote procedure call
Example
#[norpc::service]
trait HelloWorld {
fn hello(s: String) -> String;
}
struct HelloWorldApp;
#[async_trait::async_trait]
impl HelloWorld for HelloWorldApp {
async fn hello(&self, s: String) -> String {
format!("Hello, {}", s)
}
}
let rep = tokio_test::block_on(async {
use norpc::runtime::*;
let app = HelloWorldApp;
let svc = HelloWorldService::new(app);
let (chan, server) = ServerBuilder::new(svc).build();
tokio::spawn(server.serve(TokioExecutor));
let mut cli = HelloWorldClient::new(chan);
cli.hello("World".to_owned()).await
});
assert_eq!(rep, "Hello, World");
Usage
norpc = { version = "0.9", features = ["runtime", "tokio-executor"] }
- runtime: Use norpc runtime
- tokio-executor: Use tokio as async runtime.
- async-std-executor: Use async-std as async runtime.
Features
- Support in-process microservices through async channel.
- Async runtime agnostic.
- Support non-
Send
types. - Support request cancellation from client.
Performance
norpc is about 2x faster than google/tarpc.
To compare the pure overhead, he benchmark program launches a no-op server and send requests from the client.
noop request/1 time: [8.9181 us 8.9571 us 9.0167 us]
noop request (tarpc)/1 time: [15.476 us 15.514 us 15.554 us]
Author
Akira Hayakawa (@akiradeveloper)
Dependencies
~1–12MB
~149K SLoC