Struct FileStorage 

pub struct FileStorage { /* private fields */ }

JSON storage backed by one file per key, with SHA-256 checksums.

Each file carries a checksum that is verified on load, and filenames are hashes of the key so arbitrary keys are safe and path traversal is impossible. The Durability mode controls the write strategy; the default (FileStorage::open) is Durability::Fast.

Implementations

impl FileStorage

pub fn open(dir: impl AsRef<Path>) -> StorageResult<Self>

Open (creating if necessary) a fast, in-place storage rooted at dir.

pub fn open_with( dir: impl AsRef<Path>, durability: Durability, ) -> StorageResult<Self>

Open with an explicit Durability mode.

pub fn durability(&self) -> Durability

The write-durability mode in effect.

Trait Implementations

impl Storage for FileStorage

fn save<'life0, 'life1, 'life2, 'async_trait>( &'life0 self, key: &'life1 str, value: &'life2 Value, ) -> Pin<Box<dyn Future<Output = StorageResult<()>> + Send + 'async_trait>>

where Self: 'async_trait, 'life0: 'async_trait, 'life1: 'async_trait, 'life2: 'async_trait,

Persist value under key, overwriting any existing entry.

fn load<'life0, 'life1, 'async_trait>( &'life0 self, key: &'life1 str, ) -> Pin<Box<dyn Future<Output = StorageResult<Option<Value>>> + Send + 'async_trait>>

where Self: 'async_trait, 'life0: 'async_trait, 'life1: 'async_trait,

Load the value stored under key, or None if absent.

fn delete<'life0, 'life1, 'async_trait>( &'life0 self, key: &'life1 str, ) -> Pin<Box<dyn Future<Output = StorageResult<()>> + Send + 'async_trait>>

where Self: 'async_trait, 'life0: 'async_trait, 'life1: 'async_trait,

Remove key. Removing a missing key is a no-op (not an error).

fn list<'life0, 'async_trait>( &'life0 self, ) -> Pin<Box<dyn Future<Output = StorageResult<Vec<String>>> + Send + 'async_trait>>

where Self: 'async_trait, 'life0: 'async_trait,

List all keys currently present.