Struct LocalStorage 

pub struct LocalStorage { /* private fields */ }

Available on crate features storage-azure or storage-gcs or storage-local or storage-s3 only.

Stores objects as files under a root directory on local disk.

Keys are treated as relative paths under root; parent directories are created automatically on put. A key containing a .. segment is rejected to prevent escaping root — the same defense used by the config-driven proxy’s static-file action.

Content type is not persisted — plain files on disk have no metadata slot for it. Pair this with a static-file route (which detects MIME type from the file extension) if you need to serve uploaded files back over HTTP; see with_base_url.

Implementations

impl LocalStorage

pub fn new(root: impl Into<String>) -> LocalStorage

Create a store rooted at root. The directory itself does not need to exist yet — it (and any key subdirectories) are created on put.

pub fn with_base_url(self, base_url: impl Into<String>) -> LocalStorage

Set the URL prefix returned by Storage::url — e.g. /uploads if root is also served as a static directory under that path. Without a base URL, url() falls back to the object’s filesystem path.

Trait Implementations

impl Storage for LocalStorage

fn put_stream( &self, key: &str, reader: &mut dyn Read, _content_type: &str, ) -> Result<String, StorageError>

Writes to a temporary file beside the target as it reads, then renames it into place: a failed or partial upload never replaces an existing object.

fn put( &self, key: &str, data: &[u8], _content_type: &str, ) -> Result<String, StorageError>

Store data under key, overwriting any existing object at that key. Returns the key that was stored (backends that normalize or namespace keys may return a different string than the one passed in).

fn get(&self, key: &str) -> Result<Vec<u8>, StorageError>

Retrieve the bytes stored under key.

fn delete(&self, key: &str) -> Result<(), StorageError>

Delete the object stored under key. Backends generally treat deleting a missing key as a no-op success, matching S3’s semantics.

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

A URL for retrieving key. For LocalStorage this is only meaningful if a base URL was configured (e.g. because the directory is also served as static files); for S3Storage it’s the object’s HTTPS URL. This performs no I/O and never fails.