Struct FileRestorationStore 

pub struct FileRestorationStore { /* private fields */ }

File-backed default persistence store. A new snapshot is completely flushed to a temporary sibling and then renamed into place. On platforms where replacement cannot be atomic, the rename fails rather than deleting the only known-good file; the next mutation may retry it. This guarantees that a reported failed save never overwrites the previous valid snapshot, while filesystem/power-loss durability remains platform/filesystem-specific.

Implementations

impl FileRestorationStore

pub fn new(path: impl Into<PathBuf>) -> Self

pub fn for_application( application_id: &str, ) -> Result<Self, RestorationStoreError>

Derives an application-specific user state path with the operating system’s standard project-directory conventions. application_id must be stable across launches and filesystem-safe: empty, path-separator, current/parent-directory, NUL, and control-character ids are rejected rather than escaping the application data directory.

pub fn path(&self) -> &Path

Trait Implementations

impl Clone for FileRestorationStore

fn clone(&self) -> Self

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for FileRestorationStore

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

Formats the value using the given formatter.

impl RestorationStore for FileRestorationStore

fn load(&self) -> Result<Option<Vec<u8>>, RestorationStoreError>

fn save(&self, bytes: &[u8]) -> Result<(), RestorationStoreError>

fn remove(&self) -> Result<(), RestorationStoreError>

fn location(&self) -> Option<PathBuf>

Returns a human-readable location when one exists. In-memory stores intentionally return None.