Struct UploadFile 

pub struct UploadFile {
    pub field_name: String,
    pub filename: String,
    pub content_type: String,
    /* private fields */
}

An uploaded file with metadata and FastAPI-style async file operations.

Fields

field_name: String

The field name.

filename: String

The original filename.

content_type: String

Content-Type of the file.

Implementations

impl UploadFile

pub fn from_part(part: Part) -> Option<UploadFile>

Create a new UploadFile from a Part.

Returns None if the part is not a file.

pub fn from_part_with_spool_threshold( part: Part, spool_threshold: usize, ) -> Option<UploadFile>

Create a new UploadFile from a Part with a custom spool threshold.

Returns None if the part is not a file.

pub fn size(&self) -> usize

Get the file size in bytes.

pub fn is_spooled(&self) -> bool

Returns true when this file has been spooled to a temporary file.

pub fn spooled_path(&self) -> Option<&Path>

Path to the spooled temporary file, if this upload is backed by disk.

pub fn bytes(&self) -> Result<Vec<u8>, Error>

Read file contents without changing the current cursor.

pub async fn read(&mut self, size: Option<usize>) -> Result<Vec<u8>, Error>

Read from the current cursor position.

• size = Some(n): read up to n bytes
• size = None: read until EOF

pub async fn write(&mut self, bytes: &[u8]) -> Result<usize, Error>

Write bytes at the current cursor position.

Returns the number of bytes written.

pub async fn seek(&mut self, position: SeekFrom) -> Result<u64, Error>

Move the current cursor.

pub async fn close(&mut self) -> Result<(), Error>

Close the file handle and clean up any temporary storage.

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

Get the file extension from the filename.

Trait Implementations

impl Debug for UploadFile

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

Formats the value using the given formatter.

impl Drop for UploadFile

fn drop(&mut self)

Executes the destructor for this type.