Struct StandaloneCanisterRecipe 

pub struct StandaloneCanisterRecipe<B> { /* private fields */ }

Snapshot-only recipe for one caller-built, installed canister.

Use with super::CachedPocketIcBaselinePool. The baseline metadata is the installed canister ID; calls go through the baseline’s borrowed PocketIC. The builder owns initialization and readiness before capture and must produce the same topology and seeded state for every slot of this recipe. It returns io::Result<StandaloneCanisterFixture>; build errors retain their original cause and are reported at the pool’s build stage, without invoking capture.

Only the captured canister is restored. Time, other canisters, pending work and external resources are not reset. Use a custom recipe or a fresh instance when those mutations matter. Funding is applied immediately before restore. This recipe stops/drains its single canister before capture and warm restore, then starts it at readiness. Automatic progress must remain disabled. Non-transport restore failures are fatal: the pool discards the affected baseline before returning the error. Dead transport permits one recovery build.

Implementations

impl<B> StandaloneCanisterRecipe<B>

pub fn new(funding: SnapshotRestoreFunding, build: B) -> Self

Describe a single-canister recipe without invoking its builder.

Static suites can initialize the recipe and pool with std::sync::LazyLock.

Trait Implementations

impl<B> PocketIcBaselineRecipe for StandaloneCanisterRecipe<B>

where B: Fn() -> Result<StandaloneCanisterFixture> + Send + Sync + 'static,

type Metadata = Principal

Metadata retained beside every baseline owned by this recipe.

type Error = Error

Structured caller error shared by recipe lifecycle stages.

fn reset_requirements(&self) -> &ResetRequirements

Reset guarantees required before an existing slot may be reused.

fn build(&self) -> Result<CachedPocketIcBaseline<Principal>, Error>

Construct and capture one complete baseline. Stop/drain the complete snapshot set before capture, then start it after the complete set is captured and ready. Automatic progress stays disabled.

fn reset_non_snapshot_state( &self, _baseline: &CachedPocketIcBaseline<Principal>, ) -> Result<ResetReceipt, Error>

Reset state not covered by canister snapshots.

fn prepare_restore( &self, baseline: &CachedPocketIcBaseline<Principal>, ) -> Result<(), Error>

Admit recipe-specific preconditions before the pool restores snapshots.

fn drive_to_readiness( &self, baseline: &CachedPocketIcBaseline<Principal>, ) -> Result<(), Error>

Drive the topology to the recipe’s readiness boundary. Successful completion permits final invariant validation. Restart the complete stopped set here, after canonical restore and the non-snapshot reset have succeeded. Never restart a partially restored set.

fn validate( &self, _baseline: &CachedPocketIcBaseline<Principal>, _preparation: &PreparedBaseline, ) -> Result<(), Error>

Validate the same baseline invariants after build and restore. Success admits this pool-owned recipe’s baseline for leasing.

fn classify_failure( &self, _stage: BaselinePreparationStage, error: &(dyn Error + 'static), ) -> FailureDisposition

Classify a restored-slot recipe failure as fatal or rebuildable.