https://github.com/oguzbilgener/bmrng
An async MPSC request-response channel for Tokio
https://github.com/oguzbilgener/bmrng
async mpsc tokio tokio-rs
Last synced: 11 months ago
JSON representation
An async MPSC request-response channel for Tokio
- Host: GitHub
- URL: https://github.com/oguzbilgener/bmrng
- Owner: oguzbilgener
- License: other
- Created: 2020-11-29T22:30:20.000Z (over 5 years ago)
- Default Branch: master
- Last Pushed: 2022-10-20T04:31:07.000Z (over 3 years ago)
- Last Synced: 2025-08-02T07:37:56.829Z (11 months ago)
- Topics: async, mpsc, tokio, tokio-rs
- Language: Rust
- Homepage: https://docs.rs/bmrng
- Size: 99.6 KB
- Stars: 13
- Watchers: 1
- Forks: 1
- Open Issues: 2
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# bmrng 🪃
[](https://crates.io/crates/bmrng)
[](https://docs.rs/bmrng)
[](https://coveralls.io/github/oguzbilgener/bmrng)
[](https://deps.rs/repo/github/oguzbilgener/bmrng/status.svg)
An async MPSC request-response channel for Tokio, where you can send a response to the sender.
Inspired by [crossbeam_requests](https://docs.rs/crate/crossbeam_requests).
### Example
```rust
#[tokio::main]
async fn main() {
let buffer_size = 100;
let (tx, mut rx) = bmrng::channel::(buffer_size);
tokio::spawn(async move {
while let Ok((input, mut responder)) = rx.recv().await {
if let Err(err) = responder.respond(input * input) {
println!("sender dropped the response channel");
}
}
});
for i in 1..=10 {
if let Ok(response) = tx.send_receive(i).await {
println!("Requested {}, got {}", i, response);
assert_eq!(response, i * i);
}
}
}
```
#### Request Timeout
It is also possible to create a channel with a request timeout:
```rust
use tokio::time::{Duration, sleep};
#[tokio::main]
async fn main() {
let (tx, mut rx) = bmrng::channel_with_timeout::(100, Duration::from_millis(100));
tokio::spawn(async move {
match rx.recv().await {
Ok((input, mut responder)) => {
sleep(Duration::from_millis(200)).await;
let res = responder.respond(input * input);
assert_eq!(res.is_ok(), true);
}
Err(err) => {
println!("all request senders dropped");
}
}
});
let response = tx.send_receive(8).await;
assert_eq!(response, Err(bmrng::error::RequestError::::RecvTimeoutError));
}
```
#### Unbounded Channel
There is also an unbounded alternative, `bmrng::unbounded_channel()` with sync `.send()` calls.