Struct HostPool 

pub struct HostPool { /* private fields */ }

Manages a pool of Host instances and routes requests to appropriate hosts.

The HostPool serves as the central coordinator for per-host rate limiting. It creates host instances on-demand and provides a unified interface for executing HTTP requests with appropriate rate limiting applied.

Architecture

• Each unique hostname gets its own Host instance with dedicated rate limiting
• Hosts are created lazily when first requested
• Thread-safe using DashMap for concurrent access to host instances

Implementations

impl HostPool

pub fn new( global_config: RateLimitConfig, host_configs: HostConfigs, default_client: Client, client_map: ClientMap, ) -> Self

Create a new HostPool with the given configuration

pub fn build_request(&self, method: Method, uri: &Uri) -> Result<Request>

Try to build a Request

Errors

Fails if:

• The request URI has no valid hostname
• The request fails to build

pub fn host_stats(&self, hostname: &str) -> HostStats

Returns statistics for the host if it exists, otherwise returns empty stats. This provides consistent behavior whether or not requests have been made to that host yet.

pub fn all_host_stats(&self) -> HostStatsMap

Returns a HashMap mapping hostnames to their statistics. Only hosts that have had requests will be included.

pub fn active_host_count(&self) -> usize

Get the number of host instances that have been created, which corresponds to the number of unique hostnames that have been accessed.

pub fn host_configurations(&self) -> HostConfigs

Get a copy of the current host-specific configurations. This is useful for debugging or runtime monitoring of configuration.

pub fn remove_host(&self, hostname: &str) -> bool

Remove a host from the pool.

This forces the host to be recreated with updated configuration the next time a request is made to it. Any ongoing requests to that host will continue with the old instance.

Returns

Returns true if a host was removed, false if no host existed for that hostname.

pub fn cache_stats(&self) -> HashMap<String, (usize, f64)>

Get cache statistics across all hosts

pub fn record_persistent_cache_hit(&self, uri: &Uri)

Record a cache hit for the given URI in host statistics. This tracks that a request was served from the persistent disk cache. Note that no equivalent function for tracking cache misses is exposed, since this is handled internally.

Trait Implementations

impl Debug for HostPool

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

Formats the value using the given formatter.

impl Default for HostPool

fn default() -> Self

Returns the “default value” for a type.