Struct Storage 

pub struct Storage { /* private fields */ }

Storage facade for file operations.

Implementations

impl Storage

pub fn new() -> Self

Create a new storage instance with a default local disk.

pub fn with_config(default_disk: &str, configs: Vec<(&str, DiskConfig)>) -> Self

Create storage with custom configuration.

pub fn with_storage_config(config: StorageConfig) -> Self

Create storage from a StorageConfig (typically loaded from environment).

Example

use ferro_storage::{Storage, StorageConfig};

// Load configuration from environment variables
let config = StorageConfig::from_env();
let storage = Storage::with_storage_config(config);

// Or use the builder pattern
let config = StorageConfig::new("local")
    .disk("local", DiskConfig::local("./storage"))
    .disk("public", DiskConfig::local("./public").with_url("/storage"));
let storage = Storage::with_storage_config(config);

pub fn disk(&self, name: &str) -> Result<Disk, Error>

Get a specific disk.

pub fn default_disk(&self) -> Result<Disk, Error>

Get the default disk.

pub fn register_disk( &self, name: impl Into<String>, driver: Arc<dyn StorageDriver>, )

Register a disk.

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

Check if a file exists.

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

Get file contents.

pub async fn get_string(&self, path: &str) -> Result<String, Error>

Get file as string.

pub async fn put( &self, path: &str, contents: impl Into<Bytes>, ) -> Result<(), Error>

Put file contents.

pub async fn put_with_options( &self, path: &str, contents: impl Into<Bytes>, options: PutOptions, ) -> Result<(), Error>

Put with options.

pub async fn delete(&self, path: &str) -> Result<(), Error>

Delete a file.

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

Copy a file.

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

Move a file.

pub async fn url(&self, path: &str) -> Result<String, Error>

Get file URL.

Trait Implementations

impl Clone for Storage

fn clone(&self) -> Storage

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Default for Storage

fn default() -> Self

Returns the “default value” for a type.