netwatcher 0.6.0

List network interfaces and watch for changes efficiently
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

use std::future::poll_fn;
use std::sync::{Arc, Condvar, Mutex};
use std::task::{Poll, Waker};

use crate::List;

#[derive(Default)]
pub(crate) struct AsyncCallbackState {
    latest: Option<List>,
    waker: Option<Waker>,
}

pub(crate) struct AsyncCallbackQueue {
    state: Mutex<AsyncCallbackState>,
    ready: Condvar,
}

pub(crate) fn empty_async_callback_queue() -> AsyncCallbackQueue {
    AsyncCallbackQueue::default()
}

impl Default for AsyncCallbackQueue {
    fn default() -> Self {
        Self {
            state: Mutex::new(AsyncCallbackState::default()),
            ready: Condvar::new(),
        }
    }
}

pub(crate) type SharedAsyncCallbackQueue = Arc<AsyncCallbackQueue>;

pub(crate) fn shared_async_callback_queue() -> SharedAsyncCallbackQueue {
    Arc::new(empty_async_callback_queue())
}

pub(crate) fn push_async_list(queue: &SharedAsyncCallbackQueue, list: List) {
    let mut state = queue.state.lock().unwrap();
    state.latest = Some(list);
    if let Some(waker) = state.waker.take() {
        waker.wake();
    }
    queue.ready.notify_one();
}

pub(crate) async fn next_async_list(queue: &SharedAsyncCallbackQueue) -> List {
    poll_fn(|cx| {
        let mut state = queue.state.lock().unwrap();
        if let Some(list) = state.latest.take() {
            Poll::Ready(list)
        } else {
            state.waker = Some(cx.waker().clone());
            Poll::Pending
        }
    })
    .await
}

pub(crate) fn wait_next_list(queue: &SharedAsyncCallbackQueue) -> List {
    let mut state = queue.state.lock().unwrap();
    loop {
        if let Some(list) = state.latest.take() {
            return list;
        }
        state = queue.ready.wait(state).unwrap();
    }
}