Struct FieldSpec 

pub struct FieldSpec<'a> {
    pub name: &'a str,
    pub source: FieldSpecSource<'a>,
    pub content_type: Option<&'a str>,
    pub filename: Option<&'a str>,
}

Available on crate feature multipart only.

A parsed name=… field spec for use with Form::with_field_spec.

The same compact convention used by curl -F and friends:

Spec	Meaning
name=value	text field
name=@path	file upload (mime guessed from extension)
name=@-	file upload from stdin
name=<path	file content as a text field (not an upload)
name=<-	text field content from stdin

Modifiers may follow the source, separated by ;:

• ;type=mime/sub overrides the part’s Content-Type
• ;filename=name overrides the filename parameter

Example: avatar=@./photo.png;type=image/png;filename=me.png

Limitations

Modifier splitting is naive: the first ; after the value terminates the value. A literal ; cannot appear inside a name=value text payload via this syntax. For text values containing ;, build the Part directly with Part::text and add it via Form::part.

Fields

name: &'a str

Field name (the part to the left of =).

source: FieldSpecSource<'a>

Where the value comes from.

content_type: Option<&'a str>

Optional ;type=… override.

filename: Option<&'a str>

Optional ;filename=… override.

Implementations

impl<'a> FieldSpec<'a>

pub fn parse(spec: &'a str) -> Result<Self, FieldSpecError>

Parse a field spec string. Pure: does no I/O.

pub async fn into_part(self) -> Result<Part, FieldSpecError>

Resolve this spec into a Part, performing any necessary I/O.

Trait Implementations

impl<'a> Clone for FieldSpec<'a>

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

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl<'a> Debug for FieldSpec<'a>

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

Formats the value using the given formatter.