Struct Part

pub struct Part { /* private fields */ }

For creating a section of a MultipartForm.

Use Part::text() and Part::bytes() for creating new instances. Then attach them to a MultipartForm using MultipartForm::add_part().

Implementations

impl Part

pub fn text<T>(text: T) -> Self

where T: Display,

Creates a new part of a multipart form, that will send text.

The default mime type for this part will be text/plain,

pub fn bytes<B>(bytes: B) -> Self

where B: Into<Bytes>,

Creates a new part of a multipart form, that will upload bytes.

The default mime type for this part will be application/octet-stream,

pub fn file_name<T>(self, file_name: T) -> Self

where T: Display,

Sets the file name for this part of a multipart form.

By default there is no filename. This will set one.

pub fn mime_type<M>(self, mime_type: M) -> Self

where M: AsRef<str>,

Sets the mime type for this part of a multipart form.

The default mime type is text/plain or application/octet-stream, depending on how this instance was created. This function will replace that.

pub fn add_header<N, V>(self, name: N, value: V) -> Self

where N: TryInto<HeaderName>, N::Error: Debug, V: TryInto<HeaderValue>, V::Error: Debug,

Adds a header to be sent with the Part of this Multiform.

use axum::Router;
use axum_test::TestServer;
use axum_test::multipart::MultipartForm;
use axum_test::multipart::Part;

let app = Router::new();
let server = TestServer::new(app)?;

let readme_bytes = include_bytes!("../../README.md");
let readme_part = Part::bytes(readme_bytes.as_slice())
    .file_name(&"README.md")
    // Add a header to the Part
    .add_header("x-text-category", "readme");

let multipart_form = MultipartForm::new()
    .add_part("file", readme_part);

let response = server.post(&"/my-form")
    .multipart(multipart_form)
    .await;

Trait Implementations

impl Clone for Part

fn clone(&self) -> Part

Returns a copy of the value.

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

Performs copy-assignment from source.

impl Debug for Part

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

Formats the value using the given formatter.