1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
use ic_platform::pocket_ic::PocketIc;
use ic_platform::principal::ExternalPrincipal as Principal;
use super::{CanisterInstallExt, InstallSpec, PocketIcInstance, StandaloneCanisterInstallError};
/// One caller-built `PocketIC` instance/server owner and one installed canister.
///
/// This fixture retains the instance and its optional managed server together.
/// It does not impose process-wide synchronization or hide `PocketIC` methods.
pub struct StandaloneCanisterFixture {
instance: PocketIcInstance<PocketIc>,
canister_id: Principal,
}
impl StandaloneCanisterFixture {
/// Install one canister into a caller-configured `PocketIC` instance.
///
/// On failure, the error retains both the caller's instance/server ownership record and
/// the structured install failure.
///
/// # Errors
/// Returns the installation failure with the owned instance for caller recovery.
pub fn try_install(
instance: PocketIcInstance<PocketIc>,
spec: InstallSpec,
) -> Result<Self, StandaloneCanisterInstallError> {
let canister_id = match instance.instance().try_create_and_install(spec) {
Ok(canister_id) => canister_id,
Err(error) => return Err(StandaloneCanisterInstallError::new(instance, error)),
};
Ok(Self {
instance,
canister_id,
})
}
/// Borrow the `PocketIC` instance that owns this standalone fixture.
#[must_use]
pub const fn pocket_ic(&self) -> &PocketIc {
self.instance.instance()
}
/// Read the installed canister id for this standalone fixture.
#[must_use]
pub const fn canister_id(&self) -> Principal {
self.canister_id
}
/// Consume the fixture and return the instance/server ownership record and canister id.
pub fn into_parts(self) -> (PocketIcInstance<PocketIc>, Principal) {
(self.instance, self.canister_id)
}
}