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().

In this implementation, actual TCP I/O is stubbed (see _dispatch). The full interface, state machine, caching, retry, and rate limiting are all implemented and production-ready. Wire in a real TCP backend (tokio, std threads, or platform sockets) by implementing _dispatch.

Fields

cache_ttl: Duration

Default cache TTL.

max_concurrent: usize

Maximum simultaneous connections.

verbose: bool

Whether to log requests to the debug console.

default_headers: HashMap<String, String>

Global headers added to every request.

Implementations

impl HttpClient

pub fn new() -> Self

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.