Struct UploadedFile 

pub struct UploadedFile {
    pub filename: String,
    pub content_type: String,
    pub data: Vec<u8>,
}

A file that has been uploaded but not yet stored

This represents the in-memory state of an uploaded file before it’s persisted to the storage backend.

Examples

use acton_htmx::storage::UploadedFile;

let file = UploadedFile {
    filename: "document.pdf".to_string(),
    content_type: "application/pdf".to_string(),
    data: vec![0x25, 0x50, 0x44, 0x46], // PDF magic bytes
};

assert_eq!(file.size(), 4);

Fields

filename: String

Original filename from the upload

content_type: String

MIME content type (e.g., “image/png”, “application/pdf”)

data: Vec<u8>

File data as bytes

Implementations

impl UploadedFile

pub fn new( filename: impl Into<String>, content_type: impl Into<String>, data: Vec<u8>, ) -> Self

Creates a new uploaded file

Examples

use acton_htmx::storage::UploadedFile;

let file = UploadedFile::new(
    "photo.jpg",
    "image/jpeg",
    vec![0xFF, 0xD8, 0xFF], // JPEG magic bytes
);

pub fn size(&self) -> u64

Returns the size of the file in bytes

Examples

use acton_htmx::storage::UploadedFile;

let file = UploadedFile::new("test.txt", "text/plain", vec![1, 2, 3, 4, 5]);
assert_eq!(file.size(), 5);

pub fn validate_size(&self, max_bytes: u64) -> StorageResult<()>

Validates the file size against a maximum limit

Errors

Returns StorageError::FileSizeExceeded if the file is larger than max_bytes

Examples

use acton_htmx::storage::UploadedFile;

let file = UploadedFile::new("test.txt", "text/plain", vec![1, 2, 3]);

// Passes - file is 3 bytes, limit is 10
assert!(file.validate_size(10).is_ok());

// Fails - file is 3 bytes, limit is 2
assert!(file.validate_size(2).is_err());

pub fn validate_mime(&self, allowed_types: &[&str]) -> StorageResult<()>

Validates the file’s MIME type against an allowlist

Errors

Returns StorageError::InvalidMimeType if the content type is not in allowed_types

Examples

use acton_htmx::storage::UploadedFile;

let file = UploadedFile::new("photo.jpg", "image/jpeg", vec![]);

// Passes - JPEG is in the allowlist
assert!(file.validate_mime(&["image/jpeg", "image/png"]).is_ok());

// Fails - JPEG is not in the allowlist of PNG-only
assert!(file.validate_mime(&["image/png"]).is_err());

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

Extracts the file extension from the filename

Returns None if the filename has no extension

Examples

use acton_htmx::storage::UploadedFile;

let file = UploadedFile::new("document.pdf", "application/pdf", vec![]);
assert_eq!(file.extension(), Some("pdf"));

let no_ext = UploadedFile::new("README", "text/plain", vec![]);
assert_eq!(no_ext.extension(), None);

Trait Implementations

impl Clone for UploadedFile

fn clone(&self) -> UploadedFile

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for UploadedFile

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

Formats the value using the given formatter.