Struct Routes 

#[non_exhaustive]
pub struct Routes { /* private fields */ }

Per-capability provider routing table.

Maps each Capability to an ordered list of Providers to try. A capability with no entry falls back to Yahoo, or to EDGAR then Yahoo for Capability::FILINGS.

Each route may carry its own Fetch mode, so a quota-limited capability can stay sequential while another races its providers. Routes without one use the table default.

Implementations

impl Routes

pub fn new(fetch: Fetch) -> Self

An empty route table (every capability falls back to its default candidate providers) using the given concurrency Fetch mode.

pub fn route( self, cap: Capability, providers: impl IntoIterator<Item = Provider>, ) -> Self

Route one capability to an ordered list of providers.

Without this a hand-built table is empty and every capability falls back to its default, so a registered adapter would never be reached.

pub fn route_with( self, cap: Capability, providers: impl IntoIterator<Item = Provider>, fetch: Fetch, ) -> Self

Route one capability, overriding the table’s Fetch mode for it.

pub fn fetch_mode(&self) -> Fetch

The default concurrency mode for capabilities that do not override it.

pub fn fetch_mode_for(&self, cap: Capability) -> Fetch

The concurrency mode cap resolves to.

pub fn providers_for(&self, cap: Capability) -> Option<&[Provider]>

The providers routed to cap, or None when it falls back to the default.

Trait Implementations

impl Debug for Routes

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

Formats the value using the given formatter.