Struct HttpRetryOptions 

pub struct HttpRetryOptions {
    pub enabled: bool,
    pub max_attempts: u32,
    pub max_duration: Option<Duration>,
    pub delay_strategy: RetryDelay,
    pub jitter_factor: f64,
    pub method_policy: HttpRetryMethodPolicy,
    pub retry_status_codes: Option<Vec<StatusCode>>,
    pub retry_error_kinds: Option<Vec<HttpErrorKind>>,
}

Retry settings for crate::HttpClient.

Fields

enabled: bool

Whether built-in retry is enabled.

max_attempts: u32

Maximum number of attempts, including the first request.

max_duration: Option<Duration>

Optional maximum total retry duration.

delay_strategy: RetryDelay

Delay strategy between attempts.

jitter_factor: f64

Jitter factor passed to the retry delay strategy.

method_policy: HttpRetryMethodPolicy

Method replay policy.

retry_status_codes: Option<Vec<StatusCode>>

Optional retryable status-code allowlist.

When set, only listed statuses are retryable for status errors.

retry_error_kinds: Option<Vec<HttpErrorKind>>

Optional retryable error-kind allowlist for non-status failures.

When set, only listed kinds are retryable for non-status errors.

Implementations

impl HttpRetryOptions

pub fn new() -> Self

Creates default retry options.

Returns

Fresh retry options with built-in retry disabled.

pub fn from_config<R>(config: &R) -> Result<Self, HttpConfigError>

where R: ConfigReader + ?Sized,

Creates HttpRetryOptions from config using relative keys.

Parameters

• config: Any ConfigReader scoped to the retry section.

Returns

Parsed retry options or HttpConfigError.

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

Runs retry option validation.

Returns

Ok(()) when values are usable, otherwise HttpConfigError.

pub fn allows_method(&self, method: &Method) -> bool

Returns whether method is eligible for built-in retry.

Parameters

• method: HTTP method to evaluate.

Returns

true if retry is enabled and the method policy allows replay.

pub fn should_retry(&self, request: &HttpRequest) -> bool

Returns whether retry should run for request under this policy.

Parameters

• request: Request whose method is checked against retry policy.

Returns

true when retry is enabled, max_attempts is greater than one, and the request method is allowed by Self::method_policy.

pub fn resolve(&self, request: &HttpRequest) -> Self

Resolves request-level retry override against this retry policy.

Parameters

• request: Request whose retry override is applied.

Returns

Effective retry options for this request.

pub fn is_retryable_status(&self, status: StatusCode) -> bool

Returns whether a status code is retryable under current retry policy.

Parameters

• status: HTTP status code from the failure response.

Returns

true if status should be retried.

pub fn is_retryable_error_kind(&self, kind: HttpErrorKind) -> bool

Returns whether a non-status error kind is retryable under current retry policy.

Parameters

• kind: Error kind to evaluate.

Returns

true if kind should be retried.

Trait Implementations

impl Clone for HttpRetryOptions

fn clone(&self) -> HttpRetryOptions

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for HttpRetryOptions

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

Formats the value using the given formatter.

impl Default for HttpRetryOptions

fn default() -> Self

Returns the “default value” for a type.

impl PartialEq for HttpRetryOptions

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

Tests for self and other values to be equal, and is used by ==.

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

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl StructuralPartialEq for HttpRetryOptions