Module artifacts

Expand description

Host-side artifact discovery, freshness, and Wasm build helpers.

These functions keep integration-test artifacts in caller-selected target directories and contain no application-specific package or profile policy.

Structs§

ArtifactBuildTransaction: Owned miss transaction holding the recipe and content-key process locks.
ArtifactCacheArtifact: One logical artifact materialized at its caller-selected destination.
ArtifactCachePrunePolicy: Caller-selected retention limits for content-addressed artifact entries.
ArtifactCachePruneReport: Summary of one lock-coordinated artifact-cache pruning pass.
ArtifactCacheRecord: Details shared by built and reused transactional artifact outcomes.
ArtifactCacheSpec: Complete caller-owned description of one transactional artifact set.
ArtifactCacheTimings: Phase timings for one transactional artifact-cache acquisition.
CargoBuildInput: One exact local Cargo source or configuration input under a stable logical label.
InputDigest: SHA-256 digest of one deterministic artifact-input set.
ResolvedCargoBuildInputs: Resolved exact inputs and identity for one WasmBuildSpec.
WasmBuildRecord: Details shared by built and reused Wasm outcomes.
WasmBuildSpec: Complete caller-owned description of one cacheable Cargo Wasm build.
WasmBuildTimings: Timings for cache coordination, input resolution, and Cargo execution.
WasmInputResolutionTimings: Detailed timings for exact Wasm build-input resolution.
WatchedInputSnapshot: Exact content digest captured across a set of watched input trees.

ArtifactCacheError: Structured failure from transactional artifact caching.
ArtifactCacheMaintenance: Nonfatal retention attempted as part of a successful cache acquisition.
ArtifactCacheOutcome: Whether an artifact transaction published or reused its exact output set.
ArtifactCachePreparation: Result of preparing a transactional artifact-set acquisition.
ArtifactOutputValidation: Built-in validation applied to one transactional artifact output.
WasmBuildCacheMode: Cargo-target ownership mode for one exact cached Wasm build.
WasmBuildError: Structured failure from a cacheable Wasm build.
WasmBuildOutcome: Whether a cacheable Wasm build ran Cargo or reused exact matching artifacts.
WasmBuildPhase: External phase associated with a cacheable Wasm build failure.

build_wasm_canisters: Build one or more Wasm canisters into the provided target directory.
build_wasm_canisters_cached: Build or reuse one exact set of Cargo Wasm artifacts.
icp_artifact_ready_for_build: Check whether an ICP artifact exists, is nonempty, and is fresh against watched inputs.
icp_artifact_ready_with_snapshot: Check one ICP artifact against one already-captured watched-input snapshot.
prepare_artifact_cache: Verify or begin one exact external artifact-set transaction.
prune_artifact_cache: Prune one transactional artifact namespace without acquiring an artifact.
prune_wasm_build_cache: Prune fingerprint-specific Cargo target directories under target_dir.
read_wasm: Read a compiled Wasm artifact for one crate.
resolve_cargo_build_inputs: Resolve the exact Cargo source, configuration, toolchain, argument, and environment identity.
resolve_executable: Resolve one executable exactly as an artifact-cache tool input.
test_target_dir: Return <workspace>/target/<name> for isolated host-side test artifacts.
wasm_artifacts_ready: Check whether every requested Wasm artifact is a regular file.
wasm_path: Resolve one crate’s Wasm artifact under a caller-selected Cargo target directory.
workspace_root_for: Resolve the conventional workspace root from a crate manifest directory.

WasmBuildCacheMaintenance: Wasm-cache compatibility name for generic nonfatal cache maintenance.
WasmBuildCachePrunePolicy: Wasm-cache compatibility name for generic artifact-cache retention limits.
WasmBuildCachePruneReport: Wasm-cache compatibility name for a generic artifact-cache pruning report.