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(&mut ChaCha20Rng) -> T,

Get a cached artifact by (domain, label, spec, variant) or generate one.

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.