dope-runtime 0.34.0

Thread-per-core execution and process lifecycle for dope
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

use clock::{Bound, End, Expiring as _, Time as _};
use dope_core::driver::schedule;
use drive::{clock, turn};
use turn::scope;

use crate::executor::{drain, drive, raw};

pub(crate) fn run<'app, 'd: 'app, D, S, C>(
    mut state: scope::Scope<'_, '_, 'app, 'd, D, S>,
    source: Bound<C, End>,
    mut shutdown: impl FnMut() -> turn::Status,
) -> Result<drain::Outcome, drive::Error>
where
    D: raw::Drain<'d>,
    C: clock::Source,
{
    let tick = source.start();
    let ready = state.next_app(tick, &mut shutdown)?;
    ready.begin_drain();
    loop {
        let tick = match source.tick() {
            Ok(tick) => tick,
            Err(clock::Elapsed) => {
                let tick = source.start();
                let ready = state.next_app(tick, &mut shutdown)?;
                ready.force_drain();
                return Ok(drain::Outcome::Forced);
            }
        };
        let Some(idle) = state.next_app(tick, &mut shutdown)?.park().sync()? else {
            continue;
        };
        let drain = idle.drain();
        if idle.is_quiet() && matches!(drain, schedule::Progress::Quiescent) {
            return Ok(drain::Outcome::Quiesced);
        }
        let progress = idle.progress().reduce(drain);
        idle.wait(progress, source)?;
    }
}