Struct DiskCache 

pub struct DiskCache { /* private fields */ }

Disk-based response cache with configurable TTL.

Caches HTTP response text as JSON files keyed by a hash of the request URL, query parameters, and optional POST body. Expired entries are treated as cache misses and silently ignored.

Atomic writes

Writes use a temporary file + rename pattern to prevent partial reads from concurrent access.

Implementations

impl DiskCache

pub fn new(cache_dir: PathBuf, ttl: Duration) -> Result<DiskCache, Error>

Create a cache storing entries in cache_dir with the given TTL.

Creates the directory (and parents) if it doesn’t exist.

pub fn default_location(ttl: Duration) -> Result<DiskCache, Error>

Create a cache in the platform-standard cache directory.

• Linux: ~/.cache/papers/requests
• macOS: ~/Library/Caches/papers/requests
• Windows: {FOLDERID_LocalAppData}/papers/requests

Returns Err if no cache directory can be determined or created.

pub fn get( &self, url: &str, query: &[(&str, String)], body: Option<&str>, ) -> Option<String>

Look up a cached response.

Returns None on cache miss, expired entry, or any I/O / parse error.

pub fn set( &self, url: &str, query: &[(&str, String)], body: Option<&str>, response: &str, )

Store a response in the cache.

Writes atomically via a .tmp file + rename. Errors are silently ignored — a failed cache write should never break a request.

pub fn prune(&self)

Remove expired entries and leftover .tmp files from the cache directory.

Called automatically on construction. Errors on individual files are silently ignored.

Trait Implementations

impl Clone for DiskCache

fn clone(&self) -> DiskCache

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for DiskCache

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

Formats the value using the given formatter.