ic-testkit 0.68.2

PocketIC-oriented test utilities for IC canister tests
Documentation 
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
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77

//! Integration checks for pocket ic install behavior.
mod support;

use ic_platform::principal::ExternalPrincipal as Principal;
use ic_testkit::pic::{
    CanisterDiagnosticsRequest, CanisterInstallError, CanisterInstallExt, CanisterLogRenderLimits,
    InstallSpec, PocketIcDiagnosticsExt, StandaloneCanisterFixture,
};

#[test]
fn fallible_install_preserves_the_original_failure_for_caller_diagnostics() {
    let owned = support::pocket_ic();
    let pocket_ic = owned.instance();
    let error = pocket_ic
        .try_create_and_install(InstallSpec {
            wasm: vec![0xde, 0xad],
            init_bytes: vec![],
            cycles: 0,
            install_sender: None,
            label: Some("invalid-wasm".into()),
        })
        .expect_err("invalid Wasm should fail installation");

    let CanisterInstallError::InstallCode {
        canister_id,
        label,
        source,
    } = &error
    else {
        panic!("invalid Wasm must fail at installation: {error}");
    };
    assert_eq!(label.as_deref(), Some("invalid-wasm"));
    assert!(
        source.message().contains("CanisterInvalidWasm"),
        "original PocketIC rejection should be preserved: {}",
        source.message()
    );
    let report = pocket_ic.collect_canister_diagnostics(CanisterDiagnosticsRequest {
        canister_id: *canister_id,
        status_sender: Principal::anonymous(),
        log_sender: Principal::anonymous(),
        log_limits: CanisterLogRenderLimits::default(),
    });
    assert!(
        report.status.is_ok(),
        "the failed install's canister remains inspectable"
    );
    assert!(source.message().contains("CanisterInvalidWasm"));
}

#[test]
fn failed_standalone_install_returns_the_caller_instance() {
    let Err(error) = StandaloneCanisterFixture::try_install(
        support::pocket_ic(),
        InstallSpec {
            wasm: vec![0xde, 0xad],
            init_bytes: vec![],
            cycles: 0,
            install_sender: None,
            label: Some("invalid-standalone-wasm".into()),
        },
    ) else {
        panic!("invalid Wasm should fail standalone installation");
    };

    let CanisterInstallError::InstallCode {
        canister_id, label, ..
    } = error.install_error()
    else {
        panic!("invalid Wasm must fail at installation: {error}");
    };
    assert_eq!(label.as_deref(), Some("invalid-standalone-wasm"));
    error
        .pocket_ic()
        .canister_status(*canister_id, None)
        .expect("caller-created instance should remain inspectable after install failure");
}