Struct LocalFileStorage 

pub struct LocalFileStorage { /* private fields */ }

Local filesystem storage backend

Stores files in a local directory with UUID-based organization. Each file is stored in a subdirectory based on the first 2 characters of its UUID to avoid hitting filesystem limits on files per directory.

Directory Structure

/var/uploads/
├── 55/
│   └── 550e8400-e29b-41d4-a716-446655440000/
│       └── document.pdf
├── a3/
│   └── a3bb189e-8bf9-4a9a-b5c7-9f9c3b8e5d7a/
│       └── image.png

Examples

use acton_htmx::storage::{LocalFileStorage, FileStorage, UploadedFile};
use std::path::PathBuf;

// Create storage (creates directory if it doesn't exist)
let storage = LocalFileStorage::new(PathBuf::from("/var/uploads"))?;

// Store a file
let file = UploadedFile::new("photo.jpg", "image/jpeg", vec![/* ... */]);
let stored = storage.store(file).await?;

// File is now at: /var/uploads/55/550e8400.../photo.jpg
println!("Stored at: {}", stored.storage_path);

Implementations

impl LocalFileStorage

pub fn new(base_path: PathBuf) -> StorageResult<Self>

Creates a new local file storage instance

This will verify that the base path exists and is writable.

Errors

Returns an error if:

• The base path doesn’t exist and cannot be created
• The base path is not a directory
• Insufficient permissions to write to the directory

Examples

use acton_htmx::storage::LocalFileStorage;
use std::path::PathBuf;

let storage = LocalFileStorage::new(PathBuf::from("/var/uploads"))?;

Trait Implementations

impl Clone for LocalFileStorage

fn clone(&self) -> LocalFileStorage

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for LocalFileStorage

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

Formats the value using the given formatter.

impl FileStorage for LocalFileStorage

fn store<'life0, 'async_trait>( &'life0 self, file: UploadedFile, ) -> Pin<Box<dyn Future<Output = StorageResult<StoredFile>> + Send + 'async_trait>>

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

Stores an uploaded file and returns metadata about the stored file

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

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

Retrieves file data by ID

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

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

Deletes a file by ID

fn url<'life0, 'life1, 'async_trait>( &'life0 self, id: &'life1 str, ) -> Pin<Box<dyn Future<Output = StorageResult<String>> + Send + 'async_trait>>

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

Returns a URL for accessing the file

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

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

Checks if a file exists

fn get_metadata<'life0, 'life1, 'async_trait>( &'life0 self, id: &'life1 str, ) -> Pin<Box<dyn Future<Output = StorageResult<StoredFile>> + Send + 'async_trait>>

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

Retrieves file metadata by ID