Struct AcidJson

pub struct AcidJson<T: Serialize + DeserializeOwned + Sync> { /* private fields */ }

A “smart pointer” to a JSON file on disk. Can be used in a RwLock-like fashion for thread-safe, ACID-guaranteed updates to the underlying file. Is “Arc-like” can can be cheaply cloned to create more references to the same file.

Implementations

impl<T: Serialize + DeserializeOwned + Sync> AcidJson<T>

pub fn open(fname: &Path) -> Result<Self, AcidJsonError>

Opens an AcidJson.

pub fn open_or_else( fname: &Path, gen_def: impl FnOnce() -> T, ) -> Result<Self, AcidJsonError>

Opens an AcidJson, with a default value if the file does not yet exist.

pub fn read(&self) -> AcidJsonReadGuard<'_, T>

Read-locks the AcidJson.

pub fn write(&self) -> AcidJsonWriteGuard<'_, T>

Write-locks the AcidJson.

Trait Implementations

impl<T: Clone + Serialize + DeserializeOwned + Sync> Clone for AcidJson<T>

fn clone(&self) -> AcidJson<T>

Returns a copy of the value.

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

Performs copy-assignment from source.

impl<T: Debug + Serialize + DeserializeOwned + Sync> Debug for AcidJson<T>

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.