Struct RestoreOptions 

#[non_exhaustive]
pub struct RestoreOptions<'a> {
    pub custom_strategy_factory: CustomStrategyFactory<'a>,
}

Options for WorldSnapshot::restore and Simulation::restore_bytes.

Construct via Default::default when the snapshot only uses built-in strategies, or via with_factory when groups in the snapshot reference Custom dispatch strategies that need to be re-instantiated by name. The struct is #[non_exhaustive] so future restore knobs can land without an API break.

// Built-ins only:
let _sim = snap.restore(RestoreOptions::default())?;

Fields (Non-exhaustive)

Non-exhaustive structs could have additional fields added in future. Therefore, non-exhaustive structs cannot be constructed in external crates using the traditional Struct { .. } syntax; cannot be matched against without a wildcard ..; and struct update syntax will not work.

custom_strategy_factory: CustomStrategyFactory<'a>

Factory mapping Custom strategy names to fresh trait-object instances. None when the snapshot only uses built-in strategies — restore returns SimError::UnresolvedCustomStrategy if a snapshot group needs a custom strategy and the factory isn’t supplied (or returns None).

Implementations

impl<'a> RestoreOptions<'a>

pub fn with_factory( factory: &'a dyn Fn(&str) -> Option<Box<dyn DispatchStrategy>>, ) -> Self

Build a RestoreOptions with a custom-strategy factory wired up. Use Default::default when no custom strategies are in play.

Trait Implementations

impl<'a> Clone for RestoreOptions<'a>

fn clone(&self) -> RestoreOptions<'a>

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl<'a> Default for RestoreOptions<'a>

fn default() -> RestoreOptions<'a>

Returns the “default value” for a type.

impl<'a> Copy for RestoreOptions<'a>