Struct Store 

pub struct Store { /* private fields */ }

Implementations

impl Store

pub fn open(dir: impl AsRef<Path>) -> Result<Self, StoreError>

pub fn open_in_memory_with_paths( data_dir: impl AsRef<Path>, ) -> Result<Self, StoreError>

Open an ephemeral store with no filesystem persistence.

data_dir is only the logical base for relative image references. The directory is not created or modified.

pub fn open_default(explicit: Option<PathBuf>) -> Result<Self, StoreError>

pub fn paths(&self) -> &Paths

pub fn data_dir(&self) -> &Path

pub fn images_dir(&self) -> &Path

pub fn database_path(&self) -> &Path

pub fn revision(&self) -> Result<u64, StoreError>

Cheap external-change probe for a long-running TUI.

pub fn snapshot(&self) -> Result<StoreData, StoreError>

pub fn load_settings(&self) -> Result<Settings, StoreError>

pub fn ensure_category( &mut self, name: impl Into<String>, description: Option<String>, ) -> Result<(Category, bool), StoreError>

Atomically return an exact-name category or create it. Finding an existing match does not write the store or advance its revision.

pub fn ensure_label( &mut self, name: impl Into<String>, color: Option<LabelColor>, ) -> Result<(Label, bool), StoreError>

Atomically return an exact-name label or create it. Finding an existing match does not write the store or advance its revision.

pub fn save_settings(&mut self, settings: &Settings) -> Result<(), StoreError>

pub fn update<R>( &mut self, operation: impl FnOnce(&mut StoreData) -> Result<R, StoreError>, ) -> Result<R, StoreError>

Run a read-modify-write against a fresh snapshot under BEGIN IMMEDIATE. Every successful call increments revision once.

pub fn update_with_snapshot<R>( &mut self, operation: impl FnOnce(&mut StoreData) -> Result<R, StoreError>, ) -> Result<(R, StoreData), StoreError>

Commit a mutation and return the exact normalized snapshot that was persisted, including its new revision.

pub fn update_if_revision<R>( &mut self, expected_revision: u64, operation: impl FnOnce(&mut StoreData) -> Result<R, StoreError>, ) -> Result<R, StoreError>

Apply a mutation only if the caller’s snapshot is still current.

pub fn update_if_revision_with_snapshot<R>( &mut self, expected_revision: u64, operation: impl FnOnce(&mut StoreData) -> Result<R, StoreError>, ) -> Result<(R, StoreData), StoreError>