Struct HttpClientConfig 

pub struct HttpClientConfig {
    pub implementation: HttpImpl,
    pub driver: Config,
    pub pool: usize,
    pub request_timeout_ms: u32,
    pub buf_size: usize,
    pub background_connect: bool,
    pub curl_drive: CurlDrive,
    pub curl_ca_file: Option<String>,
    pub curl_allow_non_idempotent_methods: bool,
    pub connect_gate: bool,
    pub reconnect_seed: u64,
}

HttpClient settings.

Fields

implementation: HttpImpl

The implementation.

driver: Config

Native: the loop backend for the pool’s driver. Both implementations take TCP keepalive, TCP_USER_TIMEOUT and the quick-ACK route check’s policy from it (driver.quickack_check, see crate::route): libcurl’s connections are checked from its pre-request callback (libcurl 7.80 or later).

pool: usize

Connections kept warm (native) or the most libcurl may use at once.

request_timeout_ms: u32

Time from sending a request to its complete response, in milliseconds.

buf_size: usize

Native: receive buffer per connection (must hold the largest response).

background_connect: bool

Native: open connections on the driver’s helper thread (Driver::connect_background), keeping handshake CPU off the loop. In a process that may use the polling CPU only (a pod with one CPU, crate::placement) HttpClient::new then fails with Error::Cpu, unless driver.inline_connect_fallback is set: the pool then opens connections on the loop, as with false.

curl_drive: CurlDrive

Curl: how libcurl is driven.

curl_ca_file: Option<String>

Curl: a CA bundle file instead of the system store. (Native trust comes from the rustls configuration passed to HttpClient::new.)

curl_allow_non_idempotent_methods: bool

Curl: accept POST, PUT, PATCH and every method other than GET, HEAD, OPTIONS and DELETE. Off by default: libcurl sends a request again, up to 5 times, when the reused connection it went out on dies before any reply byte, so an order could run twice. Off, such a request fails with Error::CurlResend. Send orders through the native client, which never re-sends.

connect_gate: bool

Native: every pool connect waits for ClientHandler::connect_gate, the first ones included, so new opens nothing and HttpClient::poll refuses (Error::Config). For a venue that limits connects per IP. Give the pool a budget bucket of its own: venues’ connect limits count WebSocket connects, not HTTP ones. Off (default): new opens every connection at once.

reconnect_seed: u64

Native: the seed of the reconnect delays’ jitter; 0 picks one at random. A fixed seed gives the same delays every run (tests).

Implementations

impl HttpClientConfig

pub const fn new(implementation: HttpImpl) -> Self

Defaults: native, recv-busy, a pool of 2, background connects.

Trait Implementations

impl Clone for HttpClientConfig

fn clone(&self) -> Self

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.