catty

Crates.iocatty
lib.rscatty
version0.1.5
sourcesrc
created_at2020-09-10 10:04:07.283779
updated_at2022-06-20 07:53:26.300972
descriptionSend and await a value asynchronously
homepage
repositoryhttps://github.com/Restioson/catty
max_upload_size
id286969
size27,472
Restioson (Restioson)

documentation

https://docs.rs/catty

README

catty

a picture of a slingshot

Send a value synchronously and asynchronously wait for it. Catty is faster, simpler, and more lightweight than futures::oneshot, which is slightly more flexible.

Example

let (tx, rx) = catty::oneshot();
tx.send("Hello!");
assert_eq!(rx.await, Ok("Hello!"));

Benchmarks

To run the benchmarks with Criterion, simply do cargo bench. On my machine, the results are as follows:

create-futures          time:   [70.934 ns 70.979 ns 71.045 ns]
create-catty            time:   [32.549 ns 32.594 ns 32.650 ns]
oneshot-futures         time:   [146.45 ns 146.76 ns 147.09 ns]
oneshot-catty           time:   [98.497 ns 99.065 ns 99.686 ns]
send-futures            time:   [80.163 ns 80.384 ns 80.680 ns]
send-catty              time:   [39.064 ns 39.206 ns 39.354 ns]
Commit count: 14

cargo fmt