Struct LocalStorage 

pub struct LocalStorage { /* private fields */ }

Filesystem-backed storage rooted at a configured directory.

Implementations

impl LocalStorage

pub fn new(root: impl AsRef<Path>) -> Self

Create local storage rooted at root.

pub fn from_options(options: LocalStorageOptions) -> Self

Create local storage from explicit options.

Trait Implementations

impl Clone for LocalStorage

fn clone(&self) -> LocalStorage

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for LocalStorage

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

Formats the value using the given formatter.

impl Storage for LocalStorage

fn put<'life0, 'life1, 'life2, 'async_trait>( &'life0 self, key: &'life1 StorageKey, content: &'life2 [u8], intent: StorageWriteIntent, ) -> Pin<Box<dyn Future<Output = Result<StorageKey>> + Send + 'async_trait>>

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

Store content at a storage-relative key. Implementations must not overwrite.

fn put_file<'life0, 'life1, 'life2, 'async_trait>( &'life0 self, key: &'life1 StorageKey, source: &'life2 Path, intent: StorageWriteIntent, ) -> Pin<Box<dyn Future<Output = Result<StorageKey>> + Send + 'async_trait>>

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

Store a local file at a storage-relative key. Implementations must not overwrite.

fn promote<'life0, 'life1, 'life2, 'async_trait>( &'life0 self, temporary_key: &'life1 StorageKey, durable_key: &'life2 StorageKey, ) -> Pin<Box<dyn Future<Output = Result<StorageKey>> + Send + 'async_trait>>

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

Promote a temporary object to a durable storage-relative key without overwriting.

fn get<'life0, 'life1, 'async_trait>( &'life0 self, key: &'life1 StorageKey, intent: StorageWriteIntent, ) -> Pin<Box<dyn Future<Output = Result<Vec<u8>>> + Send + 'async_trait>>

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

Read content from a storage-relative key with an object-size cap.

fn get_to_file<'life0, 'life1, 'life2, 'async_trait>( &'life0 self, key: &'life1 StorageKey, destination: &'life2 Path, intent: StorageWriteIntent, ) -> Pin<Box<dyn Future<Output = Result<()>> + Send + 'async_trait>>

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

Download an object into a local file with an object-size cap.

fn exists<'life0, 'life1, 'async_trait>( &'life0 self, key: &'life1 StorageKey, ) -> Pin<Box<dyn Future<Output = Result<bool>> + Send + 'async_trait>>

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

Return whether a storage-relative key exists.

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

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

Delete a storage-relative key if it exists.

fn list_prefix<'life0, 'life1, 'async_trait>( &'life0 self, prefix: &'life1 StorageKey, ) -> Pin<Box<dyn Future<Output = Result<Vec<StorageKey>>> + Send + 'async_trait>>

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

List object keys below a storage-relative prefix.

fn delete_prefix_older_than<'life0, 'life1, 'async_trait>( &'life0 self, prefix: &'life1 StorageKey, older_than: SystemTime, ) -> Pin<Box<dyn Future<Output = Result<u64>> + Send + 'async_trait>>

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

Delete every object below a storage-relative prefix older than the cutoff.

fn delete_prefix<'life0, 'life1, 'async_trait>( &'life0 self, prefix: &'life1 StorageKey, ) -> Pin<Box<dyn Future<Output = Result<u64>> + Send + 'async_trait>>

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

Delete every object below a storage-relative prefix.