Struct CloudflareIpCache 

pub struct CloudflareIpCache { /* private fields */ }

In-memory cache of Cloudflare edge CIDR ranges with a fast contains check.

Implementations

impl CloudflareIpCache

pub fn new_with_fallback() -> Arc<Self>

Build a cache populated from the hardcoded fallback list. No network.

pub async fn fetch_from_upstream() -> Arc<Self>

GET the two upstream CF URLs, parse CIDRs, and return a new cache.

Falls back to the baked-in list on any error (network failure, DNS, timeout, non-200 status, parse error for both lists). If one of the two fetches succeeds and the other fails, the successful half is merged with the fallback for the failing half.

pub fn spawn_auto_refresh(interval: Duration) -> Arc<Self>

Spawn a tokio task that refreshes the cache immediately, then every interval. The returned Arc is shared with the refresh task, which lives for the duration of the process.

pub fn contains(&self, ip: IpAddr) -> bool

Returns true if ip is within any cached CF range.

pub fn replace(&self, new_ranges: Vec<IpNet>)

Replace the cached ranges atomically. Primarily used by the refresh task.

pub fn ranges(&self) -> Vec<IpNet>

Snapshot of the current cached ranges (clones).

Trait Implementations

impl Debug for CloudflareIpCache

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

Formats the value using the given formatter.