Struct CacheManifest 

pub struct CacheManifest {
    pub version: u32,
    pub entries: HashMap<String, CacheEntry>,
    /* private fields */
}

On-disk cache manifest mapping output paths to their cache entries.

Lookups go through a runtime content_index that maps "{source_hash}:{params_hash}" to the stored output path, making the cache resilient to album renames and file renumbering.

Fields

version: u32

entries: HashMap<String, CacheEntry>

Implementations

impl CacheManifest

pub fn empty() -> Self

Create an empty manifest (used for --no-cache or first build).

pub fn load(output_dir: &Path) -> Self

Load from the output directory. Returns an empty manifest if the file doesn’t exist or can’t be parsed (version mismatch, corruption).

pub fn save(&self, output_dir: &Path) -> Result<()>

Save to the output directory.

pub fn find_cached( &self, source_hash: &str, params_hash: &str, output_dir: &Path, ) -> Option<String>

Look up a cached output file by content hashes.

Returns Some(stored_output_path) if an entry with matching source_hash and params_hash exists and the file is still on disk. The returned path may differ from the caller’s expected output path (e.g. after an album rename); the caller is responsible for copying the file to the new location if needed.

pub fn insert( &mut self, output_path: String, source_hash: String, params_hash: String, )

Record a cache entry for an output file.

If an entry with the same content (source_hash + params_hash) already exists under a different output path, the old entry is removed to keep the manifest clean when images move (e.g. album rename).

If the output path already has an entry for different content (e.g. image swap: file A moved to where B used to be), the old content’s content_index entry is removed so stale lookups don’t return a file whose content has been overwritten.

pub fn prune(&mut self, live_paths: &HashSet<String>, output_dir: &Path) -> u32

Remove all entries whose output path is not in live_paths, and delete the corresponding files from output_dir.

Call this after a full build to clean up processed files for images that were deleted, renumbered, or belong to renamed/removed albums.

Trait Implementations

impl Clone for CacheManifest

fn clone(&self) -> CacheManifest

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for CacheManifest

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for CacheManifest

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Serialize for CacheManifest

fn serialize<__S>(&self, __serializer: __S) -> Result<__S::Ok, __S::Error>

where __S: Serializer,

Serialize this value into the given Serde serializer.