retry-easy 0.1.1

A lightweight, zero-dependency retry decorator for synchronous and asynchronous Python functions

retry_easy

A lightweight, zero-dependency retry decorator for synchronous and asynchronous Python functions.

---

Features

• No external runtime dependencies (standard library only)
• Supports both synchronous and asynchronous functions
• Configurable retry attempts, backoff, and jitter
• Fully typed (ParamSpec, TypeVar) and compatible with mypy --strict
• Safe handling of cancellation (asyncio.CancelledError)
• Small, readable implementation

---

Installation

pip install retry_easy

On Python < 3.10, typing-extensions is required for ParamSpec. It is installed automatically.

---

Quick Start

Synchronous example

from retry_easy import retry
import requests

@retry(attempts=3, delay=1.0, backoff=2.0)
def fetch_data():
    response = requests.get("https://api.example.com/data")
    response.raise_for_status()
    return response.json()

Asynchronous example

import asyncio
from retry_easy import retry

@retry(
    attempts=5,
    delay=0.5,
    exceptions=(ConnectionError, TimeoutError),
    jitter=0.2,
)
async def call_service():
    await asyncio.sleep(0.1)
    raise ConnectionError("Service temporarily unavailable")

---

API Reference

Parameter	Type	Default	Description
attempts	int	3	Number of attempts (≥ 1)
delay	float	1.0	Initial delay in seconds (≥ 0)
backoff	float	1.0	Multiplier applied after each failure
exceptions	tuple[type[Exception], ...]	(Exception,)	Exceptions that trigger a retry
jitter	float	0.0	Random delay added to avoid synchronization

Jitter behavior

wait_time = current_delay + random.uniform(0, jitter)

---

Why retry_easy?

Use case	Typical approach	retry_easy
Simple retry logic	manual try/except loops	decorator
Async support	ad-hoc implementations	built-in
Lightweight dependency	heavy libraries	stdlib only
Type safety	partial typing	full typing

This library targets the common use case: simple, readable retry logic without external dependencies.

---

Development

git clone https://github.com/undescoreF/retry_easy.git
cd retry_easy

pip install -e ".[dev]"

pytest tests/ -v
mypy src/
ruff check src/ tests/

---

Contributing

Contributions are welcome.

1. Fork the repository
2. Create a branch (feature/my-change)
3. Commit changes with clear messages
4. Open a Pull Request
5. Ensure CI passes (tests, lint, type checks)

---

License

MIT License. See LICENSE for details.