Struct GraphIntrospection 

pub struct GraphIntrospection {
    pub backend_type: String,
    pub node_count: usize,
    pub edge_count: EdgeCount,
    pub cache_stats: CacheStats,
    pub memory_usage: Option<usize>,
    pub file_size: Option<u64>,
    pub wal_size: Option<u64>,
    pub is_in_memory: bool,
}

Comprehensive introspection data for a graph instance.

This struct provides a JSON-serializable snapshot of graph state, designed for both human debugging and LLM consumption.

Example

use sqlitegraph::{open_graph, GraphConfig};

let graph = open_graph("my_graph.db", &GraphConfig::sqlite())?;
let intro = graph.introspect()?;

println!("Backend: {}", intro.backend_type);
println!("Nodes: {}", intro.node_count);
println!("Cache hit ratio: {:.2}%", intro.cache_stats.hit_ratio());

// Serialize to JSON for LLM consumption
let json = serde_json::to_string_pretty(&intro)?;

Fields

backend_type: String

Backend type identifier (“sqlite” or “native-v2”)

node_count: usize

Total number of nodes in the graph

edge_count: EdgeCount

Total number of edges in the graph (estimated for large graphs)

cache_stats: CacheStats

Adjacency cache statistics

memory_usage: Option<usize>

Memory usage estimate in bytes (if available)

file_size: Option<u64>

Database file size in bytes (for file-based backends)

wal_size: Option<u64>

WAL file size in bytes (for backends with WAL enabled)

is_in_memory: bool

Whether this is an in-memory database

Trait Implementations

impl Clone for GraphIntrospection

fn clone(&self) -> GraphIntrospection

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for GraphIntrospection

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

Formats the value using the given formatter.

impl Serialize for GraphIntrospection

fn serialize<__S>(&self, __serializer: __S) -> Result<__S::Ok, __S::Error>

where __S: Serializer,

Serialize this value into the given Serde serializer.