Struct LocalStorage 

pub struct LocalStorage { /* private fields */ }

Local filesystem storage backend.

Files are written under base_dir/<prefix>/<ulid>.<ext>. Path traversal is rejected at the storage layer — .. components and absolute paths return an error before any filesystem operation is attempted.

Requires the local feature (enabled by default).

Implementations

impl LocalStorage

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

Create a new LocalStorage rooted at base_dir.

The directory does not need to exist at construction time; it is created on the first store call.

Trait Implementations

impl FileStorage for LocalStorage

fn store<'life0, 'life1, 'life2, 'async_trait>( &'life0 self, prefix: &'life1 str, file: &'life2 UploadedFile, ) -> Pin<Box<dyn Future<Output = Result<StoredFile, Error>> + Send + 'async_trait>>

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

Store a buffered in-memory file under prefix/.

fn store_stream<'life0, 'life1, 'life2, 'async_trait>( &'life0 self, prefix: &'life1 str, stream: &'life2 mut BufferedUpload, ) -> Pin<Box<dyn Future<Output = Result<StoredFile, Error>> + Send + 'async_trait>>

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

Store a chunked upload under prefix/.

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

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

Delete a file by its storage path (as returned by store).

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

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

Return true if a file exists at the given storage path.