Struct CacheKey 

pub struct CacheKey {
    pub package_id: String,
    pub task_name: String,
    pub command: String,
    pub env_vars: BTreeMap<String, String>,
    pub input_file_hashes: FxHashMap<PathBuf, String>,
    pub dependency_graph_hash: String,
    pub toolchain_version: String,
}

Deterministic cache key for task execution results.

The cache key includes all inputs that affect task output:

• Package identifier
• Task name and command
• Environment variables (explicit allowlist)
• Input file hashes (tracked files only)
• Dependency graph hash
• Toolchain version

Fields

package_id: String

Package identifier (name + normalized path hash).

task_name: String

Task name.

command: String

Command string.

env_vars: BTreeMap<String, String>

Environment variables (sorted by key for determinism).

input_file_hashes: FxHashMap<PathBuf, String>

Input file hashes (relative path -> SHA-256 hash).

dependency_graph_hash: String

Dependency graph hash (transitive dependencies).

toolchain_version: String

Toolchain version (e.g., “node-v20.0.0”, “rustc-1.75.0”).

Implementations

impl CacheKey

pub fn builder() -> CacheKeyBuilder

Creates a new cache key builder.

pub fn hash(&self) -> String

Computes the deterministic hash of this cache key.

Returns a hex-encoded SHA-256 hash.

pub fn as_string(&self) -> String

Returns the cache key as a string identifier.

This is the hash of the cache key, used for storage and retrieval.

Trait Implementations

impl Clone for CacheKey

fn clone(&self) -> CacheKey

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for CacheKey

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for CacheKey

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl PartialEq for CacheKey

fn eq(&self, other: &CacheKey) -> bool

Tests for self and other values to be equal, and is used by ==.

fn ne(&self, other: &Rhs) -> bool

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl Serialize for CacheKey

fn serialize<__S>(&self, __serializer: __S) -> Result<__S::Ok, __S::Error>

where __S: Serializer,

Serialize this value into the given Serde serializer.

impl Eq for CacheKey

impl StructuralPartialEq for CacheKey