Struct FileParser 

pub struct FileParser { /* private fields */ }

Core parsing engine. Handles language detection, parse tree caching, symbol table caching, and query pattern execution via tree-sitter.

Implementations

impl FileParser

pub fn new() -> Self

Create a new FileParser with an empty parse cache.

pub fn set_warm_cache(&mut self, cache: SymbolCache)

Attach a pre-warmed symbol cache from background indexing.

pub fn parse(&mut self, path: &Path) -> Result<(&Tree, LangId), AftError>

Parse a file, returning the tree and detected language. Uses cache if the file hasn’t been modified since last parse.

pub fn parse_cloned(&mut self, path: &Path) -> Result<(Tree, LangId), AftError>

Like FileParser::parse but returns an owned Tree clone.

Useful when the caller needs to hold the tree while also calling other mutable methods on this parser.

pub fn extract_symbols(&mut self, path: &Path) -> Result<Vec<Symbol>, AftError>

Extract symbols from a file using language-specific query patterns. Results are cached by (path, mtime) — subsequent calls for unchanged files return the cached symbol table without re-parsing.

pub fn invalidate_symbols(&mut self, path: &Path)

Invalidate cached symbols for a specific file (e.g., after an edit).