Struct ContextExtractor 

pub struct ContextExtractor { /* private fields */ }

Context extractor for extracting AST context from files

Uses tree-sitter to parse files and extract parent/ancestor information for each node.

Refactoring (FT-A.1 + FT-A.2 Complete)

This struct has been refactored to use PluginManager directly, eliminating the dependency on the deprecated SymbolExtractor. The new implementation:

• Parses files only once using plugin.parse_ast()
• Builds graph nodes using plugin.graph_builder() (no re-parse)
• Builds context from the same tree (no re-parse)

This provides ~40-50% performance improvement for context extraction operations.

Implementations

impl ContextExtractor

pub fn new() -> Self

Create a new context extractor with default plugin manager

Note

This creates an empty PluginManager. Use with_plugin_manager() instead to provide a properly configured plugin manager with registered plugins.

pub fn with_plugin_manager(plugin_manager: PluginManager) -> Self

Create a new context extractor with a specific plugin manager

This is the recommended way to create a ContextExtractor. It uses PluginManager for all operations, eliminating double-parsing.

Arguments

• plugin_manager - Configured plugin manager with registered language plugins

Example

use sqry_core::ast::ContextExtractor;
use sqry_core::plugin::PluginManager;

let mut manager = PluginManager::new();
// Register plugins...
let extractor = ContextExtractor::with_plugin_manager(manager);

pub fn extract_from_file(&self, path: &Path) -> Result<Vec<ContextualMatch>>

Extract contextual matches from a file

Modern Implementation (FT-A.1 + FT-A.2 Complete)

This method uses PluginManager directly, parsing the file only ONCE. The refactoring eliminates the double-parsing issue:

Before (v0.4.x and earlier):

1. SymbolExtractor.extract_from_file() → parse #1
2. ContextExtractor reads file and parses again → parse #2

After (v0.5.0+):

1. plugin.parse_ast() → parse once
2. plugin.graph_builder().build_graph(tree, ...) → reuse parse
3. Build context from same tree → reuse parse

Performance Impact: ~40-50% faster for context extraction operations.

Arguments

• path - Path to the source file

Returns

Vector of contextual matches (nodes with context)

Errors

Returns error if:

• File cannot be read
• File contains invalid UTF-8
• Parser fails to parse the file
• No plugin supports the file path

pub fn extract_from_directory( &self, root: &Path, ) -> Result<Vec<ContextualMatch>>

Extract context from a directory recursively

Errors

Returns anyhow::Error when traversal fails (e.g., directory unreadable) or when extract_from_file propagates extraction errors.

Trait Implementations

impl Default for ContextExtractor

fn default() -> Self

Returns the “default value” for a type.