Skip to main content

FetchLimits

Struct FetchLimits 

Source
pub struct FetchLimits {
    pub max_metadata_bytes: usize,
    pub max_artifact_bytes: u64,
    pub connect_timeout: Duration,
    pub total_timeout: Duration,
}
Expand description

Caller-provided byte and time bounds for one fetch.

Fields§

§max_metadata_bytes: usize

Maximum decoded metadata bytes held in memory.

§max_artifact_bytes: u64

Maximum artifact bytes written to disk. Every fetch is finitely bounded.

§connect_timeout: Duration

Deadline for establishing the connection (advisory for fixtures).

§total_timeout: Duration

Total wall-clock deadline for the fetch.

Implementations§

Source§

impl FetchLimits

Source

pub fn validate(&self) -> Result<(), AcquisitionError>

Validates caller-provided byte and time bounds.

The fields remain public for 0.1.x source compatibility, so every transport validates limits again at its I/O boundary. Invalid direct struct literals are rejected before route, filesystem, or network I/O.

Source

pub fn new( max_metadata_bytes: usize, max_artifact_bytes: u64, connect_timeout: Duration, total_timeout: Duration, ) -> Result<Self, AcquisitionError>

Creates limits with explicit bounds.

Requires non-zero connect_timeout and total_timeout with connect_timeout <= total_timeout. The connect phase is part of the total wall-clock budget, so a connect deadline beyond the total deadline cannot be satisfied truthfully.

Source

pub fn effective( &self, adapter_connect_ceiling: Duration, adapter_total_ceiling: Duration, ) -> (Duration, Duration)

Derives the authoritative effective deadlines for one fetch.

effective connect timeout = min(request connect, adapter connect ceiling)
effective total timeout   = min(request total, adapter total ceiling)

A stricter adapter ceiling is allowed; an adapter may never silently extend a caller deadline. Both metadata and artifact operations use the same derivation, and the effective total deadline covers response headers plus body streaming.

Trait Implementations§

Source§

impl Clone for FetchLimits

Source§

fn clone(&self) -> Self

Returns a duplicate of the value. Read more
1.0.0 (const: unstable) · Source§

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

Performs copy-assignment from source. Read more
Source§

impl Copy for FetchLimits

Source§

impl Debug for FetchLimits

Source§

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

Formats the value using the given formatter. Read more
Source§

impl Default for FetchLimits

Source§

fn default() -> Self

Returns the “default value” for a type. Read more
Source§

impl Eq for FetchLimits

Source§

impl PartialEq for FetchLimits

Source§

fn eq(&self, other: &Self) -> bool

Equality operator ==. Read more
1.0.0 (const: unstable) · Source§

fn ne(&self, other: &Rhs) -> bool

Inequality operator !=. Read more
Source§

impl StructuralPartialEq for FetchLimits

Auto Trait Implementations§

Blanket Implementations§

Source§

impl<T> Any for T
where T: 'static + ?Sized,

Source§

fn type_id(&self) -> TypeId

Gets the TypeId of self. Read more
Source§

impl<T> Borrow<T> for T
where T: ?Sized,

Source§

fn borrow(&self) -> &T

Immutably borrows from an owned value. Read more
Source§

impl<T> BorrowMut<T> for T
where T: ?Sized,

Source§

fn borrow_mut(&mut self) -> &mut T

Mutably borrows from an owned value. Read more
Source§

impl<T> CloneToUninit for T
where T: Clone,

Source§

unsafe fn clone_to_uninit(&self, dest: *mut u8)

🔬This is a nightly-only experimental API. (clone_to_uninit)
Performs copy-assignment from self to dest. Read more
Source§

impl<T> From<T> for T

Source§

fn from(t: T) -> T

Returns the argument unchanged.

Source§

impl<T, U> Into<U> for T
where U: From<T>,

Source§

fn into(self) -> U

Calls U::from(self).

That is, this conversion is whatever the implementation of From<T> for U chooses to do.

Source§

impl<T> ToOwned for T
where T: Clone,

Source§

type Owned = T

The resulting type after obtaining ownership.
Source§

fn to_owned(&self) -> T

Creates owned data from borrowed data, usually by cloning. Read more
Source§

fn clone_into(&self, target: &mut T)

Uses borrowed data to replace owned data, usually by cloning. Read more
Source§

impl<T, U> TryFrom<U> for T
where U: Into<T>,

Source§

type Error = !

The type returned in the event of a conversion error.
Source§

fn try_from(value: U) -> Result<T, !>

Performs the conversion.
Source§

impl<T, U> TryInto<U> for T
where U: TryFrom<T>,

Source§

type Error = <U as TryFrom<T>>::Error

The type returned in the event of a conversion error.
Source§

fn try_into(self) -> Result<U, <U as TryFrom<T>>::Error>

Performs the conversion.