waiter

What it is and what it does

Waiter is a retry and polling library that replaces decorator-based approaches with iteration. Instead of wrapping functions with retry decorators, you create a delay object (e.g., `wait(1)` for constant 1-second delays, or `wait(1) * 2` for exponential backoff) and iterate over it in a loop. Each iteration yields the elapsed time and sleeps as needed before the next attempt. The library supports common delay strategies like incremental backoff, Fibonacci, polynomial, and exponential sequences, all composable through operator overloading.

Waiter decouples delay algorithms from your application logic, making it easier to customize retry behavior per call site and to handle different exceptions or results with custom logic. It includes functional methods like `retry()`, `poll()`, and `repeat()` for common patterns, plus async support for coroutine-based retries. The iteration-based design means you control the loop body entirely—logging, exception handling, and early exit are all straightforward.

Use it for

• Retrying flaky API calls with exponential backoff and jitter to avoid thundering herd.
• Polling an external service until a condition is met, with a timeout to prevent infinite loops.
• Throttling iteration over results from a generator with configurable delays between items.
• Testing code that depends on eventual consistency by polling a predicate until it succeeds.
• Implementing circuit-breaker patterns with custom delay sequences that escalate over time.

Worth the install?

AI-flagged interpretation of the facts on this page. Verify before relying on it.

Install

waiter on PyPI

Before you install

Low friction: pure Python wheel with no runtime dependencies. Actively maintained with a release 19 days old; supports current Python versions (3.11–3.15) and has been stable since its first release in 2016.

License in practice

Apache-2.0 is permissive; you can use, modify, and distribute this package freely in commercial and private projects with minimal restrictions.

Quickstart

from waiter import wait

# Create a delay strategy
for elapsed in wait(1):  # repeat every 1 second
    try:
        result = some_operation()
        break
    except TemporaryError:
        pass  # loop sleeps, then retries

# Or use exponential backoff
backoff = wait(1) * 2  # 1, 2, 4, 8, ...
for _ in backoff:
    if check_condition():
        break

Package facts

Evidence: waiter-1.6-py3-none-any.whl

Tags

More Python Modules packages

See also polling2 · reretry · waiting · timeout-sampler · retry · backoff · python-backoff · retrying · busypie · aioretry