Struct CacheKey 

pub struct CacheKey(/* private fields */);

The cache-key identity of a task under a given set of inputs (CACHE-001).

Width is 32 bytes: both specification-recognised hash functions (CACHE-002) emit 32-byte digests. A future hash function with a different width would require a chapter revision (CACHE-003) and is out of scope here.

CacheKey is Copy because its only field is a 32-byte array; passing it by value avoids accidental borrow lifetimes in caller code that threads keys through scheduling layers.

Implementations

impl CacheKey

pub const fn as_bytes(&self) -> &[u8; 32]

The 32 bytes of this key.

pub const fn from_bytes(bytes: [u8; 32]) -> Self

Wrap bytes directly as a CacheKey. Intended for callers that already obtained 32 bytes from a trusted source (e.g. hex-decoded manifest, network protocol). The cache library’s invariants on a key are byte-level only; no further checking is performed.

pub fn to_hex(&self) -> String

Hexadecimal encoding (lowercase, 64 ASCII characters) used for on-disk paths per CACHE-010 and the manifest’s key field per CACHE-011.

pub fn from_hex(s: &str) -> Result<Self, HexError>

Decode a 64-character hexadecimal string into a CacheKey. Mirror of CacheKey::to_hex.

Errors

Returns HexError when the input is not 64 hex characters.

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 Copy for CacheKey

impl Debug for CacheKey

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

Formats the value using the given formatter.

impl Eq for CacheKey

impl Hash for CacheKey

fn hash<__H: Hasher>(&self, state: &mut __H)

Feeds this value into the given Hasher.

fn hash_slice<H>(data: &[Self], state: &mut H)

where H: Hasher, Self: Sized,

Feeds a slice of this type into the given Hasher.

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 StructuralPartialEq for CacheKey