Struct DoubletsLinkStore 

pub struct DoubletsLinkStore { /* private fields */ }

File-mapped binary storage backed by doublets-rs.

Implementations

impl DoubletsLinkStore

pub fn create_file(path: impl AsRef<Path>) -> Result<Self, StorageError>

Creates a new empty file-mapped doublets store at path.

Any existing file at path is removed first.

Errors

Returns StorageError when the file cannot be created or initialized.

pub fn open_file(path: impl AsRef<Path>) -> Result<Self, StorageError>

Opens an existing file-mapped doublets store, creating the file when it does not yet exist.

Errors

Returns StorageError when the file cannot be opened or the doublets store cannot be initialized.

pub fn replace_with_network( &mut self, network: &LinkNetwork, ) -> Result<(), StorageError>

Replaces the logical binary contents with a lossless encoding of network.

Errors

Returns StorageError when the file-mapped doublets store cannot be updated.

pub fn snapshot_path(path: impl AsRef<Path>) -> PathBuf

Returns the durable companion snapshot path for a doublets store path.

pub fn to_network(&self) -> Result<LinkNetwork, StorageError>

Reconstructs a LinkNetwork from this binary store.

Errors

Returns StorageError when the binary data is malformed.

pub fn create_with_id( &mut self, id: LinkId, references: &[LinkId], metadata: &LinkMetadata, registered_term: bool, ) -> Result<(), StorageError>

Creates a logical link using an explicit id.

This is used by network import paths to preserve text and binary id equivalence. Normal callers can use LinkStore::create.

Errors

Returns StorageError when the id already exists or the backend cannot write the physical records.

Trait Implementations

impl LinkStore for DoubletsLinkStore

Available on crate feature doublets only.

fn create( &mut self, references: &[LinkId], metadata: LinkMetadata, ) -> Result<LinkId, StorageError>

Creates a link and returns its stable id.

fn read(&self, id: LinkId) -> Result<Option<Link>, StorageError>

Reads a link by id.

fn update( &mut self, id: LinkId, references: &[LinkId], metadata: LinkMetadata, ) -> Result<bool, StorageError>

Replaces an existing link’s references and metadata.

fn delete(&mut self, id: LinkId) -> Result<bool, StorageError>

Deletes a link by id.

fn search(&self, query: &LinkStoreQuery) -> Result<Vec<Link>, StorageError>

Returns links matching query.

fn count(&self, query: &LinkStoreQuery) -> Result<usize, StorageError>

Counts links matching query.