canic-host 0.93.23

Host-side build, install, deployment, and fleet-template 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

use std::path::{Path, PathBuf};
use thiserror::Error as ThisError;

use super::super::ROOT_RELEASE_SET_MANIFEST_FILE;

/// Failure to locate the exact artifact root for a selected ICP environment.
#[derive(Debug, Eq, PartialEq, ThisError)]
pub enum ArtifactRootError {
    #[error("missing built ICP artifacts under {artifact_root}")]
    Missing { artifact_root: PathBuf },
}

/// Resolve the built artifact directory for the selected ICP environment.
pub fn resolve_artifact_root(icp_root: &Path, network: &str) -> Result<PathBuf, ArtifactRootError> {
    let artifact_root = artifact_root_path(icp_root, network);
    if artifact_root.is_dir() {
        return Ok(artifact_root);
    }

    Err(ArtifactRootError::Missing { artifact_root })
}

/// Return the canonical artifact directory for one ICP environment.
pub fn artifact_root_path(icp_root: &Path, network: &str) -> PathBuf {
    icp_root.join(".icp").join(network).join("canisters")
}

/// Return the canonical manifest path for the staged root release set.
#[must_use]
pub fn root_release_set_manifest_path(artifact_root: &Path) -> PathBuf {
    artifact_root
        .join("root")
        .join(ROOT_RELEASE_SET_MANIFEST_FILE)
}