Struct GrammarLoader 

pub struct GrammarLoader { /* private fields */ }

Dynamic grammar loader with caching.

Implementations

impl GrammarLoader

pub fn new() -> Self

Create a new grammar loader with default search paths.

Search order:

1. NORMALIZE_GRAMMAR_PATH environment variable (colon-separated)
2. ~/.config/normalize/grammars/

pub fn with_paths(paths: Vec<PathBuf>) -> Self

Create a loader with custom search paths.

pub fn add_path(&mut self, path: PathBuf)

Add a search path.

pub fn get(&self, name: &str) -> Result<Language, GrammarLoadError>

Get a grammar by name.

Returns Ok(lang) if found and loaded successfully, Err(GrammarLoadError::NotFound) if no .so/.dylib exists in any search path, and other Err variants for load or ABI failures.

pub fn get_highlights(&self, name: &str) -> Option<Arc<String>>

Get the highlight query for a grammar.

Returns None if no highlight query found for the grammar. Query files are {name}.highlights.scm in the grammar search paths.

pub fn get_injections(&self, name: &str) -> Option<Arc<String>>

Get the injection query for a grammar.

Returns None if no injection query found for the grammar. Query files are {name}.injections.scm in the grammar search paths.

pub fn get_locals(&self, name: &str) -> Option<Arc<String>>

Get the locals query for a grammar.

Returns None if no locals query found for the grammar. Query files are {name}.locals.scm in the grammar search paths.

pub fn get_complexity(&self, name: &str) -> Option<Arc<String>>

Get the complexity query for a grammar.

Returns None if no complexity query found for the grammar. Query files are {name}.complexity.scm in the grammar search paths. Uses @complexity captures for nodes that increase cyclomatic complexity, and @nesting captures for nodes that increase nesting depth.

pub fn get_calls(&self, name: &str) -> Option<Arc<String>>

Get the calls query for a grammar.

Returns None if no calls query found for the grammar. Query files are {name}.calls.scm in the grammar search paths. Uses @call captures for call expressions and @call.qualifier for method call receivers (e.g. foo in foo.bar()).

pub fn get_types(&self, name: &str) -> Option<Arc<String>>

Get the types query for a grammar.

Returns the bundled query for supported languages, or an external file if one exists at {name}.types.scm in the grammar search paths (external wins).

pub fn get_tags(&self, name: &str) -> Option<Arc<String>>

Get the tags query for a grammar.

Tags queries use the tree-sitter tags format with @name.definition.* and @name.reference.* captures for symbol navigation (used by GitHub Linguist, nvim-treesitter, etc.).

Returns the bundled query for supported languages, or an external file if one exists at {name}.tags.scm in the grammar search paths (external wins).

pub fn get_imports(&self, name: &str) -> Option<Arc<String>>

Get the imports query for a grammar.

Returns the bundled query for supported languages, or an external file if one exists at {name}.imports.scm in the grammar search paths (external wins).

pub fn get_decorations(&self, name: &str) -> Option<Arc<String>>

Get the decorations query for a grammar.

Returns the bundled query for supported languages, or an external file if one exists at {name}.decorations.scm in the grammar search paths (external wins). Uses @decoration captures for doc comments, attributes, decorators, and annotations that immediately precede a definition.

pub fn get_test_regions(&self, name: &str) -> Option<Arc<String>>

Get the test-regions query for a grammar.

Returns None if no test-regions query exists for the grammar. Query files are {name}.test_regions.scm in the grammar search paths. Uses @test_region captures for byte ranges of test-only code that rules may opt to skip (via applies_in_tests = false, the default).

Languages without a .test_regions.scm simply have no AST-based test detection — path-based excludes (e.g. **/tests/** or *_test.go) remain the way to scope rules in those cases.

pub fn get_compiled_query( &self, grammar_name: &str, query_type: &str, query_str: &str, ) -> Option<Arc<Query>>

Get a compiled tree-sitter query, using the cache to avoid recompilation.

grammar_name is the grammar name (e.g. “rust”, “python”). query_type is the query category (e.g. “tags”, “complexity”, “calls”). query_str is the raw .scm query string.

Returns the compiled query or None if compilation fails.

pub fn available_external(&self) -> Vec<String>

List available grammars in search paths.

pub fn available_external_with_paths(&self) -> Vec<(String, PathBuf)>

List available grammars in search paths, with their file paths.

Trait Implementations

impl Default for GrammarLoader

fn default() -> Self

Returns the “default value” for a type.