Struct IssueCache 

pub struct IssueCache { /* private fields */ }

The GitHub fetch cache shared by route and verify-decision.

Also counts how many items a run reused and the age of the oldest, so the CLI can say so (reuse_note) — stale input is never silent.

Implementations

impl IssueCache

pub fn new(dir: PathBuf, ttl: Duration, refresh: bool) -> Self

A cache rooted at dir (the directory holding <owner>/<repo>/), reusing entries younger than ttl. refresh re-fetches everything while still writing the fresh copies back.

pub fn disabled() -> Self

A cache that never reads or writes anything.

pub fn from_env_with( env: &impl EnvSource, base: Option<PathBuf>, account: Option<&str>, refresh: bool, ) -> Self

The cache configured from env (in production, the SettingsEnv the command already loaded), rooted under base (dirs::cache_dir()).

account is the account_scope digest of the gh login the fetches will run as. Without one (gh could not say who it is) the cache is disabled, since an entry it wrote could later be served to another login. With no base directory the cache is disabled too. A zero TTL disables reads and writes but keeps the root, so the sweep still clears what an earlier run cached.

pub fn prune_expired(&self)

Deletes every expired entry, and every temp file a crashed write orphaned. Best-effort, like everything else here; blocking, so run it on the same blocking thread as the fetch.

Age is the file’s mtime, which a write sets to when it stored the entry, so the sweep never reads or parses an entry. It covers every account’s entries, and with a zero TTL it removes them all.

pub fn usage(&self) -> Option<CacheUsage>

What this run reused, for the machine-readable output, or None when it reused nothing. The stderr reuse_note is the human’s copy of the same facts; a script reading only stdout needs this.

pub fn reuse_note(&self) -> Option<String>

A one-line note for stderr when this run reused cached items, naming how many, the oldest’s age, and how to bypass the cache.

Trait Implementations

impl Debug for IssueCache

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

Formats the value using the given formatter.