canic-host 0.95.8

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
35
36
37
38
39
40
41

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 artifact 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 artifact environment.
pub fn resolve_artifact_root(
    icp_root: &Path,
    artifact_environment: &str,
) -> Result<PathBuf, ArtifactRootError> {
    let artifact_root = artifact_root_path(icp_root, artifact_environment);
    if artifact_root.is_dir() {
        return Ok(artifact_root);
    }

    Err(ArtifactRootError::Missing { artifact_root })
}

/// Return the canonical artifact directory for one artifact environment.
#[must_use]
pub fn artifact_root_path(icp_root: &Path, artifact_environment: &str) -> PathBuf {
    icp_root
        .join(".icp")
        .join(artifact_environment)
        .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)
}