aiobreaker

What it is and what it does

aiobreaker is an asyncio-native implementation of the Circuit Breaker pattern, a design pattern that prevents cascading failures by wrapping calls to external services or integration points. When a service fails repeatedly, the circuit breaker stops sending requests to it temporarily, allowing the service time to recover while your application handles the failure gracefully instead of repeatedly hitting a broken endpoint.

The package lets you decorate async functions with a circuit breaker that tracks failures, opens when a threshold is reached, and automatically resets after a timeout. It supports configurable failure thresholds, excluded exceptions (for business logic errors that shouldn't trigger the breaker), event listeners for monitoring, and optional Redis-backed state sharing across processes. However, the project is no longer maintained—the last commit was in early 2022—so it may not work correctly with recent Python or asyncio changes.

Use it for:

• Protect database queries from overwhelming a struggling database by stopping requests when failures spike
• Guard API calls to third-party services so your app fails fast instead of timing out repeatedly
• Implement resilience in microservices by preventing one failing service from dragging down dependent services
• Monitor integration point health with event listeners to alert on repeated failures or circuit state changes

Worth the install?

AI-flagged interpretation of the facts on this page — verify before relying

Implements the Circuit Breaker pattern for asyncio applications, allowing you to wrap dangerous operations (like external API calls or database queries) so they fail gracefully without cascading failures across your system.

Yes, if you need Circuit Breaker pattern support in an asyncio application and can accept that the package is unmaintained. The code is simple, has no dependencies, and the pattern itself is stable—but be aware that it will not receive updates for Python version changes or asyncio improvements. Consider it only for stable, long-lived codebases where you can maintain a fork if needed.

Install

aiobreaker on PyPI

pip install aiobreaker

uv add aiobreaker

poetry add aiobreaker

Installing aiobreaker

Before you install

Low install friction with no runtime dependencies. However, the package is abandoned—last release was 2021-05-17 and last commit 2022-01-01—so it will not receive bug fixes or security updates for new Python or asyncio changes.

License in practice

BSD permissive license means you can use, modify, and distribute this package freely in commercial and open-source projects with minimal restrictions.

Quickstart

pip install aiobreaker

from aiobreaker import CircuitBreaker
from datetime import timedelta

db_breaker = CircuitBreaker(fail_max=5, reset_timeout=timedelta(seconds=60))

@db_breaker
async def outside_integration():
    # Your async operation here
    pass

Requires Python 3.6 or higher; designed for asyncio-based applications only.

Verify before relying

• Whether the package works reliably with Python versions released after 2022-01-01
• Current compatibility with modern asyncio implementations and async/await patterns
• Whether optional Redis backing feature is functional and documented

Package facts

Evidence: aiobreaker-1.2.0-py3-none-any.whl

Tags

More Libraries packages