Struct ManagedMultipartBuilder 

pub struct ManagedMultipartBuilder { /* private fields */ }

Configures a bounded, retrying multipart upload from a local file.

Implementations

impl ManagedMultipartBuilder

pub fn upload_options(self, options: ObjectUploadOptions) -> Self

Sets typed metadata for a newly created multipart object.

Metadata cannot be changed while resuming an existing remote session.

pub fn content_type(self, value: Mime) -> Self

Sets the completed object’s MIME media type.

pub fn cache_control(self, value: CacheControl) -> Self

Sets the completed object’s typed HTTP cache policy.

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

Sets the completed object’s content disposition.

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

Sets the completed object’s content encoding.

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

Sets the completed object’s content language.

pub fn expires(self, value: SystemTime) -> Self

Sets the completed object’s HTTP expiration time.

pub fn custom_metadata( self, key: impl Into<String>, value: impl Into<String>, ) -> Self

Adds user-defined metadata to the completed object.

pub const fn part_size(self, bytes: u64) -> Self

Sets the uniform non-final part size. Resumed sessions must keep their original size.

pub const fn part_size_mib(self, mebibytes: u64) -> Self

Sets the multipart part size in mebibytes (MiB).

This is equivalent to Self::part_size with a binary-unit conversion and avoids repeating 1024 * 1024 at call sites. Unrepresentable or out-of-range values are rejected before file or network I/O.

pub const fn concurrency(self, value: usize) -> Self

Sets the maximum number of in-flight parts, from 1 through 64.

pub const fn max_attempts(self, value: u8) -> Self

Sets total attempts per part, including the first request, from 1 through 10.

pub const fn max_buffered_bytes(self, value: u64) -> Self

Sets the maximum memory used by in-flight part buffers.

Validation uses the conservative upper bound part_size * concurrency and runs before opening the source file or contacting R2. The default is 256 MiB.

pub const fn max_buffered_mib(self, mebibytes: u64) -> Self

Sets the maximum memory used by in-flight part buffers in MiB.

pub const fn abort_on_error(self, value: bool) -> Self

Chooses whether an error triggers a best-effort remote abort. The default is true.

pub fn on_progress( self, callback: impl Fn(ManagedUploadProgress) + Send + Sync + 'static, ) -> Self

Registers a fast, non-blocking callback invoked after progress changes.

pub fn cancellation_token(self, cancellation: ManagedUploadCancellation) -> Self

Registers an explicit cooperative cancellation signal.

With the default abort_on_error(true), cancellation waits for a best-effort remote abort before returning Error::Cancelled. If abort fails, the returned error carries a snapshot for later cleanup or resume.

pub async fn upload_file( self, path: impl AsRef<Path>, ) -> Result<ManagedUploadResult, ManagedUploadError>

Uploads the local file, reusing validated remote parts when resuming.

Trait Implementations

impl Clone for ManagedMultipartBuilder

fn clone(&self) -> ManagedMultipartBuilder

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for ManagedMultipartBuilder

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

Formats the value using the given formatter.