orx-parallel 4.0.0

Performant parallel computations with an expressive iterator API.
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
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146

use crate::pools::pool_impl::*;
#[cfg(feature = "std")]
use std::sync::LazyLock;

// PERSISTENT_POOL - Feature precedence:
// 1. wasm (strongest) - on wasm32 target
// 2. persistent-pool-rayon
// 3. transient-pool
// 4. default - BasicPool (if std) or SequentialPool (if no-std)

// 1. wasm on wasm32
#[cfg(all(feature = "std", feature = "wasm", target_arch = "wasm32"))]
static PERSISTENT_POOL: LazyLock<WasmWebPool> = LazyLock::new(Default::default);

// 2. persistent-pool-rayon (and not wasm on wasm32)
#[cfg(all(
    feature = "std",
    feature = "persistent-pool-rayon",
    not(all(feature = "wasm", target_arch = "wasm32")),
))]
static PERSISTENT_POOL: LazyLock<rayon_core::ThreadPool> =
    LazyLock::new(build_default_rayon_thread_pool);

// 3. transient-pool (and not wasm on wasm32, and not persistent-pool-rayon)
#[cfg(all(
    feature = "std",
    feature = "transient-pool",
    not(all(feature = "wasm", target_arch = "wasm32")),
    not(feature = "persistent-pool-rayon"),
))]
static PERSISTENT_POOL: LazyLock<OncePool> = LazyLock::new(Default::default);

// 4a. default with std (and not wasm on wasm32, and not persistent-pool-rayon, and not transient-pool)
#[cfg(all(
    feature = "std",
    not(all(feature = "wasm", target_arch = "wasm32")),
    not(feature = "persistent-pool-rayon"),
    not(feature = "transient-pool"),
))]
static PERSISTENT_POOL: LazyLock<BasicPool> = LazyLock::new(Default::default);

// 4b. default without std (fallback - sequential pool)
#[cfg(all(
    not(feature = "std"),
    not(all(feature = "wasm", target_arch = "wasm32")),
    not(feature = "persistent-pool-rayon"),
    not(feature = "transient-pool"),
))]
static PERSISTENT_POOL: SequentialPool = SequentialPool;

// DEFAULT POOL

// 1. wasm on wasm32
#[cfg(all(feature = "std", feature = "wasm", target_arch = "wasm32"))]
/// Default thread pool
pub type DefaultPool = &'static WasmWebPool;

// 2. persistent-pool-rayon (and not wasm on wasm32)
#[cfg(all(
    feature = "std",
    feature = "persistent-pool-rayon",
    not(all(feature = "wasm", target_arch = "wasm32")),
))]
/// Default thread pool
pub type DefaultPool = &'static rayon_core::ThreadPool;

// 3. transient-pool (and not wasm on wasm32, and not persistent-pool-rayon)
#[cfg(all(
    feature = "std",
    feature = "transient-pool",
    not(all(feature = "wasm", target_arch = "wasm32")),
    not(feature = "persistent-pool-rayon"),
))]
/// Default thread pool
pub type DefaultPool = &'static OncePool;

// 4a. default with std (and not wasm on wasm32, and not persistent-pool-rayon, and not transient-pool)
#[cfg(all(
    feature = "std",
    not(all(feature = "wasm", target_arch = "wasm32")),
    not(feature = "persistent-pool-rayon"),
    not(feature = "transient-pool"),
))]
/// Default thread pool
pub type DefaultPool = &'static BasicPool;

// 4b. default without std (fallback - sequential pool)
#[cfg(all(
    not(feature = "std"),
    not(all(feature = "wasm", target_arch = "wasm32")),
    not(feature = "persistent-pool-rayon"),
    not(feature = "transient-pool"),
))]
/// Default thread pool
pub type DefaultPool = &'static SequentialPool;

// GET POOL

// 1. wasm on wasm32
#[cfg(all(feature = "std", feature = "wasm", target_arch = "wasm32"))]
pub(crate) fn global_pool() -> DefaultPool {
    &PERSISTENT_POOL
}

// 2. persistent-pool-rayon (and not wasm on wasm32)
#[cfg(all(
    feature = "std",
    feature = "persistent-pool-rayon",
    not(all(feature = "wasm", target_arch = "wasm32")),
))]
pub(crate) fn global_pool() -> DefaultPool {
    &PERSISTENT_POOL
}

// 3. transient-pool (and not wasm on wasm32, and not persistent-pool-rayon)
#[cfg(all(
    feature = "std",
    feature = "transient-pool",
    not(all(feature = "wasm", target_arch = "wasm32")),
    not(feature = "persistent-pool-rayon"),
))]
pub(crate) fn global_pool() -> DefaultPool {
    &PERSISTENT_POOL
}

// 4a. default with std (and not wasm on wasm32, and not persistent-pool-rayon, and not transient-pool)
#[cfg(all(
    feature = "std",
    not(all(feature = "wasm", target_arch = "wasm32")),
    not(feature = "persistent-pool-rayon"),
    not(feature = "transient-pool"),
))]
pub(crate) fn global_pool() -> DefaultPool {
    &PERSISTENT_POOL
}

// 4b. default without std (fallback - sequential pool)
#[cfg(all(
    not(feature = "std"),
    not(all(feature = "wasm", target_arch = "wasm32")),
    not(feature = "persistent-pool-rayon"),
    not(feature = "transient-pool"),
))]
pub(crate) fn global_pool() -> DefaultPool {
    &PERSISTENT_POOL
}