Struct DataStore 

pub struct DataStore { /* private fields */ }

Central data store for the application

Implementations

impl DataStore

pub fn new() -> Self

Create a new empty data store

pub fn with_persistence(path: impl Into<String>) -> Result<Self>

Create a data store with persistence to a JSON file

pub async fn load_collection( &self, name: &str, path: impl AsRef<Path>, ) -> Result<()>

Load initial data from a JSON file into a collection

pub async fn get_collection(&self, name: &str) -> Option<Vec<Value>>

Get all items from a collection

pub async fn get_item(&self, collection: &str, index: usize) -> Option<Value>

Get a single item from a collection by index

pub async fn find_by( &self, collection: &str, field: &str, value: &Value, ) -> Vec<Value>

Find items in a collection by a field value

pub async fn find_one_by( &self, collection: &str, field: &str, value: &Value, ) -> Option<Value>

Find a single item by a field value

pub async fn create(&self, collection: &str, item: Value) -> Result<Value>

Add an item to a collection (CREATE)

pub async fn update( &self, collection: &str, id: &Value, updates: Value, ) -> Result<Option<Value>>

Update an item in a collection (UPDATE)

pub async fn delete(&self, collection: &str, id: &Value) -> Result<bool>

Delete an item from a collection (DELETE)

pub async fn set(&self, key: &str, value: Value) -> Result<()>

Set a single value in the store

pub async fn get(&self, key: &str) -> Option<Value>

Get a single value from the store

pub async fn atomic_modify<F>(&self, key: &str, f: F) -> Result<Value>

where F: FnOnce(Option<&Value>) -> Value,

Atomically read-modify-write a value in the store. The closure receives the current value (or None) and returns the new value. The write lock is held for the entire operation, preventing race conditions.

pub async fn remove(&self, key: &str) -> Result<Option<Value>>

Delete a single value from the store

pub async fn as_context(&self) -> HashMap<String, Value>

Get all store data as a context for template rendering

pub async fn set_collection(&self, name: &str, items: Vec<Value>) -> Result<()>

Replace an entire collection (useful for file/remote data sources)

Trait Implementations

impl Clone for DataStore

fn clone(&self) -> DataStore

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Default for DataStore

fn default() -> Self

Returns the “default value” for a type.