5 releases

0.2.0 Nov 6, 2024
0.1.3 Jul 3, 2024
0.1.2 Jul 3, 2024
0.1.1 Mar 11, 2022
0.1.0 Mar 11, 2022

#371 in Asynchronous

Download history 8/week @ 2024-08-22 9/week @ 2024-08-29 59/week @ 2024-09-05 43/week @ 2024-09-12 80/week @ 2024-09-19 62/week @ 2024-09-26 26/week @ 2024-10-03 131/week @ 2024-10-10 349/week @ 2024-10-17 237/week @ 2024-10-24 280/week @ 2024-10-31 431/week @ 2024-11-07 455/week @ 2024-11-14 386/week @ 2024-11-21 578/week @ 2024-11-28 685/week @ 2024-12-05

2,156 downloads per month
Used in groupcache

MIT/Apache

14KB
275 lines

Singleflight Async

Crates.io MIT/Apache-2 licensed

Singleflight in async style.

Key Features

  • Execute an async task only once for the same key at the same time.
  • Cancel safe when the task is dropped.
  • Not requires the future to be Send/Sync, or 'static.
  • Works for all kind of runtimes including tokio, monoio, or others.

Example

use singleflight_async::SingleFlight;

#[tokio::main]
async fn main() {
    let group = SingleFlight::new();
    let mut futures = Vec::new();
    for _ in 0..10 {
        futures.push(group.work("key", || async {
            println!("will sleep to simulate async task");
            tokio::time::sleep(std::time::Duration::from_millis(100)).await;
            println!("real task done");
            "my-result"
        }));
    }

    let begin = std::time::Instant::now();
    for fut in futures.into_iter() {
        assert_eq!(fut.await, "my-result");
        println!("task finished");
    }
    println!("time elapsed: {:?}", begin.elapsed());
}

The output will be like:

will sleep to simulate async task
real task done
task finished
task finished
task finished
task finished
task finished
task finished
task finished
task finished
task finished
task finished
time elapsed: 100.901321ms

Dependencies

~2.4–8MB
~58K SLoC