Struct DiskService 

pub struct DiskService { /* private fields */ }

A Service backed by a directory on the local filesystem.

Implementations

impl DiskService

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

Create a disk service rooted at root, named name.

pub fn public(self, public: bool) -> Self

Mark objects as publicly readable (affects URL generation only).

impl DiskService

The absolute root path (useful for tests and diagnostics).

pub fn root(&self) -> &Path

Trait Implementations

impl Service for DiskService

fn name(&self) -> &str

Name of the configured service (e.g. local, amazon).

fn public(&self) -> bool

Whether objects are publicly readable without signing.

fn upload<'life0, 'life1, 'life2, 'async_trait>( &'life0 self, key: &'life1 str, data: Vec<u8>, _content_type: Option<&'life2 str>, ) -> Pin<Box<dyn Future<Output = Result<()>> + Send + 'async_trait>>

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

Store data under key, overwriting any existing object.

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

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

Read the full object at key.

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

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

Delete the object at key. Idempotent: a missing object is not an error.

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

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

Whether an object exists at key.

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

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

Size in bytes of the object at key.

fn url<'life0, 'life1, 'life2, 'async_trait>( &'life0 self, key: &'life1 str, opts: &'life2 UrlOptions, ) -> Pin<Box<dyn Future<Output = Result<Option<String>>> + Send + 'async_trait>>

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

A backend-native URL to GET the object, if the backend can mint one (presigned for S3/Azure/R2, or a public URL). None means “no native URL — serve it through the app” (disk, memory).

fn presigned_put<'life0, 'life1, 'life2, 'async_trait>( &'life0 self, key: &'life1 str, opts: &'life2 UrlOptions, ) -> Pin<Box<dyn Future<Output = Result<Option<String>>> + Send + 'async_trait>>

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

A backend-native URL a client may PUT to for a direct upload, if supported. None means “no native direct upload — use the app’s disk upload route”.