Struct DependencyGraphBuilder 

pub struct DependencyGraphBuilder { /* private fields */ }

Coordinates dependency extraction across multiple languages to build a unified dependency graph.

The builder uses language-specific extractors to parse import/dependency statements and progressively constructs a DependencyGraph. It manages the storage backend for persistence and provides batch processing capabilities.

Usage Pattern

1. Create builder with storage backend
2. Extract files using extract_file() or extract_files()
3. Access graph with graph()
4. Optionally persist with persist()

Examples

let storage = Box::new(InMemoryStorage::new());
let mut builder = DependencyGraphBuilder::new(storage);

// Extract single file
builder.extract_file(std::path::Path::new("src/main.rs")).await?;

// Batch extraction
let files = vec![
    std::path::PathBuf::from("src/utils.rs"),
    std::path::PathBuf::from("src/config.ts"),
];
builder.extract_files(&files).await?;

// Access graph
println!("Graph has {} nodes", builder.graph().node_count());

// Persist to storage
builder.persist().await?;

Implementations

impl DependencyGraphBuilder

pub fn new(storage: Box<dyn StorageBackend>) -> Self

Creates a new dependency graph builder with the given storage backend.

Arguments

• storage - Storage backend for persisting fingerprints and graph data

Examples

use thread_flow::incremental::dependency_builder::DependencyGraphBuilder;
use thread_flow::incremental::storage::InMemoryStorage;

let storage = Box::new(InMemoryStorage::new());
let builder = DependencyGraphBuilder::new(storage);

pub fn graph(&self) -> &DependencyGraph

Accesses the built dependency graph.

Returns a reference to the DependencyGraph constructed from all extracted files.

Examples

let storage = Box::new(InMemoryStorage::new());
let builder = DependencyGraphBuilder::new(storage);
let graph = builder.graph();
assert_eq!(graph.node_count(), 0); // Empty graph initially

pub async fn extract_file(&mut self, file_path: &Path) -> Result<(), BuildError>

Extracts dependencies from a single file.

Detects the file’s language, uses the appropriate extractor, and adds the resulting edges to the dependency graph.

Arguments

• file_path - Path to the source file to analyze

Errors

Returns an error if:

• The file’s language is not supported
• The file cannot be read
• Dependency extraction fails

Examples

let storage = Box::new(InMemoryStorage::new());
let mut builder = DependencyGraphBuilder::new(storage);

builder.extract_file(std::path::Path::new("src/main.rs")).await?;

pub async fn extract_files( &mut self, files: &[PathBuf], ) -> Result<(), BuildError>

Extracts dependencies from multiple files in batch.

Processes all files and continues on individual extraction failures. Returns an error only if all extractions fail.

Arguments

• files - Slice of file paths to analyze

Errors

Returns the last error encountered if ANY extraction fails. Individual extraction errors are logged as warnings.

Examples

let storage = Box::new(InMemoryStorage::new());
let mut builder = DependencyGraphBuilder::new(storage);

let files = vec![
    std::path::PathBuf::from("src/main.rs"),
    std::path::PathBuf::from("src/lib.rs"),
];
builder.extract_files(&files).await?;

pub async fn persist(&self) -> Result<(), BuildError>

Persists the dependency graph to the storage backend.

Saves all fingerprints and edges to the configured storage.

Errors

Returns an error if storage operations fail.

Examples

let storage = Box::new(InMemoryStorage::new());
let mut builder = DependencyGraphBuilder::new(storage);

// ... extract files ...

// Persist to storage
builder.persist().await?;