aptu-coder-core

Core library for code structure analysis using tree-sitter.

Features

Directory analysis - File tree with LOC, function, and class counts
File analysis - Functions, classes, and imports with signatures and line ranges; returns graceful fallback (line count, file head, no AST) for unsupported extensions
Symbol call graphs - Callers and callees across a directory with configurable depth
Module index - Lightweight function and import index (~75% smaller than full file analysis); returns graceful fallback (empty index with note) for unsupported extensions
Edit operations - In-file edits: overwrite, exact-block replace
In-memory analysis - analyze_str parses source text directly without a file path; returns the same FileAnalysisOutput as analyze_file
Multi-language - Astro, C/C++, C#, CSS, Fortran, Go, HTML, Java, JavaScript, JSON, Kotlin, Markdown, Python, Rust, TOML, TSX, TypeScript, YAML
Pagination - Cursor-based pagination for large outputs
Caching - LRU cache for parsed results with mtime-based invalidation
Parallel - Rayon-based parallel file analysis

Installation

Add to your Cargo.toml:

[dependencies]
aptu-coder-core = "*"

The current version is published on crates.io. Replace "*" with the latest version string if you prefer a pinned dependency.

Example

use aptu_coder_core::{analyze_directory, analyze_file, analyze_str};
use std::path::Path;

fn main() -> Result<(), Box<dyn std::error::Error>> {
    // Analyze a directory
    let output = analyze_directory(Path::new("src/"), None)?;
    println!("{} files", output.files.len());

    // Analyze a single file
    let output = analyze_file("src/lib.rs", None)?;
    println!("{}", output.formatted);

    // Analyze source text in memory (no file path required)
    let source = std::fs::read_to_string("src/lib.rs")?;
    let output = analyze_str(&source, "rs", None)?;
    println!("{}", output.formatted);

    Ok(())
}

Supported Languages

See the MCP server README for the full table with file extensions and feature flags.

Tree-sitter (full AST extraction): C/C++, C#, CSS (lang-css), Fortran, Go, HTML, Java, JavaScript, Kotlin, Markdown, Python, Rust, TSX, TypeScript, YAML (lang-yaml)

Regex extraction (imports/symbols via pattern matching): Astro, JSON, TOML; CSS and YAML fall back to regex when compiled without their tree-sitter feature flag

For any other extension, analyze_file returns a graceful fallback (line count and the first 50 lines of the file) rather than an error.

Configuration

AnalysisConfig provides resource limits for library consumers:

use aptu_coder_core::AnalysisConfig;

let config = AnalysisConfig {
    max_file_bytes: Some(1_000_000), // reserved, currently a no-op
    parse_timeout_micros: None,      // parse timeout in microseconds; None disables timeout
    cache_capacity: None,            // use default LRU capacity
};

Support

For questions and support, visit clouatre.ca.

License

Apache-2.0. See LICENSE.

aptu-coder-core 0.18.3