Struct FixturePool 

pub struct FixturePool { /* private fields */ }

Runtime cache of instantiated fixtures with scoped lifecycle management.

Uses lock-free DashMap for fixture values — concurrent reads never block. Each scope level (global, worker, test) has its own pool instance. Child pools inherit from parent pools for cross-scope fixture access.

Implementations

impl FixturePool

pub fn new(defs: FxHashMap<String, FixtureDef>, scope: FixtureScope) -> Self

Create a new root fixture pool.

pub fn child(&self, scope: FixtureScope) -> Self

Create a child pool that inherits parent fixtures for cross-scope access.

pub fn child_with_defs( &self, defs: FxHashMap<String, FixtureDef>, scope: FixtureScope, ) -> Self

Create a child pool with additional or overridden fixture definitions.

This is the core building block for per-test fixture graphs: worker/global fixtures live in the parent pool, while test-scoped fixtures can be specialized for a single test execution without mutating shared state.

pub fn get<T: Any + Send + Sync>( &self, name: &str, ) -> Pin<Box<dyn Future<Output = Result<Arc<T>>> + Send>>

Get or lazily create a fixture by name.

Returns Arc<T> since fixture values are shared and not cloneable. Resolves dependencies recursively (DAG walk).

pub fn try_get_cached<T: Any + Send + Sync>(&self, name: &str) -> Option<Arc<T>>

Synchronously get an already-resolved fixture from the cache. Returns None if the fixture hasn’t been resolved yet. Lock-free DashMap read — no async needed. Used by NAPI lazy fixture getters to avoid redundant async resolution.

pub fn inject<T: Any + Send + Sync>(&self, name: &str, value: Arc<T>)

Inject a pre-created fixture value into the pool (skips setup). Lock-free DashMap insert — no async needed.

pub async fn resolve(&self, name: &str) -> Result<()>

Resolve a fixture by name without knowing its concrete type.

pub fn auto_fixture_names_for(&self, scope: FixtureScope) -> Vec<String>

Names of every fixture marked auto: true whose scope matches the argument or any narrower scope (Test fixtures get included for Test pools; Worker auto fixtures get included for Worker pools). Walks the parent chain so worker-scope auto fixtures are visible from a test-scope child pool.

pub async fn teardown_all(&self)

Tear down all fixtures in this pool (reverse order).

Trait Implementations

impl Clone for FixturePool

fn clone(&self) -> FixturePool

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.