async-rt 0.1.10

A small library designed to utilize async executors through an common API while extending features.
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

use crate::{Executor, ExecutorBlocking, JoinHandle};
use std::future::Future;

/// Executor that switches between [`TokioExecutor`](crate::rt::tokio::TokioExecutor), [`ThreadpoolExecutor`](crate::rt::threadpool::ThreadpoolExecutor) and [`WasmExecutor`](crate::rt::wasm::WasmExecutor) at compile time.
/// * If the target is non-wasm32 and the "tokio" feature is enabled, [`tokio`] would be used.
/// * if the target is non-wasm32 and the "threadpool" feature is enabled with [`tokio`] feature disabled, [`futures`] [`ThreadPool`](futures::executor::ThreadPool) will be used.
/// * If the target is wasm32, [`wasm-bindgen-futures`] would be used.
#[derive(Clone, Copy, Debug, PartialOrd, PartialEq, Eq)]
pub struct GlobalExecutor;

impl Executor for GlobalExecutor {
    #[cfg(all(feature = "tokio", not(target_arch = "wasm32")))]
    fn spawn<F>(&self, future: F) -> JoinHandle<F::Output>
    where
        F: Future + Send + 'static,
        F::Output: Send + 'static,
    {
        crate::rt::tokio::TokioExecutor.spawn(future)
    }

    #[cfg(all(feature = "threadpool", not(feature = "tokio")))]
    fn spawn<F>(&self, future: F) -> JoinHandle<F::Output>
    where
        F: Future + Send + 'static,
        F::Output: Send + 'static,
    {
        crate::rt::threadpool::ThreadPoolExecutor.spawn(future)
    }

    #[cfg(target_arch = "wasm32")]
    fn spawn<F>(&self, future: F) -> JoinHandle<F::Output>
    where
        F: Future + Send + 'static,
        F::Output: Send + 'static,
    {
        crate::rt::wasm::WasmExecutor.spawn(future)
    }

    #[cfg(all(
        not(feature = "threadpool"),
        not(feature = "tokio"),
        not(target_arch = "wasm32")
    ))]
    fn spawn<F>(&self, _: F) -> JoinHandle<F::Output>
    where
        F: Future + Send + 'static,
        F::Output: Send + 'static,
    {
        unreachable!()
    }
}

impl ExecutorBlocking for GlobalExecutor {
    #[cfg(all(feature = "tokio", not(target_arch = "wasm32")))]
    fn spawn_blocking<F, R>(&self, f: F) -> JoinHandle<R>
    where
        F: FnOnce() -> R + Send + 'static,
        R: Send + 'static,
    {
        crate::rt::tokio::TokioExecutor.spawn_blocking(f)
    }

    #[cfg(all(feature = "threadpool", not(feature = "tokio")))]
    fn spawn_blocking<F, R>(&self, f: F) -> JoinHandle<R>
    where
        F: FnOnce() -> R + Send + 'static,
        R: Send + 'static,
    {
        crate::rt::threadpool::ThreadPoolExecutor.spawn_blocking(f)
    }

    #[cfg(target_arch = "wasm32")]
    fn spawn_blocking<F, R>(&self, f: F) -> JoinHandle<R>
    where
        F: FnOnce() -> R + Send + 'static,
        R: Send + 'static,
    {
        crate::rt::wasm::WasmExecutor.spawn_blocking(f)
    }

    #[cfg(all(
        not(feature = "threadpool"),
        not(feature = "tokio"),
        not(target_arch = "wasm32")
    ))]
    fn spawn_blocking<F, R>(&self, _: F) -> JoinHandle<R>
    where
        F: FnOnce() -> R + Send + 'static,
        R: Send + 'static,
    {
        unimplemented!()
    }
}