agnostic_async_executor 0.2.2

Agnostic Rust Async Executor
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

use core::future::Future;
use std::rc::Rc;

use super::join_handle::*;

pub(crate) enum LocalExecutorInnerRuntime {
    #[cfg(feature = "tokio_executor")]
    TokioRuntime(tokio::task::LocalSet),
    #[cfg(feature = "async_std_executor")]
    AsyncStdRuntime,
    #[cfg(feature = "smol_executor")]
    SmolRuntime(Rc<async_executor::LocalExecutor<'static>>),
    #[cfg(feature = "futures_executor")]
    FuturesRuntime(futures::executor::LocalPool),
    #[cfg(feature = "wasm_bindgen_executor")]
    WasmBindgenRuntime
}

#[derive(Debug, Clone)]
pub(crate) enum LocalExecutorInnerHandle {
    #[cfg(feature = "tokio_executor")]
    TokioHandle,
    #[cfg(feature = "async_std_executor")]
    AsyncStdHandle,
    #[cfg(feature = "smol_executor")]
    SmolHandle(Rc<async_executor::LocalExecutor<'static>>),
    #[cfg(feature = "futures_executor")]
    FuturesHandle(futures::executor::LocalSpawner),
    #[cfg(feature = "wasm_bindgen_executor")]
    WasmBindgenHandle
}

use LocalExecutorInnerHandle::*;
use futures::task::LocalSpawnExt;

/// An executor capable of spawning futures that are not [Send].
/// It doesn't implement [Send] itself.
/// [Send]: https://doc.rust-lang.org/std/marker/trait.Send.html
#[derive(Debug, Clone)]
pub struct LocalAgnosticExecutor {
    pub(crate) inner: LocalExecutorInnerHandle
}

impl LocalAgnosticExecutor {

    /// Spawns a future that doesn't implement [Send].
    /// The spawned future will be executed on the same thread that called `spawn_local`.
    /// [Send]: https://doc.rust-lang.org/std/marker/trait.Send.html
    pub fn spawn_local<F, T>(&self, future: F) -> JoinHandle<T>
    where
        F: Future<Output = T> + 'static,
        T: Send + 'static,
    {
        let inner = match &self.inner {
            #[cfg(feature = "tokio_executor")]
            TokioHandle => {
                JoinHandleInner::<T>::Tokio(tokio::task::spawn_local(future))
            },
            #[cfg(feature = "async_std_executor")]
            AsyncStdHandle => {
                JoinHandleInner::<T>::AsyncStd(async_std::task::spawn_local(future))
            },
            #[cfg(feature = "smol_executor")]
            SmolHandle(executor) => {
                JoinHandleInner::<T>::Smol(executor.spawn(future))
            },
            #[cfg(feature = "futures_executor")]
            FuturesHandle(executor) => {
                use futures::future::FutureExt;
                let (future, handle) = future.remote_handle();
                executor.spawn_local(future).expect("Local spawn error");
                JoinHandleInner::<T>::RemoteHandle(handle)
            },
            #[cfg(feature = "wasm_bindgen_executor")]
            WasmBindgenHandle => {
                use futures::future::FutureExt;
                let (future, handle) = future.remote_handle();
                wasm_bindgen_futures::spawn_local(future);
                JoinHandleInner::<T>::RemoteHandle(handle)
            }
        };

        JoinHandle{inner}
    }
    
}