Struct ProxyPool 

pub struct ProxyPool { /* private fields */ }

A rotatable pool of upstream proxy URLs.

Implementations

impl ProxyPool

pub fn new( urls: impl IntoIterator<Item = String>, strategy: RotationStrategy, ) -> Self

Build a pool from upstream proxy URLs (untagged). Duplicate and empty URLs are dropped.

The initially selected endpoint is the first one for RotationStrategy::RoundRobin, or a random one for RotationStrategy::Random.

pub fn with_endpoints( endpoints: impl IntoIterator<Item = (String, Option<CountryCode>)>, strategy: RotationStrategy, ) -> Self

Build a pool from (url, country) pairs, where country tags the proxy’s exit country for proxy-led locale derivation. Duplicate/empty URLs dropped.

pub fn len(&self) -> usize

Total number of endpoints in the pool (healthy or not).

pub fn is_empty(&self) -> bool

Returns true when the pool holds no endpoints.

pub fn healthy_count(&self) -> usize

Number of endpoints currently marked healthy.

pub fn selected(&self) -> Option<&str>

The currently selected upstream proxy URL, if any.

pub fn selected_country(&self) -> Option<CountryCode>

The tagged exit country of the currently selected proxy, if any.

pub fn rotate(&mut self) -> Option<String>

Retire the current endpoint and select the next healthy one.

Marks the current endpoint unhealthy (so rotation never returns to a known-blocked proxy), then selects the next healthy endpoint per the RotationStrategy. Returns the newly selected URL, or None when no healthy endpoints remain.

Trait Implementations

impl Clone for ProxyPool

fn clone(&self) -> ProxyPool

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for ProxyPool

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

Formats the value using the given formatter.