Struct Controller 

pub struct Controller { /* private fields */ }

Drives one seeded study a transaction at a time.

Implementations

impl Controller

pub fn new(config: RunConfig) -> Result<Self>

Creates a ready run.

Errors

The study could not be created (an invalid space or budget).

pub const fn config(&self) -> RunConfig

The run configuration.

pub const fn status(&self) -> &Status

The lifecycle state.

pub fn records(&self) -> &[TrialRecord]

Completed trials, in trial-number order.

pub fn best(&self) -> Option<&TrialRecord>

The trial with the lowest value so far (the first one on a tie).

pub const fn snapshot(&self) -> Option<&StudySnapshot>

The study’s latest snapshot, refreshed after every transaction.

pub const fn generation(&self) -> u64

Increments on every reset or sampler change. Callbacks scheduled for an older generation are stale and must not act.

pub const fn revision(&self) -> u64

Increments on every observable change, so views refresh only when something changed.

pub const fn is_finished(&self) -> bool

Whether the run can still complete trials.

pub fn start(&mut self) -> bool

Starts a ready run, or resumes a paused one. Returns whether the state changed.

pub fn pause(&mut self, reason: PauseReason) -> bool

Pauses a running run. A PauseReason::Hidden pause still needs an explicit Self::start to continue. Returns whether the state changed.

pub fn tick(&mut self) -> bool

Runs one transaction if the run is Status::Running. Returns whether a trial completed.

pub fn step(&mut self) -> bool

Runs exactly one transaction from a ready or paused run and leaves it paused. Returns whether a trial completed.

pub fn reset(&mut self) -> Result<()>

Discards the run and creates a fresh study with the same configuration.

Errors

The study could not be created.

pub fn select_sampler(&mut self, sampler: SamplerChoice) -> Result<()>

Switches sampler and resets.

Errors

The study could not be created.

pub fn sequence_digest(&self) -> u64

FNV-1a over every completed trial’s number, sampler seed, parameter bits, and value bits — a compact fingerprint of the exact sequence, so a browser build can be compared against a host run.

Trait Implementations

impl Debug for Controller

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

Formats the value using the given formatter.