Struct CacheGroup 

pub struct CacheGroup { /* private fields */ }

A group (subdirectory) under a CacheRoot that manages cache entries.

Use CacheRoot::group(...) to construct a CacheGroup rooted under a CacheRoot.

Implementations

impl CacheGroup

pub fn path(&self) -> &Path

Return the path of this cache group.

pub fn ensure_dir(&self) -> Result<&Path>

Ensure the group directory exists on disk, creating parents as needed.

pub fn ensure_dir_with_policy( &self, policy: Option<&EvictPolicy>, ) -> Result<&Path>

Ensures this directory exists, then applies optional eviction.

Eviction is applied recursively to files under this directory. The policy is best-effort for removals: individual delete failures are ignored so initialization can continue.

pub fn eviction_report(&self, policy: &EvictPolicy) -> Result<EvictionReport>

Returns a report of files that would be evicted under policy.

This does not delete files. The selection order matches the internal order used by ensure_dir_with_policy. Return a report of files that would be evicted by policy.

The report is non-destructive and mirrors the selection used by ensure_dir_with_policy so it can be used for previewing or testing.

pub fn subgroup<P: AsRef<Path>>(&self, relative_group: P) -> Self

Create a nested subgroup under this group.

pub fn entry_path<P: AsRef<Path>>(&self, relative_file: P) -> PathBuf

Resolve a relative entry path under this group.

pub fn touch<P: AsRef<Path>>(&self, relative_file: P) -> Result<PathBuf>

Create or update (touch) a file under this group, creating parent directories as needed. Returns the absolute path to the entry.

Trait Implementations

impl Clone for CacheGroup

fn clone(&self) -> CacheGroup

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for CacheGroup

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

Formats the value using the given formatter.

impl PartialEq for CacheGroup

fn eq(&self, other: &CacheGroup) -> 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 Eq for CacheGroup

impl StructuralPartialEq for CacheGroup