Struct GraphStorage 

pub struct GraphStorage { /* private fields */ }

Storage manager for unified graph and analysis files.

GraphStorage manages the .sqry/ directory structure, providing access to graph files (manifest, snapshot) and analysis artifacts (CSR, SCC, condensation DAGs).

Directory Structure

.sqry/
├── graph/
│   ├── manifest.json     # Graph metadata (node/edge counts, checksums)
│   ├── snapshot.sqry     # Binary graph snapshot
│   └── config/           # Build configuration
│       └── config.json   # Configuration used during build
└── analysis/
    ├── adjacency.csr     # CSR adjacency matrix
    ├── scc_calls.scc     # SCC data for call edges
    ├── scc_imports.scc   # SCC data for import edges
    ├── cond_calls.dag    # Condensation DAG for call edges
    └── ...               # Other edge-kind artifacts

Example

use sqry_core::graph::unified::persistence::GraphStorage;
use std::path::Path;

let storage = GraphStorage::new(Path::new("/path/to/project"));

if storage.exists() {
    let manifest = storage.load_manifest()?;
    let age = storage.snapshot_age(&manifest)?;
    println!("Graph built {} seconds ago", age.as_secs());
}

Implementations

impl GraphStorage

pub fn new(root_path: &Path) -> Self

Creates a new storage manager for the given project root.

Arguments

• root_path - Root directory of the project

Returns

A GraphStorage instance configured for {root_path}/.sqry/

pub fn graph_dir(&self) -> &Path

Returns the path to the .sqry/graph/ directory.

pub fn analysis_dir(&self) -> &Path

Returns the path to the .sqry/analysis/ directory.

pub fn analysis_scc_path(&self, edge_kind: &str) -> PathBuf

Returns the path to an SCC artifact file for a given edge kind.

Example: analysis_scc_path("calls") returns .sqry/analysis/scc_calls.scc

pub fn analysis_cond_path(&self, edge_kind: &str) -> PathBuf

Returns the path to a condensation DAG artifact file for a given edge kind.

Example: analysis_cond_path("calls") returns .sqry/analysis/cond_calls.dag

pub fn analysis_csr_path(&self) -> PathBuf

Returns the path to the CSR adjacency artifact file.

pub fn manifest_path(&self) -> &Path

Returns the path to the manifest file.

pub fn snapshot_path(&self) -> &Path

Returns the path to the snapshot file.

pub fn exists(&self) -> bool

Checks if a unified graph exists (manifest file exists).

pub fn snapshot_exists(&self) -> bool

Checks if the snapshot file exists.

pub fn load_manifest(&self) -> Result<Manifest>

Loads the graph manifest from disk.

Errors

Returns an error if the manifest file cannot be read or parsed.

pub fn snapshot_age(&self, manifest: &Manifest) -> Result<Duration>

Computes the age of the snapshot based on the manifest timestamp.

Arguments

• manifest - The loaded manifest containing the build timestamp

Errors

Returns an error if the timestamp cannot be parsed or if system time is invalid.

pub fn config_dir(&self) -> PathBuf

Returns the path to the config directory.

pub fn config_path(&self) -> PathBuf

Returns the path to the config file.

Trait Implementations

impl Clone for GraphStorage

fn clone(&self) -> GraphStorage

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for GraphStorage

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.