Struct Factory 

pub struct Factory { /* private fields */ }

A factory for generating and caching test artifacts.

Factory is cheap to clone; clones share the same cache.

Implementations

impl Factory

pub fn new(mode: Mode) -> Self

Create a new factory with the specified mode.

pub fn random() -> Self

Create a factory in random mode.

pub fn deterministic(master: Seed) -> Self

Create a factory in deterministic mode from a master seed.

pub fn deterministic_from_str(text: &str) -> Self

Create a deterministic factory from plain text.

This hashes the provided string verbatim with BLAKE3. Unlike Seed::from_env_value, it does not trim whitespace or interpret hex-shaped strings specially.

pub fn deterministic_from_env(var: &str) -> Result<Self, Error>

Create a deterministic factory from an environment variable.

The environment variable can contain:

• A 64-character hex string (with optional 0x prefix)
• Any other string (hashed to produce a 32-byte seed)

Errors

Returns an error if the environment variable is not set.

pub fn mode(&self) -> &Mode

Return the active mode.

pub fn clear_cache(&self)

Clear the artifact cache.

pub fn get_or_init<T, F>( &self, domain: ArtifactDomain, label: &str, spec_bytes: &[u8], variant: &str, init: F, ) -> Arc<T>

where T: Any + Send + Sync + 'static, F: FnOnce(Seed) -> T,

Return a cached value by (domain, label, spec, variant) or generate one.

The initializer receives the derived seed for this artifact identity. Callers that need an RNG should instantiate it privately from that seed.

Trait Implementations

impl Clone for Factory

fn clone(&self) -> Factory

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for Factory

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.