Struct Factory 

pub struct Factory { /* private fields */ }

How a Factory generates artifacts.

Examples

use uselesskey_core::{Factory, Mode, Seed};

// Check if a factory is in random or deterministic mode
let fx = Factory::random();
assert!(matches!(fx.mode(), Mode::Random));

let seed = Seed::from_env_value("test").unwrap();
let fx = Factory::deterministic(seed);
assert!(matches!(fx.mode(), Mode::Deterministic { .. }));

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.

Each process run produces different artifacts, but within a process, artifacts are cached by (domain, label, spec, variant).

pub fn deterministic(master: Seed) -> Self

Create a deterministic factory from an existing 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

Returns the mode this factory is operating in.

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,

Get a cached artifact 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.