unbreak 0.5.0

Make your Python functions unbreakable — adaptive retries, predictive circuit breaker, fallback chains, and dead letter queues

unbreak

Smart retry library with adaptive backoff, circuit breaker, fallback chains, and dead letter queues.

Install

pip install unbreak

Quick Start

import unbreak

@unbreak.retry(max=5, backoff="exponential")
def call_api():
    ...

# With circuit breaker
@unbreak.retry(max=5, circuit=True)
def call_api():
    ...

# Time budget mode
@unbreak.retry(budget="30s")
def call_api():
    ...

# Fallback chain
@unbreak.retry(max=3, fallback=[redis_get, db_query, lambda: "default"])
def call_api():
    ...

Features

• Backoff strategies: fixed, exponential, adaptive (learns from response times)
• Circuit breaker: sliding window, predictive degradation detection
• Smart error detection: HTTP, DB, network, custom
• Time budget mode: retries within a time window
• Fallback chains: cascading fallbacks
• Dead letter queue: in-memory, file (JSONL), custom backends
• Coordinated jitter: distributed thundering herd prevention
• Observability: structured event callbacks
• Retry history: per-call timeline tracking
• Async support: full asyncio support
• Zero dependencies: stdlib only

License

MIT

---

Part of the thecliffhanger open source suite.