Struct Storage 

pub struct Storage { /* private fields */ }

A file storage disk: state.storage, or a named one from state.disk_named(name).

Implementations

impl Storage

pub fn name(&self) -> Option<&str>

The disk’s name: None for state.storage.

pub async fn put(&self, key: &str, bytes: Bytes) -> Result

Writes bytes to key, replacing any file there.

pub async fn get(&self, key: &str) -> Result<Option<Bytes>>

The file’s bytes, or None if there is no such key.

pub async fn exists(&self, key: &str) -> Result<bool>

Whether a file exists at key.

pub async fn delete(&self, key: &str) -> Result

Deletes the file; deleting a missing key is not an error.

pub async fn list(&self, prefix: &str) -> Result<Vec<FileInfo>>

The URL of a public file (a key under public/). The files under prefix (a folder like invoices/2026, or "" for all), at any depth, sorted by key.

for file in state.storage.list("invoices/2026").await? {
    println!("{} ({} bytes)", file.key, file.size);
}
state.storage.copy("public/logo.png", "public/logo-old.png").await?;
state.storage.rename("uploads/tmp/a.pdf", "invoices/2026/a.pdf").await?;
let removed = state.storage.delete_all("uploads/tmp").await?;

pub async fn size(&self, key: &str) -> Result<Option<u64>>

The size of a file in bytes, if it exists.

pub async fn copy(&self, from: &str, to: &str) -> Result

Copies a file, replacing to if it exists. A missing from is a 404.

pub async fn rename(&self, from: &str, to: &str) -> Result

Moves a file (Laravel’s move), replacing to if it exists. A missing from is a 404.

pub async fn delete_all(&self, prefix: &str) -> Result<usize>

Deletes every file under prefix (not "": that would be all of them); returns how many.

pub fn url(&self, key: &str) -> String

The public URL of key (under public/): /storage/… on the local disk, or under STORAGE_URL on S3 when set.

pub async fn temporary_url( &self, state: &AppState, key: &str, ttl: Duration, ) -> Result<String>

A link to any file that works for ttl: signed by Renox for the local disk, presigned by S3 otherwise (for at most 7 days).

Trait Implementations

impl Clone for Storage

fn clone(&self) -> Self

Returns a duplicate of the value.

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

Performs copy-assignment from source.