Struct Cache 

pub struct Cache {
    root: PathBuf,
    path: PathBuf,
    executable: Option<Checksum>,
    formatter: Option<Checksum>,
    state: Mutex<State>,
}

Cache bound to one workspace and the exact tools executing this run.

Fields

root: PathBuf

path: PathBuf

executable: Option<Checksum>

formatter: Option<Checksum>

state: Mutex<State>

Implementations

impl Cache

pub fn load( root: &Path, executable: Option<Checksum>, formatter: Option<Checksum>, ) -> Self

Load the cache when it is present and valid.

Malformed or unreadable cache data is treated as a cold cache.

pub fn is_current( &self, workspace: Option<&TreeSnapshot>, filters: &[Box<str>], require_metadata_validation: bool, ) -> bool

Return whether a previous successful run proves every selected output current.

pub fn reuse_formatted(&self, output: &Path, rendered: &str) -> Option<String>

Reuse the existing formatted output when its complete formatter input and output match.

pub fn record_formatted(&self, output: &Path, rendered: &str, formatted: &str)

Record one successfully formatted template.

pub fn record_success( &self, workspace: &TreeSnapshot, filters: &[Box<str>], output_paths: &[PathBuf], metadata_validated: bool, )

Record a successful run after every selected output is known to be current.

pub fn persist(&self)

Persist the current cache atomically.

Cache persistence failures do not affect generator correctness.

fn state(&self) -> MutexGuard<'_, State>

Trait Implementations

impl Debug for Cache

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

Formats the value using the given formatter.