| 1234567891011121314151617181920212223242526272829303132333435363738 |
- 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
|