Struct ProxyConfiguration 

pub struct ProxyConfiguration { /* private fields */ }

Static, custom, or per-domain tiered proxy selection.

use millipede_core::proxy::ProxyConfiguration;
let config = ProxyConfiguration::round_robin([url::Url::parse("http://proxy.example")?]);
assert!(format!("{config:?}").contains("Static"));

Implementations

impl ProxyConfiguration

pub fn round_robin(urls: impl IntoIterator<Item = Url>) -> Self

Creates a round-robin static list.

pub fn rotating( urls: impl IntoIterator<Item = Url>, rotation: RotationStrategy, ) -> Self

Creates a static list using rotation.

pub fn custom<R: ProxyResolver>(resolver: R) -> Self

Creates a configuration backed by a custom resolver.

pub fn tiered(tiers: Vec<Vec<Option<Url>>>) -> Self

Creates tiered rotation with a probe every 20 requests.

pub fn tiered_with_probe_interval( tiers: Vec<Vec<Option<Url>>>, probe_interval: u32, ) -> Self

Creates tiered rotation with the requested probe interval.

pub async fn new_url( &self, ctx: ProxyResolveContext<'_>, ) -> Result<Option<Url>, CrawlError>

Selects the next proxy URL, or None for a direct request.

pub async fn new_proxy_info( &self, ctx: ProxyResolveContext<'_>, ) -> Result<Option<ProxyInfo>, CrawlError>

Selects and parses the next proxy, retaining tier and session metadata.

pub fn report_blocked(&self, target: &Url)

Reports that target was blocked, escalating its domain unless a recovery probe failed.

pub fn report_success(&self, target: &Url)

Reports success for target, accepting a pending lower-tier recovery probe.

Trait Implementations

impl Debug for ProxyConfiguration

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

Formats the value using the given formatter.