Struct LayerCache 

pub struct LayerCache { /* private fields */ }

Content-addressed cache for extracted OCI layers.

Layers are stored by digest under cache_dir/layers/<digest>/. Metadata is stored alongside as <digest>.meta.json.

Implementations

impl LayerCache

pub fn new(cache_dir: &Path) -> Result<Self>

Create a new layer cache at the given directory.

pub fn get(&self, digest: &str) -> Result<Option<PathBuf>>

Get the path to a cached layer by digest.

Returns None if the layer is not cached or the cache entry is invalid.

pub fn put(&self, digest: &str, source_dir: &Path) -> Result<PathBuf>

Store an extracted layer directory in the cache.

Copies the contents of source_dir into the cache keyed by digest. Returns the path to the cached layer directory.

pub fn invalidate(&self, digest: &str) -> Result<()>

Remove a cached layer by digest.

pub fn prune(&self, max_bytes: u64) -> Result<usize>

Prune the cache to stay within the given byte limit.

Evicts least-recently-accessed entries first. Returns the number of entries evicted.

pub fn list_entries(&self) -> Result<Vec<LayerMeta>>

List all cached layer entries with their metadata.

pub fn total_size(&self) -> Result<u64>

Get the total size of all cached layers in bytes.

Trait Implementations

impl CacheBackend for LayerCache

fn get(&self, key: &str) -> Result<Option<PathBuf>>

Retrieve a cached directory by key.

fn put( &self, key: &str, source_dir: &Path, _description: &str, ) -> Result<PathBuf>

Store a directory tree in the cache under the given key.

fn invalidate(&self, key: &str) -> Result<()>

Remove a cached entry by key.

fn prune(&self, _max_entries: usize, max_bytes: u64) -> Result<usize>

Evict entries to satisfy the given constraints.

fn list(&self) -> Result<Vec<CacheEntry>>

List all cache entries with their metadata.

fn stats(&self) -> Result<CacheStats, BoxError>

Get aggregate cache statistics.