Struct MultiSource

pub struct MultiSource { /* private fields */ }

A Source that works by querying multiple Sources in succession.

Error Handling

A Source implementation can return certain non-fatal errors and, depending on the MultiSourceStrategy, the MultiSource can choose to deal with it in different ways. Sometimes

The first Source to return one or more Summaries will be treated as the canonical source for that Dependency and no further Sources will be queried.

Implementations

impl MultiSource

pub fn new() -> Self

pub fn add_source(&mut self, source: impl Source + Send + 'static) -> &mut Self

pub fn add_shared_source( &mut self, source: Arc<dyn Source + Send + Sync>, ) -> &mut Self

pub fn with_strategy(self, strategy: MultiSourceStrategy) -> Self

Override the strategy used when a Source returns a non-fatal error.

Trait Implementations

impl Clone for MultiSource

fn clone(&self) -> MultiSource

Returns a copy of the value.

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

Performs copy-assignment from source.

impl Debug for MultiSource

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

Formats the value using the given formatter.

impl Default for MultiSource

fn default() -> Self

Returns the “default value” for a type.

impl Source for MultiSource

fn query<'life0, 'life1, 'async_trait>( &'life0 self, package: &'life1 PackageSource, ) -> Pin<Box<dyn Future<Output = Result<Vec<PackageSummary>, QueryError>> + Send + 'async_trait>>

where Self: 'async_trait, 'life0: 'async_trait, 'life1: 'async_trait,

Ask this source which packages would satisfy a particular Dependency constraint.

fn latest<'life0, 'life1, 'async_trait>( &'life0 self, pkg: &'life1 PackageSource, ) -> Pin<Box<dyn Future<Output = Result<PackageSummary, QueryError>> + Send + 'async_trait>>

where Self: 'async_trait, 'life0: 'async_trait, 'life1: 'async_trait,

Run Source::query() and get the PackageSummary for the latest version.