sark-core 0.24.0

Fiber-free request, route, dispatch, and lifecycle core for Sark
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

use dope_core::driver::schedule::app;

use crate::manifold::server::{
    self, Event,
    drain::{self, Empty, Progress},
};

#[doc(hidden)]
pub struct Events<'turn, 'd> {
    share: app::Share<'turn, 'd>,
    progress: Progress,
}

impl<'turn, 'd> Events<'turn, 'd> {
    pub fn fair<T>(
        work: app::Work<'turn, 'd>,
        run: impl for<'scope> FnOnce(Events<'scope, 'd>) -> T,
    ) -> T {
        work.share::<2, _>(|share| {
            run(Events {
                share,
                progress: Progress::default(),
            })
        })
    }

    pub fn next_ready<T>(
        &mut self,
        acquire: impl FnOnce() -> Option<T>,
    ) -> Result<Option<T>, Empty> {
        match self.take(|| acquire().ok_or(Empty)) {
            Some(item) => item.map(Some),
            None => Ok(None),
        }
    }

    /// Admits one ready event before its owner is consumed.
    pub fn permit(&mut self) -> Option<app::Permit<'_, 'd>> {
        match self.share.work().permit() {
            Some(permit) => {
                self.progress.record();
                Some(permit)
            }
            None => {
                self.progress.exhaust();
                None
            }
        }
    }

    fn take<T>(&mut self, take: impl FnOnce() -> T) -> Option<T> {
        Some(self.permit()?.run(take))
    }

    pub fn next<C>(&mut self, conn: &mut C) -> Option<Event<C>>
    where
        C: server::Connection,
    {
        let ready = conn.ready()?;
        self.take(|| drain::Ready::take(ready))
    }

    pub fn finish(self) -> Progress {
        self.progress
    }
}

const _: () = {
    assert!(core::mem::size_of::<Events<'static, 'static>>() == 2 * core::mem::size_of::<usize>());
    assert!(core::mem::align_of::<Events<'static, 'static>>() == core::mem::align_of::<usize>());
};