maf 0.1.0-alpha.6

MAF is an authoritative realtime framework for writing simple, secure, and scalable apps.
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

mod gen_vec;
mod runtime;
mod task;
pub mod timers;
mod waker;

pub use futures_util;
use std::{
    future::{Future, IntoFuture},
    pin::Pin,
    task::Poll,
};
use wasi::io::poll::Pollable;

use runtime::JoinHandle;
pub use runtime::Runtime;
use timers::SleepFuture;

/// Spawns a new asynchronous task on the current runtime.
pub fn spawn<T: IntoFuture + 'static>(fut: T) -> JoinHandle<T::Output> {
    Runtime::current().spawn(fut)
}

/// Sleeps until the specified instant.
pub fn sleep_until(instant: std::time::Instant) -> SleepFuture {
    let duration = instant
        .checked_duration_since(std::time::Instant::now())
        .unwrap_or_default();
    SleepFuture::new(duration)
}

/// Sleeps for the specified duration.
pub fn sleep(duration: std::time::Duration) -> SleepFuture {
    SleepFuture::new(duration)
}

#[must_use]
pub struct WaitForPollable {
    pollable: Option<Pollable>,
}

/// Waits for a [`Pollable`] to become ready. Useful for waiting on WASI I/O operations where
/// getting a result from I/O is handled by a separate method.
pub fn wait_for(pollable: Pollable) -> WaitForPollable {
    WaitForPollable {
        pollable: Some(pollable),
    }
}

impl Future for WaitForPollable {
    type Output = ();

    fn poll(mut self: Pin<&mut Self>, cx: &mut std::task::Context<'_>) -> Poll<Self::Output> {
        if self.pollable.as_ref().map(|p| p.ready()).unwrap_or(true) {
            Poll::Ready(())
        } else {
            Runtime::new_waker(
                cx,
                self.pollable.take().expect("pollable not set"),
                Some("WaitForPollable"),
            );

            Poll::Pending
        }
    }
}