Struct CacheManager 

pub struct CacheManager { /* private fields */ }

Manages the physical cache directory layout and file I/O.

Implementations

impl CacheManager

pub fn new(root: PathBuf) -> Result<Self>

Create a new manager rooted at root. The directory is created if it does not already exist.

pub fn root(&self) -> &Path

Absolute path to the cache root.

pub fn path_for( &self, context: &AssetContext, asset_id: &str, filename: &str, ) -> PathBuf

Compute the on-disk path for an asset given its context and filename.

Layout:

{root}/{context_dir}/{context_id}/{asset_id}-{safe_filename}

Both asset_id and filename are sanitized before becoming a single path component — any directory separators or .. sequences in the inputs are replaced with _, so calling path_for with hostile input can never escape the per-context directory.

An 8-character SHA-256 prefix of the raw asset_id is embedded in the filename to avoid collisions between IDs that differ only in characters collapsed by sanitization. 8 hex chars = 32 bits gives ~4 billion buckets — collision probability via birthday paradox is negligible for a rotated local cache (< 0.0001% with 100 files per context). We intentionally keep the hash short to stay well within the 255-char filename limit on ext4 / NTFS / APFS.

pub fn dir_for(&self, context: &AssetContext) -> PathBuf

Directory for a given context (relative to the cache root, joined).

pub fn store( &self, context: &AssetContext, asset_id: &str, filename: &str, data: &[u8], ) -> Result<StoredFile>

Store bytes for an asset and return the absolute path where they were written along with the SHA-256 checksum.

Parent directories are created as needed. Writes go through a temp file + rename so partial writes are never observable.

pub fn load(&self, absolute: &Path) -> Result<Vec<u8>>

Read a file from the cache by absolute path. Returns NotFound if the file is missing (via AssetError::Io).

pub fn delete(&self, absolute: &Path) -> Result<()>

Delete a file from the cache. Missing files are treated as success so that retries / idempotent deletes work as expected.

pub fn exists(&self, absolute: &Path) -> bool

Check whether a file exists in the cache.

Trait Implementations

impl Clone for CacheManager

fn clone(&self) -> CacheManager

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for CacheManager

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

Formats the value using the given formatter.