Struct GraphHandle 

pub struct GraphHandle { /* private fields */ }

Wait-free read / serialized-write handle to the graph.

Readers load a frozen ReadSnapshot via read (lock-free via ArcSwap). Writers take a Mutex lock, mutate the underlying KnowledgeGraph, and publish a fresh snapshot on unlock via the WriteGuard drop glue.

Implementations

impl GraphHandle

pub fn new(path: &Path) -> Result<Self>

Open or create the graph at path, seeding the initial snapshot.

pub fn read(&self) -> ReadSnapshot

Lock-free read snapshot. Holds an Arc reference to the frozen graph data.

pub fn write(&self) -> WriteGuard<'_>

Serialised write access. Returns a guard that publishes a fresh snapshot when dropped (or when WriteGuard::publish is called eagerly).