Struct RotationPolicy 

pub struct RotationPolicy {
    pub requests_per_proxy: Option<NonZeroU64>,
    pub max_age: Option<Duration>,
    pub strategy: SelectionStrategy,
}

Limits controlling how long the pool retains its current proxy.

Each successful acquisition consumes one request allowance, including an acquisition whose eventual network request fails. When either enabled limit is reached, the next acquisition selects a replacement. Time limits are checked during acquisition; they do not schedule background work.

With both limits disabled, the current proxy is retained until it becomes unavailable or a caller requests a manual rotation. A replacement avoids the current proxy whenever another eligible proxy exists.

Fields

requests_per_proxy: Option<NonZeroU64>

Maximum acquisitions per proxy selection; None disables this limit.

max_age: Option<Duration>

Maximum elapsed time per selection; None disables this limit.

strategy: SelectionStrategy

Method used to choose the next eligible proxy.

Implementations

impl RotationPolicy

pub fn every(requests: NonZeroU64) -> Self

Keep each selection for this many acquisitions before rotating.

pub fn sticky() -> Self

Keep a proxy until it becomes unavailable or rotation is requested.

pub fn for_duration(duration: Duration) -> Result<Self>

Keep each selection for a positive duration, regardless of request count. The time limit is checked on acquisition; no background timer is needed.

pub fn validate(&self) -> Result<()>

Rejects a zero time limit; use a request limit of one to rotate every time.

Trait Implementations

impl Clone for RotationPolicy

fn clone(&self) -> RotationPolicy

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for RotationPolicy

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

Formats the value using the given formatter.

impl Default for RotationPolicy

fn default() -> Self

Returns the “default value” for a type.

impl Eq for RotationPolicy

impl PartialEq for RotationPolicy

fn eq(&self, other: &RotationPolicy) -> bool

Equality operator ==.

fn ne(&self, other: &Rhs) -> bool

Inequality operator !=.

impl StructuralPartialEq for RotationPolicy