Struct S3Storage 

pub struct S3Storage { /* private fields */ }

S3-compatible durable object storage.

Implementations

impl S3Storage

pub async fn from_options(options: S3StorageOptions) -> Result<Self>

Build an S3 storage client from explicit options.

impl S3Storage

pub async fn create_bucket_if_missing_for_tests(&self) -> Result<()>

Create the configured bucket when a test harness owns the object store.

Application startup intentionally does not create buckets; production Compose and external S3 deployments provision storage outside the app.

Trait Implementations

impl Clone for S3Storage

fn clone(&self) -> S3Storage

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for S3Storage

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

Formats the value using the given formatter.

impl Storage for S3Storage

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.