mirror of
https://github.com/bevyengine/bevy
synced 2024-12-26 04:53:07 +00:00
e34fb68677
# Objective There's a repeating pattern of `ThreadLocal<Cell<Vec<T>>>` which is very useful for low overhead, low contention multithreaded queues that have cropped up in a few places in the engine. This pattern is surprisingly useful when building deferred mutation across multiple threads, as noted by it's use in `ParallelCommands`. However, `ThreadLocal<Cell<Vec<T>>>` is not only a mouthful, it's also hard to ensure the thread-local queue is replaced after it's been temporarily removed from the `Cell`. ## Solution Wrap the pattern into `bevy_utils::Parallel<T>` which codifies the entire pattern and ensures the user follows the contract. Instead of fetching indivdual cells, removing the value, mutating it, and replacing it, `Parallel::get` returns a `ParRef<'a, T>` which contains the temporarily removed value and a reference back to the cell, and will write the mutated value back to the cell upon being dropped. I would like to use this to simplify the remaining part of #4899 that has not been adopted/merged. --- ## Changelog TODO --------- Co-authored-by: Joseph <21144246+JoJoJet@users.noreply.github.com>
34 lines
934 B
TOML
34 lines
934 B
TOML
[package]
|
|
name = "bevy_utils"
|
|
version = "0.13.0"
|
|
edition = "2021"
|
|
description = "A collection of utils for Bevy Engine"
|
|
homepage = "https://bevyengine.org"
|
|
repository = "https://github.com/bevyengine/bevy"
|
|
license = "MIT OR Apache-2.0"
|
|
keywords = ["bevy"]
|
|
|
|
[features]
|
|
detailed_trace = []
|
|
|
|
[dependencies]
|
|
ahash = "0.8.7"
|
|
tracing = { version = "0.1", default-features = false, features = ["std"] }
|
|
web-time = { version = "0.2" }
|
|
uuid = { version = "1.1", features = ["v4", "serde"] }
|
|
hashbrown = { version = "0.14", features = ["serde"] }
|
|
bevy_utils_proc_macros = { version = "0.13.0", path = "macros" }
|
|
petgraph = "0.6"
|
|
thiserror = "1.0"
|
|
thread_local = "1.0"
|
|
nonmax = "0.5"
|
|
smallvec = { version = "1.11", features = ["serde", "union", "const_generics"] }
|
|
|
|
[dev-dependencies]
|
|
static_assertions = "1.1.0"
|
|
|
|
[target.'cfg(target_arch = "wasm32")'.dependencies]
|
|
getrandom = { version = "0.2.0", features = ["js"] }
|
|
|
|
[lints]
|
|
workspace = true
|