Struct ReleaseCache 

pub struct ReleaseCache { /* private fields */ }

On-disk cache for GitHub release metadata.

Implementations

impl ReleaseCache

pub fn new(cache_dir: PathBuf, ttl: Duration) -> Self

Create a new release cache backed by the given directory.

pub fn read_if_valid(&self, repo: &str) -> Option<Vec<GitHubRelease>>

Return the cached releases if the cache file exists, belongs to the same repo, and has not expired. Returns None on any error (missing, corrupted, expired, wrong repo) — callers should fall back to the network in that case.

pub fn lock_and_recheck( &self, repo: &str, ) -> Result<(ReleaseCacheLockGuard, Option<Vec<GitHubRelease>>)>

Acquire the exclusive cache lock, re-check the cache, and return valid cached releases if another node populated them while we waited.

Returns Ok(Some(releases)) if a valid cache was found under the lock, or Ok(None) if the cache is still stale/missing and the caller should fetch from the network. The returned The returned lock guard must be held until after writing the fresh data so that other nodes block rather than all hitting the API.

Note: lock_exclusive() blocks the calling thread. Callers in async contexts should wrap this in tokio::task::spawn_blocking.

Errors

Returns an error if the lock file cannot be created or acquired.

pub fn write(&self, repo: &str, releases: &[GitHubRelease]) -> Result<()>

Write releases to the cache, using an exclusive file lock to coordinate with other nodes on the same machine.

The write is atomic: data goes to a temp file first, then is renamed over the cache file.

Errors

Returns an error if the lock cannot be acquired or the file cannot be written.

pub fn write_under_lock( &self, _guard: ReleaseCacheLockGuard, repo: &str, releases: &[GitHubRelease], ) -> Result<()>

Write releases to the cache while the caller already holds the lock guard. The guard is consumed to ensure the lock is released after writing.

Errors

Returns an error if the file cannot be written.

Trait Implementations

impl Clone for ReleaseCache

fn clone(&self) -> ReleaseCache

Returns a duplicate of the value.

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

Performs copy-assignment from source.