10 unstable releases (3 breaking)
new 0.8.3 | Apr 20, 2024 |
---|---|
0.8.1 | Mar 13, 2024 |
0.4.2 |
|
0.3.2 | May 24, 2023 |
0.2.0 |
|
#85 in Asynchronous
6,966 downloads per month
Used in 28 crates
(3 directly)
39KB
390 lines
wg
Introduction
By default, blocking version WaitGroup
is enabled.
If you are using tokio
, you need to enable tokio
feature in your Cargo.toml
and use wg::tokio::AsyncWaitGroup
.
If you are using other async runtime, you need to
enbale future
feature in your Cargo.toml
and use wg::future::AsyncWaitGroup
.
Sync
[dependencies]
wg = "0.8"
tokio
An async implementation for tokio
runtime.
[dependencies]
wg = { version = "0.8", features = ["tokio"] }
future
A more generic async implementation.
[dependencies]
wg = { version = "0.8", features = ["future"] }
Instruction
Sync
use wg::WaitGroup;
use std::sync::Arc;
use std::sync::atomic::{AtomicUsize, Ordering};
use std::time::Duration;
use std::thread::{spawn, sleep};
fn main() {
let wg = WaitGroup::new();
let ctr = Arc::new(AtomicUsize::new(0));
for _ in 0..5 {
let ctrx = ctr.clone();
let t_wg = wg.add(1);
spawn(move || {
// mock some time consuming task
sleep(Duration::from_millis(50));
ctrx.fetch_add(1, Ordering::Relaxed);
// mock task is finished
t_wg.done();
});
}
wg.wait();
assert_eq!(ctr.load(Ordering::Relaxed), 5);
}
tokio
use wg::tokio::AsyncWaitGroup;
use std::sync::Arc;
use std::sync::atomic::{AtomicUsize, Ordering};
use tokio::{spawn, time::{sleep, Duration}};
#[tokio::main]
async fn main() {
let wg = AsyncWaitGroup::new();
let ctr = Arc::new(AtomicUsize::new(0));
for _ in 0..5 {
let ctrx = ctr.clone();
let t_wg = wg.add(1);
spawn(async move {
// mock some time consuming task
sleep(Duration::from_millis(50)).await;
ctrx.fetch_add(1, Ordering::Relaxed);
// mock task is finished
t_wg.done();
});
}
wg.wait().await;
assert_eq!(ctr.load(Ordering::Relaxed), 5);
}
async-io
use wg::future::AsyncWaitGroup;
use std::sync::Arc;
use std::sync::atomic::{AtomicUsize, Ordering};
use std::time::Duration;
use async_std::task::{spawn, block_on, sleep};
fn main() {
block_on(async {
let wg = AsyncWaitGroup::new();
let ctr = Arc::new(AtomicUsize::new(0));
for _ in 0..5 {
let ctrx = ctr.clone();
let t_wg = wg.add(1);
spawn(async move {
// mock some time consuming task
sleep(Duration::from_millis(50)).await;
ctrx.fetch_add(1, Ordering::Relaxed);
// mock task is finished
t_wg.done();
});
}
wg.wait().await;
assert_eq!(ctr.load(Ordering::Relaxed), 5);
});
}
Acknowledgements
- Inspired by Golang sync.WaitGroup and
crossbeam_utils::WaitGroup
.
License
Licensed under either of Apache License, Version 2.0 or MIT license at your option. Unless you explicitly state otherwise, any contribution intentionally submitted for inclusion in this project by you, as defined in the Apache-2.0 license, shall be dual licensed as above, without any additional terms or conditions.Dependencies
~0.5–14MB
~140K SLoC