canic-host 0.109.6

Host-side App build, Fleet install, deployment, and release-set library for Canic workspaces
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

use crate::{canister_build::CanisterBuildProfile, deployment_truth::DeploymentPlanV1};
use candid::Principal;
use canic_core::ids::ReleaseBuildId;
use std::{path::PathBuf, str::FromStr};

/// One explicit adoption request for an already-applied state-preserving Root repair.
#[derive(Clone, Debug, Eq, PartialEq)]
pub struct RetainedRootRepairAdoption {
    pub fleet_subnet_root: Principal,
    pub successor_wasm: PathBuf,
}

impl FromStr for RetainedRootRepairAdoption {
    type Err = String;

    fn from_str(value: &str) -> Result<Self, Self::Err> {
        let (root, wasm) = value.split_once('=').ok_or_else(|| {
            "retained Root repair must be formatted as <ROOT_PRINCIPAL>=<RAW_WASM_PATH>".to_string()
        })?;
        let fleet_subnet_root = Principal::from_text(root)
            .map_err(|_| "retained Root repair has an invalid Root Principal".to_string())?;
        if fleet_subnet_root == Principal::anonymous() {
            return Err("retained Root repair cannot name the anonymous Principal".to_string());
        }
        if wasm.is_empty() {
            return Err("retained Root repair raw Wasm path must not be empty".to_string());
        }
        Ok(Self {
            fleet_subnet_root,
            successor_wasm: PathBuf::from(wasm),
        })
    }
}

///
/// InstallRootOptions
///

#[derive(Clone, Debug)]
pub struct InstallRootOptions {
    pub root_canister: String,
    pub root_build_target: String,
    pub icp_executable: String,
    pub environment: String,
    pub fleet_name: String,
    pub icp_root: Option<PathBuf>,
    pub build_profile: Option<CanisterBuildProfile>,
    pub release_build_id: Option<ReleaseBuildId>,
    pub config_path: Option<String>,
    pub fleet_install_input_path: Option<PathBuf>,
    pub expected_fresh_fleet_plan_digest: Option<String>,
    pub admitted_fresh_fleet_plan_digest: Option<String>,
    pub expected_app: Option<String>,
    pub retained_root_repair_adoption: Option<RetainedRootRepairAdoption>,
    pub interactive_config_selection: bool,
    pub deployment_plan_override: Option<DeploymentPlanV1>,
}

impl InstallRootOptions {
    /// Return the exact ICP artifact environment owned by this install mode.
    pub(super) fn artifact_environment(&self) -> &str {
        if self.deployment_plan_override.is_some() {
            &self.environment
        } else {
            "local"
        }
    }
}