Struct HttpClient 

pub struct HttpClient {
    pub cache_ttl: Duration,
    pub max_concurrent: usize,
    pub verbose: bool,
    pub default_headers: HashMap<String, String>,
    /* private fields */
}

Non-blocking HTTP client driven by tick().

send queues a request; tick starts queued requests (up to max_concurrent, honouring rate limits and retry backoff), collects the finished ones, retries connection errors, timeouts and 5xx responses with exponential backoff, and fills the event queue. Successful GET responses are cached and, once stale, revalidated with If-None-Match / If-Modified-Since.

Fields

cache_ttl: Duration

Default cache TTL.

max_concurrent: usize

Maximum simultaneous connections.

verbose: bool

Log each dispatched request through the log crate at debug level.

default_headers: HashMap<String, String>

Global headers added to every request.

Implementations

impl HttpClient

pub fn new() -> Self

A client with a 60 s cache TTL and at most 6 requests in flight.

pub fn send(&mut self, request: HttpRequest) -> RequestId

Submit a request. Returns the RequestId for tracking.

pub fn cancel_by_tag(&mut self, tag: &str)

Cancel all requests with the given tag.

pub fn set_rate_limit(&mut self, base_url: &str, limit: u32, window_secs: f32)

Set a default rate limiter for a base URL.

pub fn set_default_header( &mut self, key: impl Into<String>, val: impl Into<String>, )

Set a default header on all outgoing requests.

pub fn tick(&mut self, _dt: f32)

Drive the client state machine. Call once per frame.

pub fn drain_events(&mut self) -> impl Iterator<Item = HttpEvent> + '_

Drain all completed events.

pub fn pending_count(&self) -> usize

Number of pending + in-flight requests.

pub fn clear_cache(&mut self)

Clear the response cache.

pub fn evict_stale_cache(&mut self)

Remove cache entries older than their TTL.

Trait Implementations

impl Default for HttpClient

fn default() -> Self

Returns the “default value” for a type.