🌀 Retry Tools
A Python decorator for retrying functions with exponential backoff, optional jitter, and full support for both synchronous and asynchronous code.
🔍 About
This library provides a simple yet powerful @retry decorator that retries a function when specified exceptions are raised. It supports:
- Synchronous and asynchronous functions
- Exponential backoff with optional jitter
- Custom exception handling
- Logging or custom log output
Useful for handling flaky APIs, intermittent database errors, or any transient issues where retrying helps.
📦 Installation
pip install retrytools
🚀 Quick Start
Basic Usage
from retrytools import retry
@retry(catch_errors=ValueError, tries=3, delay=1)
def flaky_function():
# Simulates an error-prone operation
if random.random() < 0.7:
raise ValueError("Transient issue!")
return "Success!"
result = flaky_function()
print(result)
With Async Function
import asyncio
from retrytools import retry
@retry(catch_errors=ConnectionError, tries=5, delay=0.5)
async def unstable_async_api():
if random.random() < 0.5:
raise ConnectionError("Temporary network glitch")
return "Fetched!"
asyncio.run(unstable_async_api())
⚙️ Parameters
| Argument | Type | Description |
|---|---|---|
catch_errors |
Type[Exception] or tuple |
Exception(s) to retry on |
tries |
int |
Max attempts (default: 3) |
delay |
float |
Initial delay in seconds |
throw_error |
Exception (optional) |
Custom error to raise after final failure |
logger |
Logger or Callable[[str]] |
Logging handler (e.g., print or logging.Logger) |
jitter |
bool or float |
Random delay variation: True for full jitter, float for additive |
📝 Example with Logging
import logging
from retrytools import retry
logger = logging.getLogger(__name__)
logging.basicConfig(level=logging.INFO)
@retry(catch_errors=(RuntimeError, ConnectionError), tries=4, throw_error=Exception("Custom"), delay=2, logger=logger, jitter=True)
def sometimes_fails():
if random.randint(0, 1):
raise RuntimeError("Oops!")
return "Got it!"
sometimes_fails()
📌 Notes
- Jitter is helpful to avoid retry storms in distributed systems.
- Supports Python 3.7+.
- Works transparently for both sync and async code.
🛠️ License
MIT License
Metadata
Release files for retrytools 0.0.3.post1
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | Provenance | Actions |
|---|---|---|---|---|
| retrytools-0.0.3.post1.tar.gz | 16.3 kB | Without provenance | Details for retrytools-0.0.3.post1.tar.gz |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Actions Reset |
|---|---|---|---|---|
| retrytools-0.0.3.post1-py3-none-any.whl | Python 3 | none | any | Details for retrytools-0.0.3.post1-py3-none-any.whl |
Total release size: 21.4 kB
Release files / retrytools-0.0.3.post1.tar.gz
| Download URL | retrytools-0.0.3.post1.tar.gz |
|---|---|
| Size | 16.3 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
e798f88678c390f88d02f9d565ef0456f98a477075b6a691ab7e9ad9790a7638
|
|
BLAKE2b-256 checksum How to use checksums |
25258fc77eacab6a162b7132a1495f0919c0cd6b26a1e5546c8703a50c795e00
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
uv/0.7.8
|
Release files / retrytools-0.0.3.post1-py3-none-any.whl
| Download URL | retrytools-0.0.3.post1-py3-none-any.whl |
|---|---|
| Size | 5.1 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
5096ab9d26386b7af0aac0c4c1dc121e2d1ab168ad98dd86f3d725fd7037f75c
|
|
BLAKE2b-256 checksum How to use checksums |
e2f8f78be878381af5a0598431379f769ea171de8e2c1228ba85ce321e09abe5
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
uv/0.7.8
|
Security for retrytools 0.0.3.post1
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
No provenance found
None of the files in this release were uploaded with provenance metadata.
A note on package security
PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.
To learn more about protecting yourself from malicious actors, visit our package security documentation.