silkenweb 0.10.0

A library for building web 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
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125

//! Utilities for tacking time.
use silkenweb_macros::cfg_browser;

#[cfg_browser(true)]
mod arch {
    use std::{future::Future, pin::Pin, task, time::Duration};

    use futures::Stream;
    use gloo_timers::future::{IntervalStream, TimeoutFuture};
    use pin_project::pin_project;
    use wasm_bindgen::UnwrapThrowExt;

    #[derive(Debug)]
    #[pin_project]
    pub struct Sleep(#[pin] TimeoutFuture);

    impl Future for Sleep {
        type Output = ();

        fn poll(self: Pin<&mut Self>, cx: &mut task::Context<'_>) -> task::Poll<Self::Output> {
            self.project().0.poll(cx)
        }
    }

    pub fn sleep(duration: Duration) -> Sleep {
        Sleep(gloo_timers::future::sleep(duration))
    }

    #[derive(Debug)]
    #[pin_project]
    pub struct Interval(#[pin] IntervalStream);

    impl Stream for Interval {
        type Item = ();

        fn poll_next(
            self: Pin<&mut Self>,
            cx: &mut task::Context<'_>,
        ) -> task::Poll<Option<Self::Item>> {
            self.project().0.poll_next(cx)
        }

        fn size_hint(&self) -> (usize, Option<usize>) {
            (std::usize::MAX, None)
        }
    }

    pub fn interval(period: Duration) -> Interval {
        let period_ms = u32::try_from(period.as_millis())
            .expect_throw("failed to cast the duration into a u32 with Duration::as_millis.");
        Interval(IntervalStream::new(period_ms))
    }
}

#[cfg_browser(false)]
mod arch {
    use std::{future::Future, pin::Pin, task, time::Duration};

    use futures::{stream::Skip, Stream, StreamExt};
    use pin_project::pin_project;
    use tokio_stream::wrappers::IntervalStream;

    #[derive(Debug)]
    #[pin_project]
    pub struct Sleep(#[pin] tokio::time::Sleep);

    impl Future for Sleep {
        type Output = ();

        fn poll(self: Pin<&mut Self>, cx: &mut task::Context<'_>) -> task::Poll<Self::Output> {
            self.project().0.poll(cx)
        }
    }

    pub fn sleep(duration: Duration) -> Sleep {
        Sleep(tokio::time::sleep(duration))
    }

    #[derive(Debug)]
    #[pin_project]
    pub struct Interval(#[pin] Skip<IntervalStream>);

    impl Stream for Interval {
        type Item = ();

        fn poll_next(
            self: Pin<&mut Self>,
            cx: &mut task::Context<'_>,
        ) -> task::Poll<Option<Self::Item>> {
            self.project().0.poll_next(cx).map(|_| Some(()))
        }

        fn size_hint(&self) -> (usize, Option<usize>) {
            (usize::MAX, None)
        }
    }

    pub fn interval(period: Duration) -> Interval {
        Interval(IntervalStream::new(tokio::time::interval(period)).skip(1))
    }
}

/// A stream that yields `()` periodically.
///
/// Yield `()` every `period`. The first value will be produced after a delay of
/// `period`.
///
/// # Panics
///
/// If `duration` can't be converted into a [`u32`] in milliseconds.
pub use arch::interval;
/// Sleep for `duration`.
///
/// # Panics
///
/// If `duration` can't be converted into a [`u32`] in milliseconds.
pub use arch::sleep;
/// [`Stream`] for [`interval`]
///
/// [`Stream`]: futures::Stream
pub use arch::Interval;
/// [`Future`] for [`sleep`]
///
/// [`Future`]: std::future::Future
pub use arch::Sleep;