Struct SharedGraph 

pub struct SharedGraph { /* private fields */ }

Thread-safe, clonable handle to an EntityGraph.

Uses parking_lot::RwLock for reader-writer locking, allowing concurrent reads with exclusive writes. Cloning shares the underlying graph (via Arc).

Implementations

impl SharedGraph

pub fn new(graph: EntityGraph) -> Self

Wrap an EntityGraph in a thread-safe handle.

pub fn read<F, R>(&self, f: F) -> R

where F: FnOnce(&EntityGraph) -> R,

Execute a closure with shared (read) access to the graph.

pub fn write<F, R>(&self, f: F) -> R

where F: FnOnce(&mut EntityGraph) -> R,

Execute a closure with exclusive (write) access to the graph.

pub fn add(&self, entity: HDict) -> Result<String, GraphError>

Add an entity. See EntityGraph::add.

pub fn get(&self, ref_val: &str) -> Option<HDict>

Get an entity by ref value.

Returns an owned clone because the read lock is released before the caller uses the value.

pub fn update(&self, ref_val: &str, changes: HDict) -> Result<(), GraphError>

Update an entity. See EntityGraph::update.

pub fn remove(&self, ref_val: &str) -> Result<HDict, GraphError>

Remove an entity. See EntityGraph::remove.

pub fn read_filter( &self, filter_expr: &str, limit: usize, ) -> Result<HGrid, GraphError>

Run a filter expression and return a grid.

pub fn len(&self) -> usize

Number of entities.

pub fn is_empty(&self) -> bool

Returns true if the graph has no entities.

pub fn all_entities(&self) -> Vec<HDict>

Return all entities as owned clones.

pub fn contains(&self, ref_val: &str) -> bool

Check if an entity with the given ref value exists.

pub fn version(&self) -> u64

Current graph version.

pub fn read_all( &self, filter_expr: &str, limit: usize, ) -> Result<Vec<HDict>, GraphError>

Run a filter and return matching entity dicts (cloned).

pub fn refs_from(&self, ref_val: &str, ref_type: Option<&str>) -> Vec<String>

Get ref values that the given entity points to.

pub fn refs_to(&self, ref_val: &str, ref_type: Option<&str>) -> Vec<String>

Get ref values of entities that point to the given entity.

pub fn changes_since(&self, version: u64) -> Vec<GraphDiff>

Get changelog entries since a given version.

pub fn entities_fitting(&self, spec_name: &str) -> Vec<HDict>

Find all entities that structurally fit a spec/type name.

Returns owned clones. See EntityGraph::entities_fitting.

pub fn validate(&self) -> Vec<ValidationIssue>

Validate all entities against the namespace and check for dangling refs.

See EntityGraph::validate.

pub fn all_edges(&self) -> Vec<(String, String, String)>

Return all edges as (source_ref, ref_tag, target_ref) tuples.

pub fn neighbors( &self, ref_val: &str, hops: usize, ref_types: Option<&[&str]>, ) -> (Vec<HDict>, Vec<(String, String, String)>)

BFS neighborhood: entities and edges within hops of ref_val.

pub fn shortest_path(&self, from: &str, to: &str) -> Vec<String>

BFS shortest path from from to to.

pub fn subtree(&self, root: &str, max_depth: usize) -> Vec<(HDict, usize)>

Subtree rooted at root up to max_depth levels.

Returns entities with their depth from root.

Trait Implementations

impl Clone for SharedGraph

fn clone(&self) -> Self

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Default for SharedGraph

fn default() -> Self

Returns the “default value” for a type.