Enum Accepted 

#[non_exhaustive]
pub enum Accepted<'a> {
    Family(Family),
    Type(&'a str),
    Suffix(&'a str),
}

One entry in a file field’s accept list.

Three shapes rather than a string, and all three are in the measured sites: the MNW server writes image/*, image/jpeg,image/png,image/webp, .zip,.dmg,.exe,.appimage,.deb,.tar.gz,.clap,.vst3 and, in one place, .csv,text/csv. A single string would carry all of them and answer nothing about any of them.

Why the list is not just a filter

It is read twice. Once to decide what the picker offers, which any of the three shapes serves, and once to decide which disclosure the field gets: a preview for a picture, a duration or a waveform for a sound. There is one upload shape and a media upload is that shape with more of it shown, so the accept list is what says which more. family is that question answered once here instead of a media-type parser in each renderer.

A suffix names no family, on purpose

.mp3 is audio in fact, and nothing here says so. A suffix-to-family table in a published crate is a mapping that goes stale, disagrees with the host’s own idea of what a file is, and is wrong the first time somebody hands it a container. A call site that wants a picture’s preview writes Family::Image or image/jpeg; a call site listing installer suffixes wants no disclosure anyway, which is the measured case.

Added 0.31.0, f7261a5a.

Variants (Non-exhaustive)

Non-exhaustive enums could have additional variants added in future. Therefore, when matching against variants of non-exhaustive enums, an extra wildcard arm must be added to account for any future variants.

Family(Family)

Every file of a family: image/* and its siblings.

Type(&'a str)

One media type, written the way a media type is written: image/jpeg, text/csv.

Suffix(&'a str)

One file-name suffix, written with its leading dot: .zip, .tar.gz.

A suffix and not an extension, because .tar.gz is a measured site and is two dots.

Implementations

impl<'a> Accepted<'a>

pub fn family(self) -> Option<Family>

The family this entry belongs to, when it names one.

None for a Suffix and for any media type outside the three families, which is the honest answer rather than a missing one: the description did not say.

pub const fn as_str(self) -> &'a str

How a host that wants one string writes this entry.

A webview’s accept attribute takes exactly these spellings, and a terminal listing what it will take reads the same words.

Trait Implementations

impl<'a> Clone for Accepted<'a>

fn clone(&self) -> Accepted<'a>

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl<'a> Copy for Accepted<'a>

impl<'a> Debug for Accepted<'a>

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

Formats the value using the given formatter.

impl<'a> Eq for Accepted<'a>

impl<'a> Hash for Accepted<'a>

fn hash<__H: Hasher>(&self, state: &mut __H)

Feeds this value into the given Hasher.

fn hash_slice<H>(data: &[Self], state: &mut H)

where H: Hasher, Self: Sized,

Feeds a slice of this type into the given Hasher.

impl<'a> PartialEq for Accepted<'a>

fn eq(&self, other: &Accepted<'a>) -> bool

Equality operator ==.

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

Inequality operator !=.

impl<'a> StructuralPartialEq for Accepted<'a>