Struct PoolStats 

pub struct PoolStats {
    pub available: usize,
    pub active: usize,
    pub total: usize,
}

Snapshot of pool statistics at a point in time.

Useful for monitoring, logging, and health checks.

Fields

Field	Description
available	Browsers ready for checkout
active	All tracked browsers (pooled + checked-out)
total	Reserved for future use (currently same as active)

Example

use html2pdf_api::PoolStats;

let stats = PoolStats {
    available: 3,
    active: 5,
    total: 5,
};

println!("Pool status: {}/{} available", stats.available, stats.active);

Usage with BrowserPool

let pool = /* ... */;

// Get current stats
let stats = pool.stats();

// Use for health checks
if stats.available == 0 {
    log::warn!("No browsers available in pool!");
}

// Use for monitoring
metrics::gauge!("browser_pool.available", stats.available as f64);
metrics::gauge!("browser_pool.active", stats.active as f64);

Fields

available: usize

Number of browsers available in pool (ready for checkout).

These browsers are idle and can be immediately returned by BrowserPool::get().

Note

This value can change immediately after reading if another thread checks out or returns a browser.

active: usize

Number of active browsers (all browsers being tracked).

This includes both pooled and checked-out browsers.

Relationship to available

• active >= available (always)
• active - available = browsers currently checked out

total: usize

Total browsers (currently same as active, reserved for future use).

Future Use

This field may be used to track browsers in different states (e.g., browsers being created, browsers being destroyed).

Implementations

impl PoolStats

pub fn checked_out(&self) -> usize

Get the number of browsers currently checked out.

This is a convenience method that calculates active - available.

Example

use html2pdf_api::PoolStats;

let stats = PoolStats {
    available: 3,
    active: 5,
    total: 5,
};

assert_eq!(stats.checked_out(), 2);

pub fn has_available(&self) -> bool

Check if the pool has available browsers.

Example

use html2pdf_api::PoolStats;

let stats = PoolStats {
    available: 3,
    active: 5,
    total: 5,
};

assert!(stats.has_available());

pub fn is_empty(&self) -> bool

Check if the pool is empty (no browsers at all).

Example

use html2pdf_api::PoolStats;

let stats = PoolStats {
    available: 0,
    active: 0,
    total: 0,
};

assert!(stats.is_empty());

Trait Implementations

impl Clone for PoolStats

fn clone(&self) -> PoolStats

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for PoolStats

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

Formats the value using the given formatter.

impl Display for PoolStats

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

Format stats for logging.

Example

use html2pdf_api::PoolStats;

let stats = PoolStats {
    available: 3,
    active: 5,
    total: 5,
};

assert_eq!(
    stats.to_string(),
    "PoolStats { available: 3, active: 5, total: 5 }"
);