Struct CacheManager 

pub struct CacheManager { /* private fields */ }

Cache manager (main entry point).

Provides a high-level API for caching parsed AST symbols to avoid redundant tree-sitter parsing on repeat queries.

Thread Safety

All operations are thread-safe and can be called concurrently.

Examples

use sqry_core::cache::{CacheManager, CacheConfig};
use sqry_core::hash::hash_file;

let cache = CacheManager::new(CacheConfig::default());

// Check cache before parsing
let content_hash = hash_file(path)?;
if let Some(summaries) = cache.get(path, "rust", content_hash) {
    // Cache hit - reuse symbols
    return Ok(summaries);
}

// Cache miss - parse and store
let summaries = parse_file(path)?;
cache.insert(path, "rust", content_hash, summaries.clone());

Implementations

impl CacheManager

pub fn new(config: CacheConfig) -> Self

Create a new cache manager with the given configuration.

Arguments

• config - Cache configuration (size limits, persistence, etc.)

Examples

use sqry_core::cache::{CacheManager, CacheConfig};

let cache = CacheManager::new(CacheConfig::default());

pub fn get( &self, path: impl AsRef<Path>, language: impl AsRef<str>, content_hash: Blake3Hash, ) -> Option<Arc<[GraphNodeSummary]>>

Get cached symbols for a file.

Returns None if the file is not in cache or the content hash doesn’t match.

Arguments

• path - File path (will be canonicalized)
• language - Language identifier (e.g., “rust”, “python”)
• content_hash - BLAKE3 hash of file contents

Returns

Some(Arc<[GraphNodeSummary]>) on cache hit, None on miss.

Examples

use sqry_core::cache::CacheManager;
use sqry_core::hash::hash_file;

let cache = CacheManager::default();
let hash = hash_file("example.rs")?;

if let Some(summaries) = cache.get("example.rs", "rust", hash) {
    println!("Cache hit! {} symbols", summaries.len());
}

pub fn insert( &self, path: impl AsRef<Path>, language: impl AsRef<str>, content_hash: Blake3Hash, summaries: Vec<GraphNodeSummary>, )

Insert symbols into cache.

Triggers eviction if the cache exceeds the configured size limit.

Arguments

• path - File path (will be canonicalized)
• language - Language identifier (e.g., “rust”, “python”)
• content_hash - BLAKE3 hash of file contents
• summaries - Node summaries to cache

Examples

use sqry_core::cache::{CacheManager, GraphNodeSummary};
use sqry_core::hash::hash_file;

let cache = CacheManager::default();
let hash = hash_file("example.rs")?;
let summaries = vec![/* ... */];

cache.insert("example.rs", "rust", hash, summaries);

pub fn stats(&self) -> CacheStats

Get cache statistics.

Returns metrics including hit rate, miss rate, total size, and evictions.

Examples

use sqry_core::cache::CacheManager;

let cache = CacheManager::default();
let stats = cache.stats();

println!("Hit rate: {:.1}%", stats.hit_rate() * 100.0);
println!("Total size: {} bytes", stats.total_bytes);

pub fn clear(&self)

Clear all cache entries.

Removes all cached symbols and resets statistics. Also clears disk cache if persistence is enabled.

Examples

use sqry_core::cache::CacheManager;

let cache = CacheManager::default();
cache.clear();
assert_eq!(cache.stats().entry_count, 0);

pub fn config(&self) -> &CacheConfig

Get the cache configuration.

Returns a reference to the configuration used to create this manager.

pub fn prune(&self, options: &PruneOptions) -> Result<PruneReport>

Prune the cache based on retention policies.

Removes old or excessive cache entries according to the provided options. Can operate in dry-run mode to preview deletions without modifying the cache.

Arguments

• options - Pruning options (age limit, size limit, dry-run mode, etc.)

Returns

PruneReport containing statistics about the prune operation.

Errors

Returns an error if:

• No retention policy is specified (neither max_age nor max_size)
• Persistence is disabled and no target directory is provided
• IO errors occur during cache traversal or deletion

Examples

use sqry_core::cache::{CacheManager, PruneOptions};
use std::time::Duration;

let cache = CacheManager::default();

// Remove entries older than 7 days
let options = PruneOptions::new()
    .with_max_age(Duration::from_secs(7 * 24 * 3600));
let report = cache.prune(&options)?;

println!("Removed {} entries ({} bytes)",
         report.entries_removed, report.bytes_removed);

Trait Implementations

impl Default for CacheManager

fn default() -> Self

Returns the “default value” for a type.