pub struct ComposedTransport<'a> { /* private fields */ }Expand description
Explicit caller-selected preferred/fallback composition over two transports.
The composition itself implements AcquisitionTransport so callers keep
a single seam. Preferred order is the construction order: primary is
attempted first, secondary only when the policy allows fallback for the
primary outcome.
Fallback is decided from typed outcomes, never by parsing human-readable errors.
Implementations§
Source§impl<'a> ComposedTransport<'a>
impl<'a> ComposedTransport<'a>
Sourcepub fn new(
primary: &'a dyn AcquisitionTransport,
secondary: &'a dyn AcquisitionTransport,
policy: CompositionPolicy,
) -> Self
pub fn new( primary: &'a dyn AcquisitionTransport, secondary: &'a dyn AcquisitionTransport, policy: CompositionPolicy, ) -> Self
Creates a composed transport with an explicit fallback policy.
No network, filesystem, or process work occurs here; policy and ordering are the only decisions recorded.
Sourcepub fn policy(&self) -> CompositionPolicy
pub fn policy(&self) -> CompositionPolicy
Returns the fallback policy.
Trait Implementations§
Source§impl AcquisitionTransport for ComposedTransport<'_>
impl AcquisitionTransport for ComposedTransport<'_>
Source§fn fetch_metadata(
&self,
request: &AcquisitionRequest,
limits: FetchLimits,
cancel: &CancelFlag,
) -> Result<FetchOutcome<MetadataBytes>, AcquisitionError>
fn fetch_metadata( &self, request: &AcquisitionRequest, limits: FetchLimits, cancel: &CancelFlag, ) -> Result<FetchOutcome<MetadataBytes>, AcquisitionError>
Fetches a bounded small body (release metadata, checksums) into memory.
Source§fn fetch_artifact(
&self,
request: &AcquisitionRequest,
dest: &Path,
limits: FetchLimits,
cancel: &CancelFlag,
) -> Result<FetchOutcome<ArtifactEvidence>, AcquisitionError>
fn fetch_artifact( &self, request: &AcquisitionRequest, dest: &Path, limits: FetchLimits, cancel: &CancelFlag, ) -> Result<FetchOutcome<ArtifactEvidence>, AcquisitionError>
Streams an artifact body to
dest without requiring full buffering. Read moreAuto Trait Implementations§
impl<'a> !RefUnwindSafe for ComposedTransport<'a>
impl<'a> !Send for ComposedTransport<'a>
impl<'a> !Sync for ComposedTransport<'a>
impl<'a> !UnwindSafe for ComposedTransport<'a>
impl<'a> Freeze for ComposedTransport<'a>
impl<'a> Unpin for ComposedTransport<'a>
impl<'a> UnsafeUnpin for ComposedTransport<'a>
Blanket Implementations§
Source§impl<T> BorrowMut<T> for Twhere
T: ?Sized,
impl<T> BorrowMut<T> for Twhere
T: ?Sized,
Source§fn borrow_mut(&mut self) -> &mut T
fn borrow_mut(&mut self) -> &mut T
Mutably borrows from an owned value. Read more