Struct Form

pub struct Form { /* private fields */ }

A multipart/form-data request.

Implementations

impl Form

pub fn new() -> Form

Creates a new Form without any content.

pub fn boundary(&self) -> &str

Get the boundary that this form will use.

pub fn text<T, U>(self, name: T, value: U) -> Form

where T: Into<Cow<'static, str>>, U: Into<Cow<'static, str>>,

Add a data field with supplied name and value.

Examples

let form = reqwest::blocking::multipart::Form::new()
    .text("username", "seanmonstar")
    .text("password", "secret");

pub fn file<T, U>(self, name: T, path: U) -> Result<Form>

where T: Into<Cow<'static, str>>, U: AsRef<Path>,

Adds a file field.

The path will be used to try to guess the filename and mime.

Examples

let form = reqwest::blocking::multipart::Form::new()
    .file("key", "/path/to/file")?;

Errors

Errors when the file cannot be opened.

pub fn part<T>(self, name: T, part: Part) -> Form

where T: Into<Cow<'static, str>>,

Adds a customized Part.

pub fn percent_encode_path_segment(self) -> Form

Configure this Form to percent-encode using the path-segment rules.

pub fn percent_encode_attr_chars(self) -> Form

Configure this Form to percent-encode using the attr-char rules.

pub fn percent_encode_noop(self) -> Form

Configure this Form to skip percent-encoding

pub fn into_reader(self) -> impl Read

Produce a reader over the multipart form data.

Trait Implementations

impl Debug for Form

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

Formats the value using the given formatter.

impl Default for Form

fn default() -> Self

Returns the “default value” for a type.