Struct Form 

pub struct Form { /* private fields */ }

A multipart form containing multiple parts.

Use the builder pattern to construct a form with multiple parts, then convert it to a body with into_body().

Implementations

impl Form

pub fn new() -> Self

Create a new empty form with a random boundary.

pub fn with_boundary(boundary: impl Into<String>) -> Self

Create a new form with a custom boundary.

The boundary should be a unique string that doesn’t appear in any part data.

pub fn part(self, part: Part) -> Self

Add a part to the form.

pub fn text(self, name: impl Into<String>, value: impl Into<String>) -> Self

Add a text field to the form.

pub fn file( self, name: impl Into<String>, filename: impl Into<String>, data: impl Into<Bytes>, ) -> Self

Add a file to the form.

pub fn boundary(&self) -> &str

Get the boundary string.

pub fn parts(&self) -> &[Part]

Get the parts in this form.

pub fn content_type(&self) -> String

Get the Content-Type header value for this form.

Returns multipart/form-data; boundary=<boundary>.

pub fn into_body(self) -> (String, Bytes)

Convert the form into a body.

Returns a tuple of (content-type header value, body bytes).

Trait Implementations

impl Clone for Form

fn clone(&self) -> Form

Returns a duplicate of the value.

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

Performs copy-assignment from source.

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.