Skip to main content

Module info

Module info 

Source
Expand description

Read-only cache introspection per AUX-017..AUX-021.

Cache::info walks the cache root and returns a CacheInfoReport classifying every entry, summing the total disk footprint, and breaking down well-formed entries by their manifest’s (chapter_revision, hash_function) prefix. The walk is strictly read-only: no file or directory under the cache root is created, removed, renamed, or modified.

The walk shares its tree-shape recognition with Cache::clean but with different intent:

  • clean removes objectively-stale entries and orphan .tmp- / .restore- directories (under --soft), and age- or size-bounded entries (under --max-age / --max-size).
  • info classifies the same shapes into counts without touching anything.

Unparseable manifests and schema mismatches surface as the corrupt_entries count rather than as errors; the only failure mode is a filesystem read error during the walk.

Structs§

CacheInfoReport
Outcome of Cache::info: every category AUX-019 demands.

Enums§

CacheInfoError
Failure modes for Cache::info.

Type Aliases§

SchemaPrefix
Schema-prefix key used by CacheInfoReport::by_schema.