Struct RustDependencyExtractor 

pub struct RustDependencyExtractor { /* private fields */ }

Extracts Rust import and export dependencies using tree-sitter AST traversal.

Uses tree-sitter’s Rust grammar to parse use and pub use declarations without executing Rust code. Thread-safe and reusable across files.

Architecture

The extractor operates in two phases:

1. Parse: Tree-sitter parses the source into an AST
2. Walk: Recursive traversal extracts use_declaration nodes and their nested structure (scoped identifiers, use lists, wildcards, aliases)

Module path resolution (converting "crate::config" to "src/config.rs") is handled separately by resolve_module_path.

Implementations

impl RustDependencyExtractor

pub fn new() -> Self

Creates a new Rust dependency extractor.

pub fn extract_imports( &self, source: &str, _file_path: &Path, ) -> Result<Vec<RustImportInfo>, ExtractionError>

Extracts all use declarations from Rust source code.

Parses the source with tree-sitter and walks the AST to find all use_declaration nodes. Both public and private use statements are returned as imports (the caller may filter by visibility if needed).

Arguments

• source - Rust source code to analyze.
• _file_path - Path of the source file (reserved for error context).

Returns

A vector of RustImportInfo records, one per use declaration.

Errors

Returns ExtractionError::ParseError if tree-sitter cannot parse the source.

pub fn extract_exports( &self, source: &str, _file_path: &Path, ) -> Result<Vec<ExportInfo>, ExtractionError>

Extracts all pub use re-export declarations from Rust source code.

Only public or restricted-visibility use statements are returned.

Arguments

• source - Rust source code to analyze.
• _file_path - Path of the source file (reserved for error context).

Returns

A vector of ExportInfo records, one per re-exported symbol. For pub use types::{Config, Settings}, two records are returned.

Errors

Returns ExtractionError::ParseError if tree-sitter cannot parse the source.

pub fn resolve_module_path( &self, source_file: &Path, module_path: &str, ) -> Result<PathBuf, ExtractionError>

Resolves a Rust module path to a filesystem path.

Handles the three Rust-specific path prefixes:

• crate:: - resolves from the src/ root of the crate
• super:: - resolves from the parent module directory
• self:: - resolves from the current module directory

External crate paths (e.g., std::collections) cannot be resolved to local files and return an error.

Arguments

• source_file - The file containing the use statement.
• module_path - The module path (e.g., "crate::config", "super::utils").

Returns

The resolved filesystem path to the target module file (e.g., src/config.rs).

Errors

Returns ExtractionError::ResolutionError if:

• The path is an external crate (no crate::, super::, or self:: prefix)
• The source file has no parent directory for super:: resolution

pub fn extract_dependency_edges( &self, source: &str, file_path: &Path, ) -> Result<Vec<DependencyEdge>, ExtractionError>

Extract [DependencyEdge] values from a Rust source file.

Combines import extraction with path resolution to produce edges suitable for the incremental dependency graph. Only resolvable internal imports produce edges; external crates are silently skipped.

Errors

Returns an error if the source file cannot be parsed.

Trait Implementations

impl Default for RustDependencyExtractor

fn default() -> Self

Returns the “default value” for a type.