import random class ExponentialBackoff: """ General exponential backoff calculation utility. """ def __init__(self, base_delay: float, max_delay: float, factor: float = 2.0, jitter_range: tuple = (10.0, 45.0)): """ :param base_delay: Base delay in seconds :param max_delay: Maximum delay in seconds :param factor: Exponential multiplier (default 2.0 for doubling) :param jitter_range: Random jitter range (min seconds, max seconds) """ self.base_delay = base_delay self.max_delay = max_delay self.factor = factor self.jitter_range = jitter_range def calculate(self, failure_count: int) -> float: """ Calculates cooldown delay based on consecutive failure count. :param failure_count: Consecutive failure count (1-based) """ if failure_count <= 0: return 0.0 # Core formula: base_delay * (factor ^ (failure_count - 1)) multiplier = self.factor ** (failure_count - 1) delay = self.base_delay * multiplier # Clamp to max_delay delay = min(delay, self.max_delay) # Add random jitter if self.jitter_range: delay += random.uniform(self.jitter_range[0], self.jitter_range[1]) return delay