Struct ParserCache 

pub struct ParserCache { /* private fields */ }

Concurrent parse cache. Cheap to clone; parser instances are pooled by exact grammar variant while parsed tree cache reads use an RwLock.

A checkout removes one parser from its pool (or creates one if every parser is busy), then releases the pool lock before parsing. Concurrent files in the same grammar therefore do not serialize behind one mutable parser, while completed workers still make their parser reusable. The tree cache is logically keyed by (VFS instance, FileId, adapter, grammar, version).

Implementations

impl ParserCache

pub fn new() -> Self

Construct a cache with the default ParserOptions (which reads BONSAI_PARSE_TIMEOUT_MS from the environment).

pub fn with_options(options: ParserOptions) -> Self

Construct a cache with explicit options. Useful for tests or callers that deliberately need a bounded diagnostic parse.

pub fn parse( &self, file: FileId, adapter: &AdapterArc, vfs: &Vfs, ) -> Result<Arc<ParsedFile>, ParseError>

Parse file with adapter, using any cached tree as a correctly edited incremental reparse hint.

pub fn parse_snapshot( &self, snapshot: &FileSnapshot, adapter: &AdapterArc, vfs: &Vfs, ) -> Result<Arc<ParsedFile>, ParseError>

Parse an exact immutable snapshot.

This is the adapter bridge used by the analyzer database. It prevents a concurrent VFS write from returning a tree for a different source version than the snapshot an adapter is currently walking.

pub fn release(&self, file: FileId, adapter: &AdapterArc, vfs: &Vfs)

Release the cached tree for this exact workspace/file/language key.

Compiler lowering phases call this after all durable facts have been extracted. Exact removal keeps phase-local eviction O(1) and avoids serializing parallel workers behind a whole-cache scan. Edit invalidation remains broader because a file may have been parsed by more than one adapter over the cache’s lifetime.

pub fn invalidate(&self, file: FileId)

Invalidate every cached language interpretation of a single file.

Trait Implementations

impl Clone for ParserCache

fn clone(&self) -> ParserCache

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for ParserCache

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

Formats the value using the given formatter.

impl Default for ParserCache

fn default() -> Self

Returns the “default value” for a type.