Struct TransferConfig 

pub struct TransferConfig {
    pub concurrency: NonZeroUsize,
    pub max_bytes_per_sec: Option<u64>,
    pub adaptive: AdaptivePolicy,
}

Configuration for object transfers: how many to run in parallel, an optional aggregate byte-rate cap, and whether to tune those adaptively.

Default auto-detects the available parallelism (capped at [DEFAULT_CONCURRENCY_CAP]), leaves bandwidth unlimited, and disables adaptive tuning (AdaptivePolicy::Off).

Fields

concurrency: NonZeroUsize

Maximum number of object transfers to run concurrently. In the adaptive (On) path this is the slow-start seed; the effective in-flight window is sized to the policy ceiling and gated to the live limit.

max_bytes_per_sec: Option<u64>

Optional aggregate bandwidth cap, in bytes per second. None means unlimited. In the adaptive path this is the rate cap (max_rate); the controller may target a lower live rate.

adaptive: AdaptivePolicy

Whether to tune concurrency / rate adaptively. AdaptivePolicy::Off (the default) keeps the historical fixed-concurrency path byte-for-byte.

Implementations

impl TransferConfig

pub fn new(concurrency: usize, max_bytes_per_sec: Option<u64>) -> Self

Builds a non-adaptive config, clamping concurrency to at least 1.

The adaptive policy defaults to AdaptivePolicy::Off, so existing callers behave exactly as before. Use with_adaptive to opt in.

pub fn with_adaptive(self, policy: AdaptivePolicy) -> Self

Returns this config with its adaptive policy set to policy (builder style). Off is byte-identical to a plain new config.

Trait Implementations

impl Clone for TransferConfig

fn clone(&self) -> TransferConfig

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for TransferConfig

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

Formats the value using the given formatter.

impl Default for TransferConfig

fn default() -> Self

Returns the “default value” for a type.