Struct Cache 

pub struct Cache {
    pub root: PathBuf,
}

The on-disk package cache, rooted at Cache::root.

Fields

root: PathBuf

Implementations

impl Cache

pub fn user_default() -> Cache

The cache rooted at ~/.ridl/cache (ADR-0002 §7). When the home directory is unknown it falls back to .ridl/cache relative to the current directory.

pub fn lookup(&self, url: &str, sha256: &str) -> Option<PathBuf>

The unpacked package directory for url pinned to sha256, if it is present in the cache. A hit means the artifact with that content hash is already unpacked, so no fetch is needed.

pub fn store(&self, url: &str, bytes: &[u8]) -> Result<(String, PathBuf)>

Stores the artifact bytes fetched from url, unpacking the tar into the content-addressed entry directory. Returns the artifact’s SHA-256 content hash (lowercase hex) and the unpacked directory.

The tar is unpacked into a temporary sibling directory and then renamed into place, so a fetch interrupted mid-unpack never leaves a partial directory that a later lookup would treat as a hit. A re-store of already-cached content is a no-op that returns the existing directory.

Trait Implementations

impl Clone for Cache

fn clone(&self) -> Self

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for Cache

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

Formats the value using the given formatter.