Struct ParseCache 

pub struct ParseCache { /* private fields */ }

Available on crate feature parser-ruff only.

Process-local parse cache. Cheap to clone (the inner DashMap is behind an Arc).

Implementations

impl ParseCache

pub fn new() -> Self

Create an empty cache.

pub fn len(&self) -> usize

Number of cached entries.

pub fn is_empty(&self) -> bool

true when the cache holds no entries.

pub fn peek(&self, path: &Path) -> Option<ParseOutcome>

Retrieve a cached ParseOutcome without re-parsing. Returns None when the file has not been parsed yet (or was invalidated). Useful for read-only consumers like a /metrics exporter.

pub fn get_or_parse(&self, path: &Path) -> Result<ParseOutcome, ParseError>

Parse path if the cached hash differs from the on-disk hash, or return the cached ParseOutcome when they match.

Errors

Returns ParseError::Io if the file cannot be read, or ParseError::Parse / ParseError::InvalidIdentifier if the underlying parse fails.

pub fn invalidate(&self, path: &Path)

Drop the cache entry for path, if any. Used by the dag-processor when its watcher reports a delete / unlink.

pub fn clear(&self)

Drop every entry. Used on configuration reload.

Trait Implementations

impl Clone for ParseCache

fn clone(&self) -> ParseCache

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for ParseCache

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

Formats the value using the given formatter.

impl Default for ParseCache

fn default() -> ParseCache

Returns the “default value” for a type.