Struct DiskCache 

pub struct DiskCache { /* private fields */ }

Implementations

impl DiskCache

pub fn discover() -> Option<DiskCache>

$SVA_CACHE, else the XDG cache home. Never under target/: cargo clean would throw away hours of rendering, and an installed binary has no build directory to write into.

pub fn under(root: impl Into<PathBuf>) -> DiskCache

A key hashes what a node says, not the engine rendering it, so each engine keeps its own directory under root; no other one’s can answer it, so they go.

pub fn at(dir: impl Into<PathBuf>) -> DiskCache

pub fn bounded(dir: impl Into<PathBuf>, max_bytes: u64) -> DiskCache

pub fn coded(self, codec: Box<dyn SampleCodec>) -> DiskCache

pub fn storing_everything(self) -> DiskCache

The threshold is policy: a caller measuring reuse itself wants every node stored.

Trait Implementations

impl Cache for DiskCache

fn worth_storing(&self, cost: Duration, bytes: usize, kind: PayloadKind) -> bool

Only samples have an encoding here; neither other payload is offered a file.

fn store( &self, key: Hash, payload: &Payload, traces: &[FilterTrace], label: Option<&Label>, )

Renamed into place: a racing reader sees one whole entry or the other.

fn dir(&self) -> Option<&Path>

fn max_bytes(&self) -> u64

fn held_bytes(&self) -> u64

fn evicted_bytes(&self) -> u64

fn faults(&self) -> u64

fn holds(&self, key: Hash) -> bool

fn load(&self, key: Hash, node: &str, expected: Expected) -> Option<Entry>

fn peek(&self, key: Hash, node: &str, expected: Expected) -> Option<Entry>

load with no side effect: no recency, promotion, fault or removal.

fn sweep(&self)