Module artifacts 

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.

ArtifactCacheBatchOutcome

Successful outcomes from sequential independent artifact transactions.

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.

SharedIncrementalTargetInspection

Lock-coordinated disk-usage observation for a caller-owned shared Cargo target.

SharedIncrementalTargetMaintenance

Result of explicit shared Cargo target maintenance.

SharedIncrementalTargetPrunePolicy

Whole-target retention limits for caller-owned shared Cargo state.

WasmBuildBatchError

Failure from an independent Wasm build batch.

WasmBuildBatchOutcome

Successful outcomes from an independent sequence of exact Wasm builds.

WasmBuildProgressConfig

Observation settings for one cacheable Wasm build.

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.

Enums

ArtifactCacheBatchError

Failure from a sequential independent artifact transaction batch.

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.

SharedIncrementalTargetMaintenanceOutcome

Result of interval-limited shared Cargo target maintenance.

WasmBuildBatchProgressEvent

Structured progress for an independent sequence of exact Wasm builds.

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.

WasmBuildOutputStream

Raw child-process stream attached to a Cargo progress event.

WasmBuildPhase

External phase associated with a cacheable Wasm build failure.

WasmBuildProgressEvent

Structured progress emitted by an observed cacheable Wasm build.

WasmBuildProgressOutcome

Final cache state reported by a successful observed build.

Functions

build_artifact_caches_batch

Build or reuse multiple independent transactional artifact sets.

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.

build_wasm_canisters_cached_batch

Build or reuse multiple Wasm specifications as independent Cargo invocations.

build_wasm_canisters_cached_batch_with_progress

Build an independent Wasm batch while forwarding structured progress.

build_wasm_canisters_cached_with_progress

Build or reuse one exact Wasm set while streaming structured progress.

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.

inspect_shared_incremental_target

Inspect one configured shared Cargo target under its build coordination lock.

maintain_shared_incremental_target

Apply explicit whole-target retention to caller-owned shared Cargo state.

maintain_shared_incremental_target_at_most_every

Apply whole-target retention at most once per interval across processes.

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.

Type Aliases

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.