Struct HttpClientConfig 

#[non_exhaustive]
pub struct HttpClientConfig {
    pub base_url: Option<String>,
    pub timeout: Duration,
    pub connect_timeout: Duration,
    pub user_agent: Option<String>,
    pub default_headers: HashMap<String, String>,
    pub auth: Option<Auth>,
    pub follow_redirects: bool,
    pub max_redirects: usize,
    pub max_response_body_bytes: usize,
    pub destination_policy: DestinationPolicy,
    pub resilience_policy: Option<Policy>,
    pub tls: Option<TlsConfig>,
}

Configuration for the HTTP client.

Fields (Non-exhaustive)

Non-exhaustive structs could have additional fields added in future. Therefore, non-exhaustive structs cannot be constructed in external crates using the traditional Struct { .. } syntax; cannot be matched against without a wildcard ..; and struct update syntax will not work.

base_url: Option<String>

Base URL for requests (e.g., https://api.example.com/v1). Paths are appended to this URL.

timeout: Duration

Request timeout. Defaults to 30 seconds.

connect_timeout: Duration

Connection timeout. Defaults to 10 seconds.

user_agent: Option<String>

User-Agent header value. If None, no User-Agent header is set.

default_headers: HashMap<String, String>

Default headers applied to all requests.

auth: Option<Auth>

Default authentication applied to all requests.

follow_redirects: bool

Follow redirects. Defaults to true.

max_redirects: usize

Maximum number of redirects to follow. Defaults to 5.

max_response_body_bytes: usize

Maximum response body size accepted by HttpClient.

destination_policy: DestinationPolicy

Destination policy for initial request URLs and redirect targets.

resilience_policy: Option<Policy>

Optional resilience policy applied to transport execution.

tls: Option<TlsConfig>

Explicit TLS certificate, trust, and verification configuration.

Implementations

impl HttpClientConfig

pub fn new() -> Self

Creates a new HTTP client config with defaults.

pub fn with_base_url(self, url: impl Into<String>) -> Self

Sets the base URL.

pub fn with_timeout(self, timeout: Duration) -> Self

Sets the timeout.

pub fn with_connect_timeout(self, timeout: Duration) -> Self

Sets the connection timeout.

pub fn with_user_agent(self, ua: impl Into<String>) -> Self

Sets the User-Agent header.

pub fn with_header( self, name: impl Into<String>, value: impl Into<String>, ) -> Self

Adds a default header.

pub fn with_headers(self, headers: HashMap<String, String>) -> Self

Sets default headers.

pub fn with_auth(self, auth: Auth) -> Self

Sets default authentication.

pub fn with_follow_redirects(self, follow: bool) -> Self

Sets whether to follow redirects.

pub fn with_max_redirects(self, max: usize) -> Self

Sets the maximum number of redirects to follow.

pub fn with_max_response_body_bytes(self, max: usize) -> Self

Sets the maximum accepted response body size.

pub fn with_destination_policy(self, policy: DestinationPolicy) -> Self

Sets the destination validation policy.

pub fn with_resilience_policy(self, policy: Policy) -> Self

Sets the transport resilience policy.

pub fn with_tls(self, tls: TlsConfig) -> Self

Sets explicit TLS certificate, trust, and verification configuration.

Trait Implementations

impl Clone for HttpClientConfig

fn clone(&self) -> HttpClientConfig

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for HttpClientConfig

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

Formats the value using the given formatter.

impl Default for HttpClientConfig

fn default() -> Self

Returns the “default value” for a type.