Struct reqwest::multipart::Form

pub struct Form { /* fields omitted */ }

A multipart/form-data request.

Methods

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::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 files = reqwest::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

Trait Implementations

impl Debug for Form

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

Formats the value using the given formatter.