Struct FsStorage 

pub struct FsStorage { /* private fields */ }

A StorageBackend rooted at a local directory.

Paths passed to the backend are treated as relative to root; any path escaping the root (absolute, .., symlink-traversing) is rejected.

Implementations

impl FsStorage

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

Create a backend serving files under root.

Trait Implementations

impl Clone for FsStorage

fn clone(&self) -> FsStorage

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for FsStorage

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

Formats the value using the given formatter.

impl StorageBackend for FsStorage

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

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

Return metadata for path, or None when it does not exist.

fn read_stream<'life0, 'life1, 'async_trait>( &'life0 self, path: &'life1 str, range: RangeSpec, ) -> Pin<Box<dyn Future<Output = Result<Box<dyn Read + Send>, StorageError>> + Send + 'async_trait>>

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

Open a read stream for path restricted to range.

fn write_stream<'life0, 'life1, 'async_trait>( &'life0 self, path: &'life1 str, mode: WriteMode, ) -> Pin<Box<dyn Future<Output = Result<Box<dyn UploadSink>, StorageError>> + Send + 'async_trait>>

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

Open a write stream for path according to mode.

fn write_stream_session<'life0, 'life1, 'life2, 'async_trait>( &'life0 self, path: &'life1 str, session: &'life2 str, mode: WriteMode, ) -> Pin<Box<dyn Future<Output = Result<Box<dyn UploadSink>, StorageError>> + Send + 'async_trait>>

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

Open a positional write stream for a concurrent “session” upload.

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

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

List the children of directory path (or the mount root when path is empty).

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

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

Recursively create path (and parents) as a directory.

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

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

Remove path (file, or directory recursively).

fn cleanup_stale_sessions<'life0, 'async_trait>( &'life0 self, max_age: Duration, ) -> Pin<Box<dyn Future<Output = Result<usize, StorageError>> + Send + 'async_trait>>

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

Remove stale in-progress “session” upload temps (tus Expiration).