Struct File

pub struct File {
    pub path: PathBuf,
    pub filename: Option<String>,
    pub size: u64,
    pub content_type: Mime,
}

An uploaded file that was received as part of multipart/form-data parsing.

Files are streamed to disk because they may not fit in memory.

Fields

path: PathBuf

The path to the temporary file where the data was saved.

filename: Option<String>

The filename that was specified in the request, unfiltered.

Warning

This may or may not be legal on the local filesystem, and so you should not blindly append it to a Path, as such behavior could easily be exploited by a malicious client.

size: u64

The size of the file, in bytes.

content_type: Mime

Get the MIME type (Content-Type value) of this file, if supplied by the client, or "applicaton/octet-stream" otherwise.

Warning

You should treat this value as untrustworthy because it can be spoofed by the client.

Implementations

impl File

pub fn open(&self) -> Result<File>

Attempts to open the file in read-only mode.

Trait Implementations

impl Clone for File

fn clone(&self) -> File

Returns a copy of the value.

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

Performs copy-assignment from source.

impl Debug for File

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

Formats the value using the given formatter.

impl FromValue for File

Extracts from File variant.

fn from_value(value: &Value) -> Option<File>

Returns Some if the conversion was successful, None otherwise.

impl PartialEq for File

Checks only for equality of the file’s path.

fn eq(&self, other: &File) -> bool

Tests for self and other values to be equal, and is used by ==.

fn ne(&self, other: &Rhs) -> bool

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.