kithara-platform 0.0.1-alpha5

Cross-platform primitives (sync, time, thread) for native and wasm32.
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

use core::num::NonZeroUsize;
pub use std::time::Duration;

use crate::common::thread_id::thread_id_hash;

pub type Thread = std::thread::Thread;
pub type ThreadId = std::thread::ThreadId;
pub type JoinHandle<T> = std::thread::JoinHandle<T>;

#[inline]
pub(crate) fn yield_now() {
    std::thread::yield_now();
}

#[inline]
#[must_use]
pub fn is_worker_thread() -> bool {
    false
}

#[inline]
#[must_use]
pub fn is_main_thread() -> bool {
    true
}

#[inline]
pub fn assert_main_thread(_label: &str) {}

#[inline]
pub fn assert_not_main_thread(_label: &str) {}

#[inline]
#[must_use]
pub fn current() -> Thread {
    std::thread::current()
}

pub(crate) fn spawn<F, T>(f: F) -> JoinHandle<T>
where
    F: FnOnce() -> T + Send + 'static,
    T: Send + 'static,
{
    std::thread::spawn(f)
}

pub(crate) fn spawn_named_uncounted<F, T, N: Into<String>>(name: N, f: F) -> JoinHandle<T>
where
    F: FnOnce() -> T + Send + 'static,
    T: Send + 'static,
{
    std::thread::Builder::new()
        .name(name.into())
        .spawn(f)
        .expect("BUG: spawn_named must succeed; thread creation exhausted OS resources")
}

#[track_caller]
pub(crate) fn sleep(duration: Duration) {
    crate::no_block::forbid("thread::sleep");
    std::thread::sleep(duration);
}

#[track_caller]
pub fn park() {
    crate::no_block::forbid("thread::park");
    std::thread::park();
}

#[track_caller]
pub(crate) fn park_timeout(duration: Duration) {
    crate::no_block::forbid("thread::park_timeout");
    std::thread::park_timeout(duration);
}

pub(crate) fn unpark(thread: &Thread) {
    thread.unpark();
}

#[must_use]
pub fn current_thread_id() -> u64 {
    thread_id_hash(current().id())
}

#[must_use]
pub fn available_parallelism() -> Option<NonZeroUsize> {
    std::thread::available_parallelism().ok()
}