Struct ImageCache 

pub struct ImageCache { /* private fields */ }

Caches image analysis results with TTL and LRU eviction.

Wraps ricecoder-storage’s CacheManager to provide image-specific caching with SHA256-based cache keys, TTL support, and LRU eviction.

Implementations

impl ImageCache

pub fn new() -> ImageResult<Self>

Create a new image cache with default settings.

Uses default cache paths:

• User cache: ~/.ricecoder/cache/images/
• Project cache: projects/ricecoder/.agent/cache/images/

Errors

Returns error if cache directory cannot be created

pub fn with_config(ttl_seconds: u64, max_size_mb: u64) -> ImageResult<Self>

Create a new image cache with custom settings.

Arguments

• ttl_seconds - Time-to-live for cache entries in seconds
• max_size_mb - Maximum cache size in MB

Errors

Returns error if cache directory cannot be created

pub fn get(&self, image_hash: &str) -> ImageResult<Option<ImageAnalysisResult>>

Get a cached analysis result by image hash.

Arguments

• image_hash - SHA256 hash of the image

Returns

Returns the cached analysis result if found and not expired, None if not found or expired

pub fn set( &self, image_hash: &str, result: &ImageAnalysisResult, ) -> ImageResult<()>

Cache an analysis result.

Arguments

• image_hash - SHA256 hash of the image
• result - Analysis result to cache

Errors

Returns error if cache operation fails

pub fn exists(&self, image_hash: &str) -> ImageResult<bool>

Check if an image analysis is cached and not expired.

Arguments

• image_hash - SHA256 hash of the image

pub fn invalidate(&self, image_hash: &str) -> ImageResult<bool>

Invalidate a cached analysis result.

Arguments

• image_hash - SHA256 hash of the image

Returns

Returns Ok(true) if entry was deleted, Ok(false) if entry didn’t exist

pub fn clear(&self) -> ImageResult<()>

Clear all cached analysis results.

Errors

Returns error if cache cannot be cleared

pub fn cleanup_expired(&self) -> ImageResult<usize>

Clean up expired cache entries.

Returns

Returns the number of entries cleaned up

pub fn compute_hash(data: &[u8]) -> String

Compute SHA256 hash of image data.

Arguments

• data - Image file data

Returns

SHA256 hash as hex string

pub fn stats(&self) -> (u64, u64)

Get cache statistics.

Returns

Tuple of (ttl_seconds, max_size_mb)

Trait Implementations

impl Default for ImageCache

fn default() -> Self

Returns the “default value” for a type.