canic-host 0.99.1

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
42
43
44
45
46
47
48
49
50

//! Release-set discovery, manifest emission, and staging helpers.

use std::time::{SystemTime, UNIX_EPOCH};

mod config;
mod manifest;
mod paths;
mod stage;

pub(crate) use config::configured_release_roles_from_config;
pub use config::{
    AppConfigDeclaration, AppConfigError, AppConfigIoOperation, AppConfigMutationConflict,
    AppConfigNameField, AppConfigNameIssue, AppConfigOperation, AppConfigPackageIssue,
    AppConfigSnapshot, AppConfigTomlOperation, AttachedAppRole, ConfiguredPoolExpectation,
    ConfiguredRoleLifecycle, DeclaredAppRole, LOCAL_ROOT_MIN_READY_CYCLES, RenamedAppRole,
    attach_app_role, declare_app_role, plan_attach_app_role, plan_declare_app_role,
    plan_rename_app_role, read_app_config_identity, rename_app_role,
};
pub use manifest::{ReleaseSetEntry, RootReleaseSetManifest, load_root_release_set_manifest};
pub(crate) use manifest::{
    RootReleaseSetBuildSnapshot, RootReleaseSetBuildTarget,
    emit_root_release_set_manifest_from_build, validate_root_release_set_manifest,
};
pub use paths::{
    ArtifactRootError, WorkspaceDiscoveryError, app_sources_root, artifact_root_path, config_path,
    display_workspace_path, icp_root, load_root_package_version, load_workspace_package_version,
    resolve_artifact_root, root_release_set_manifest_path, workspace_manifest_path, workspace_root,
};
pub(crate) use stage::icp_query_in_environment;
use stage::{build_release_set_entry, validate_release_artifact_relative_path};
pub use stage::{resume_root_bootstrap, stage_root_release_set};

pub(super) const APP_SOURCES_ROOT_RELATIVE: &str = "apps";
pub(super) const ROOT_CONFIG_FILE: &str = "canic.toml";
pub(super) const WORKSPACE_MANIFEST_RELATIVE: &str = "Cargo.toml";
pub(crate) const ROOT_RELEASE_SET_MANIFEST_FILE: &str = "root.release-set.json";
pub(super) const GZIP_MAGIC: [u8; 2] = [0x1f, 0x8b];
pub(super) const WASM_MAGIC: [u8; 4] = [0x00, 0x61, 0x73, 0x6d];

// Read the current host wall clock so staged manifests use a stable whole-second
// timestamp without depending on an exported root time endpoint.
pub(super) fn root_time_secs() -> Result<u64, Box<dyn std::error::Error>> {
    let now = SystemTime::now()
        .duration_since(UNIX_EPOCH)
        .map_err(|err| format!("system clock before unix epoch: {err}"))?;
    Ok(now.as_secs())
}

#[cfg(test)]
mod tests;