ankurah-core 0.8.0

Core state management functionality for Ankurah
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 std::future::Future;

#[cfg(not(target_arch = "wasm32"))]
static RUNTIME_HANDLE: std::sync::OnceLock<tokio::runtime::Handle> = std::sync::OnceLock::new();

/// Inject a Tokio runtime handle for use by ankurah.
///
/// The handle is used as a fallback when `spawn` is called from threads
/// without a Tokio runtime context (e.g. GC/finalizer threads in FFI).
#[cfg(not(target_arch = "wasm32"))]
pub fn set_runtime_handle(handle: tokio::runtime::Handle) { RUNTIME_HANDLE.set(handle).ok(); }

/// Spawn a task.
///
/// On native, tries the thread-local runtime context first, then falls back
/// to the handle provided via [`set_runtime_handle`].
#[cfg(not(target_arch = "wasm32"))]
pub fn spawn<F>(future: F)
where
    F: Future + Send + 'static,
    <F as futures::Future>::Output: std::marker::Send,
{
    match tokio::runtime::Handle::try_current() {
        Ok(handle) => {
            handle.spawn(future);
        }
        Err(_) => {
            RUNTIME_HANDLE
                .get()
                .expect("task::spawn: no Tokio runtime context on this thread. Call ankurah::set_runtime_handle() at init time.")
                .spawn(future);
        }
    }
}

#[cfg(target_arch = "wasm32")]
pub fn spawn<F>(future: F)
where F: Future<Output = ()> + Send + 'static {
    wasm_bindgen_futures::spawn_local(future);
}