pyresilience 0.1.2

Unified resilience patterns for Python — retry, circuit breaker, timeout, fallback, bulkhead, rate limiter, and cache in one decorator.

pyresilience

All resilience patterns. One decorator. Zero dependencies.

Stop juggling tenacity for retries, pybreaker for circuit breakers, and custom code for everything else. pyresilience gives you retry, circuit breaker, timeout, fallback, bulkhead, rate limiter, and cache — all through a single @resilient() decorator that works with sync and async.

---

Install

pip install pyresilience

Also works with uv, poetry, and pdm.

Quick Start

import requests
from pyresilience import resilient, RetryConfig, TimeoutConfig, CircuitBreakerConfig

@resilient(
    retry=RetryConfig(max_attempts=3, delay=1.0),
    timeout=TimeoutConfig(seconds=10),
    circuit_breaker=CircuitBreakerConfig(failure_threshold=5),
)
def call_api(endpoint: str) -> dict:
    return requests.get(endpoint).json()

Retries with exponential backoff. Times out at 10s. Opens the circuit after 5 failures. That's it.

Why pyresilience?

• One library instead of many — No need to wire together tenacity + pybreaker + custom timeout/fallback/rate limiting code. One config, one decorator.
• Patterns that work together — Circuit breaker state is shared across retries. Rate limiting respects bulkhead limits. Cache short-circuits the entire pipeline. Everything is coordinated.
• Zero dependencies — Pure Python. Nothing to conflict with your stack.
• Sync and async — Same API for both. No separate libraries or different patterns to learn.
• Production observability — Built-in event listeners for logging, metrics, and alerting. Know when circuits open, retries fire, or rate limits hit.
• Framework integrations — Drop-in support for FastAPI, Django, and Flask.

All Seven Patterns

Pattern	Config	What it does
Retry	RetryConfig	Exponential backoff with jitter
Timeout	TimeoutConfig	Per-call time limits
Circuit Breaker	CircuitBreakerConfig	Stop calling failing services
Fallback	FallbackConfig	Graceful degradation
Bulkhead	BulkheadConfig	Concurrency limiting
Rate Limiter	RateLimiterConfig	Token bucket rate limiting
Cache	CacheConfig	LRU result caching with TTL

Comparison

	pyresilience	tenacity	pybreaker	backoff	stamina
Retry	Yes	Yes	-	Yes	Yes
Circuit Breaker	Yes	-	Yes	-	-
Timeout	Yes	-	-	-	-
Fallback	Yes	-	-	-	-
Bulkhead	Yes	-	-	-	-
Rate Limiter	Yes	-	-	-	-
Cache	Yes	-	-	-	-
Unified API	Yes	-	-	-	-
Zero Dependencies	Yes	Yes	-	-	-
Async	Yes	Yes	-	Yes	Yes

Comparison reflects built-in capabilities and unified API model, not every possible custom composition.

Documentation

Full guides, API reference, and examples at pyresilience.readthedocs.io.

License

MIT