Production-grade retries made easy.
Project description
stamina: Production-grade Retries Made Easy
Transient failures are common in distributed systems. To make your systems resilient, you need to retry failed operations. But bad retries can make things much worse.
stamina is an opinionated wrapper around the great-but-unopinionated Tenacity package. Its goal is to be as ergonomic as possible, while doing the right thing by default, while minimizing potential for misuse. It is the result of years of copy-pasting the same configuration over and over again:
- Retry only on certain exceptions.
- Exponential backoff with jitter between retries.
- Limit the number of retries and total time.
- Automatic async support.
- Preserve type hints of the decorated callable.
- Count (Prometheus) and log (structlog) retries with basic metadata, if they're installed.
- Easy global deactivation for testing.
For example:
import httpx
import stamina
@stamina.retry(on=httpx.HTTPError, attempts=3)
def do_it(code: int) -> httpx.Response:
resp = httpx.get(f"https://httpbin.org/status/{code}")
resp.raise_for_status()
return resp
Async callables work use the same API and it's possible to retry arbitrary blocks, too. Please refer to our tutorial for more examples.
Release Information
Added
- Official Python 3.12 support. #9
- Async support. #10
- Retries of arbitrary blocks using (async)
for
loops and context managers. #12 - Proper documentation. #16
- A backwards-compatibility policy.
Changed
- The timeout, wait_initial, wait_max, and wait_jitter arguments can now also be of type
datetime.timedelta
.
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.