Struct Upload 

#[non_exhaustive]
pub struct Upload { /* private fields */ }

A file posted in a multipart form.

Implementations

impl Upload

pub fn new( file_name: impl Into<String>, content_type: impl Into<String>, bytes: impl Into<Bytes>, ) -> Self

A file as a browser would send it, e.g. in tests: Upload::new("photo.png", "image/png", bytes).

pub fn file_name(&self) -> &str

The name the browser gave, e.g. coffee photo.JPG. Don’t trust it for paths.

pub fn content_type(&self) -> &str

The type the browser declared, e.g. image/jpeg. Don’t trust it for security.

pub fn bytes(&self) -> &Bytes

The file’s content.

pub fn size(&self) -> usize

Size of the content in bytes.

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

The lowercase extension of the original name, if it is a plain one.

pub fn sniffed_type(&self) -> Option<&'static str>

The type found in the file’s first bytes, for the formats Renox knows.

pub fn is_image(&self) -> bool

Whether the content really is a PNG, JPEG, GIF or WebP image.

pub fn dimensions(&self) -> Option<(u32, u32)>

The image’s width and height in pixels, read from its header (PNG, JPEG, GIF or WebP); None for anything else or a damaged header.

pub async fn store(&self, storage: &Storage, dir: &str) -> Result<String>

Stores the file privately under dir with a random name; returns its key.

pub async fn store_public(&self, storage: &Storage, dir: &str) -> Result<String>

Stores the file under public/{dir} so storage.url(key) can link to it.

Trait Implementations

impl Clone for Upload

fn clone(&self) -> Self

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for Upload

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for Upload

fn deserialize<D: Deserializer<'de>>(deserializer: D) -> Result<Self, D::Error>

Deserialize this value from the given Serde deserializer.

impl FieldValue for Upload

fn inspect(&self) -> Inspected

What rules see of the value.

fn db_value(&self) -> DbValue

The value as a query parameter, for unique and exists.

impl Serialize for Upload

Old input shows the file name; the bytes never go into the session.

fn serialize<S: Serializer>(&self, serializer: S) -> Result<S::Ok, S::Error>

Serialize this value into the given Serde serializer.