Struct MultipartBuilder 

pub struct MultipartBuilder { /* private fields */ }

Builder for multipart/form-data bodies per RFC 7578.

Example

use oxihttp_core::multipart::MultipartBuilder;

let builder = MultipartBuilder::new()
    .add_text("username", "alice")
    .add_file("avatar", "pic.png", "image/png", b"PNG\r\n".as_ref());

let content_type = builder.content_type();
let body_bytes = builder.build();

Implementations

impl MultipartBuilder

pub fn new() -> Self

Create a new builder with an auto-generated boundary.

pub fn boundary(&self) -> &str

Return the boundary string (without leading --).

pub fn content_type(&self) -> String

Return the full Content-Type header value including the boundary parameter.

Set this as the Content-Type header when sending the body.

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

Add a text field part.

pub fn add_file( self, name: &str, filename: &str, content_type: &str, body: impl Into<Bytes>, ) -> Self

Add a file/binary part.

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

Add a pre-constructed Part.

pub fn build(self) -> Bytes

Serialise to a Bytes buffer containing the complete multipart wire format.

Automatically handles boundary collision: if the boundary string occurs literally inside any part body, a numeric suffix is appended and the check repeats until the boundary is guaranteed unique across all part bodies.

Note: the uniqueness check searches for the bare boundary string (conservative — no false negatives). The actual wire delimiter is --<boundary>, but matching the bare string is safe because any occurrence of the bare string would also produce a collision in the delimiter form.

Trait Implementations

impl Clone for MultipartBuilder

fn clone(&self) -> MultipartBuilder

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for MultipartBuilder

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

Formats the value using the given formatter.

impl Default for MultipartBuilder

fn default() -> Self

Returns the “default value” for a type.