Enum ParameterRules 

pub enum ParameterRules {
    FormData,
    Mime,
}

The rules for a Content-Disposition field’s extended parameters, such as filename*, when reading its name or filename. Forms and other MIME parts follow different RFCs, so a disposition does not choose for you.

use base_web_multipart::{ContentDisposition, ParameterRules};
use base_web_media_type::MediaType;
use base_message::FieldType;

let disposition = ContentDisposition::parse(b"attachment; filename=\"EURO rates\"; filename*=utf-8''%e2%82%ac%20rates")?;
assert_eq!(disposition.filename(ParameterRules::Mime)?.as_deref(), Some("€ rates"));
assert!(disposition.filename(ParameterRules::FormData).is_err());

let rules = ParameterRules::for_media_type(&MediaType::parse("multipart/form-data; boundary=x")?);
assert_eq!(rules, ParameterRules::FormData);

Variants

FormData

RFC 7578, for multipart/form-data: extended parameters must not be used, so a disposition with any, including a continuation such as filename*0, is an error. Readers disagree about which of filename and filename* applies, so refusing both keeps them from seeing different names.

Mime

RFC 2231, for other MIME parts, such as an email’s attachments: an extended parameter, such as filename*, is decoded and takes the place of the plain one. Its character set must be UTF-8 or US-ASCII, and its percent-encoding valid; the language is ignored. Continuations, such as filename*0, are not supported yet and are an error.

Implementations

impl ParameterRules

pub fn for_media_type(media_type: &MediaType) -> ParameterRules

The rules for a body of this media type: FormData for multipart/form-data, and Mime for any other.

Trait Implementations

impl Clone for ParameterRules

fn clone(&self) -> ParameterRules

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Copy for ParameterRules

impl Debug for ParameterRules

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

Formats the value using the given formatter.

impl Eq for ParameterRules

impl Hash for ParameterRules

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

where __H: Hasher,

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 PartialEq for ParameterRules

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

Equality operator ==.

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

Inequality operator !=.

impl StructuralPartialEq for ParameterRules