go 0.1.1

A runtime-agnostic Go-style concurrency library for Rust
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75

use std::sync::atomic::{AtomicUsize, Ordering};
use std::sync::Arc;

use event_listener::Event;

struct Inner {
    count: AtomicUsize,
    event: Event,
}

/// A synchronization primitive that waits for a group of tasks to complete.
#[derive(Clone)]
pub struct WaitGroup {
    inner: Arc<Inner>,
}

impl WaitGroup {
    pub fn new() -> Self {
        Self {
            inner: Arc::new(Inner {
                count: AtomicUsize::new(0),
                event: Event::new(),
            }),
        }
    }

    /// Increment the counter by `n`.
    pub fn add(&self, n: usize) {
        self.inner.count.fetch_add(n, Ordering::AcqRel);
    }

    /// Decrement the counter by 1. Wakes all waiters when counter reaches 0.
    pub fn done(&self) {
        let prev = self.inner.count.fetch_sub(1, Ordering::AcqRel);
        if prev == 1 {
            self.inner.event.notify(usize::MAX);
        }
    }

    /// Wait until the counter reaches zero.
    pub async fn wait(&self) {
        loop {
            if self.inner.count.load(Ordering::Acquire) == 0 {
                return;
            }
            let listener = self.inner.event.listen();
            if self.inner.count.load(Ordering::Acquire) == 0 {
                return;
            }
            listener.await;
        }
    }

    /// Create a guard that calls `done()` when dropped.
    pub fn guard(&self) -> WaitGroupGuard {
        WaitGroupGuard { wg: self.clone() }
    }
}

impl Default for WaitGroup {
    fn default() -> Self {
        Self::new()
    }
}

/// A guard that calls `WaitGroup::done()` when dropped.
pub struct WaitGroupGuard {
    wg: WaitGroup,
}

impl Drop for WaitGroupGuard {
    fn drop(&mut self) {
        self.wg.done();
    }
}