Struct PackCache 

pub struct PackCache { /* private fields */ }

Pack cache for storing and retrieving packs locally.

Implementations

impl PackCache

pub fn new() -> RegistryResult<Self>

Create a new cache with default location.

Default: ~/.assay/cache/packs

pub fn with_dir(cache_dir: impl Into<PathBuf>) -> Self

Create a cache with a custom directory.

pub fn cache_dir(&self) -> &Path

Get the cache directory.

pub async fn get( &self, name: &str, version: &str, ) -> RegistryResult<Option<CacheEntry>>

Get a cached pack, verifying integrity on read.

Returns None if not cached or expired. Returns Err if integrity verification fails (caller should evict and re-fetch).

pub async fn put( &self, name: &str, version: &str, result: &FetchResult, registry_url: Option<&str>, ) -> RegistryResult<()>

Store a pack in the cache.

pub async fn get_metadata(&self, name: &str, version: &str) -> Option<CacheMeta>

Get cached metadata without loading content.

pub async fn get_etag(&self, name: &str, version: &str) -> Option<String>

Get the ETag for conditional requests.

pub async fn is_cached(&self, name: &str, version: &str) -> bool

Check if a pack is cached and not expired.

pub async fn evict(&self, name: &str, version: &str) -> RegistryResult<()>

Evict a pack from the cache.

pub async fn clear(&self) -> RegistryResult<()>

Clear all cached packs.

pub async fn list(&self) -> RegistryResult<Vec<(String, String, CacheMeta)>>

List all cached packs.

Trait Implementations

impl Clone for PackCache

fn clone(&self) -> PackCache

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for PackCache

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

Formats the value using the given formatter.

impl Default for PackCache

fn default() -> Self

Returns the “default value” for a type.