mod enum_variant_meta; pub use enum_variant_meta::*; pub use ahash::AHasher; pub use instant::{Duration, Instant}; pub use tracing; pub use uuid::Uuid; use ahash::RandomState; use std::{future::Future, pin::Pin}; #[cfg(not(target_arch = "wasm32"))] pub type BoxedFuture<'a, T> = Pin + Send + 'a>>; #[cfg(target_arch = "wasm32")] pub type BoxedFuture<'a, T> = Pin + 'a>>; /// A hasher builder that will create a fixed hasher. #[derive(Default)] pub struct FixedState; impl std::hash::BuildHasher for FixedState { type Hasher = AHasher; #[inline] fn build_hasher(&self) -> AHasher { AHasher::new_with_keys( 0b1001010111101110000001001100010000000011001001101011001001111000, 0b1100111101101011011110001011010100000100001111100011010011010101, ) } } /// A std hash map implementing AHash, a high speed keyed hashing algorithm /// intended for use in in-memory hashmaps. /// /// AHash is designed for performance and is NOT cryptographically secure. pub type HashMap = std::collections::HashMap; pub trait AHashExt { fn with_capacity(capacity: usize) -> Self; } impl AHashExt for HashMap { /// Creates an empty `HashMap` with the specified capacity with AHash. /// /// The hash map will be able to hold at least `capacity` elements without /// reallocating. If `capacity` is 0, the hash map will not allocate. /// /// # Examples /// /// ``` /// use bevy_utils::{HashMap, AHashExt}; /// let mut map: HashMap<&str, i32> = HashMap::with_capacity(10); /// assert!(map.capacity() >= 10); /// ``` #[inline] fn with_capacity(capacity: usize) -> Self { HashMap::with_capacity_and_hasher(capacity, RandomState::default()) } } /// A stable std hash map implementing AHash, a high speed keyed hashing algorithm /// intended for use in in-memory hashmaps. /// /// Unlike [`HashMap`] this has an iteration order that only depends on the order /// of insertions and deletions and not a random source. /// /// AHash is designed for performance and is NOT cryptographically secure. pub type StableHashMap = std::collections::HashMap; impl AHashExt for StableHashMap { /// Creates an empty `StableHashMap` with the specified capacity with AHash. /// /// The hash map will be able to hold at least `capacity` elements without /// reallocating. If `capacity` is 0, the hash map will not allocate. /// /// # Examples /// /// ``` /// use bevy_utils::{StableHashMap, AHashExt}; /// let mut map: StableHashMap<&str, i32> = StableHashMap::with_capacity(10); /// assert!(map.capacity() >= 10); /// ``` #[inline] fn with_capacity(capacity: usize) -> Self { StableHashMap::with_capacity_and_hasher(capacity, FixedState::default()) } } /// A std hash set implementing AHash, a high speed keyed hashing algorithm /// intended for use in in-memory hashmaps. /// /// AHash is designed for performance and is NOT cryptographically secure. pub type HashSet = std::collections::HashSet; impl AHashExt for HashSet { /// Creates an empty `HashSet` with the specified capacity with AHash. /// /// The hash set will be able to hold at least `capacity` elements without /// reallocating. If `capacity` is 0, the hash set will not allocate. /// /// # Examples /// /// ``` /// use bevy_utils::{HashSet, AHashExt}; /// let set: HashSet = HashSet::with_capacity(10); /// assert!(set.capacity() >= 10); /// ``` #[inline] fn with_capacity(capacity: usize) -> Self { HashSet::with_capacity_and_hasher(capacity, RandomState::default()) } } /// A stable std hash set implementing AHash, a high speed keyed hashing algorithm /// intended for use in in-memory hashmaps. /// /// Unlike [`HashSet`] this has an iteration order that only depends on the order /// of insertions and deletions and not a random source. /// /// AHash is designed for performance and is NOT cryptographically secure. pub type StableHashSet = std::collections::HashSet; impl AHashExt for StableHashSet { /// Creates an empty `StableHashSet` with the specified capacity with AHash. /// /// The hash set will be able to hold at least `capacity` elements without /// reallocating. If `capacity` is 0, the hash set will not allocate. /// /// # Examples /// /// ``` /// use bevy_utils::{StableHashSet, AHashExt}; /// let set: StableHashSet = StableHashSet::with_capacity(10); /// assert!(set.capacity() >= 10); /// ``` #[inline] fn with_capacity(capacity: usize) -> Self { StableHashSet::with_capacity_and_hasher(capacity, FixedState::default()) } }