Metadata-Version: 2.4
Name: workerlib
Version: 0.5.1
Summary: Async RabbitMQ worker utilities
Author: ametist-dev
Maintainer: ametist-dev
Project-URL: Homepage, https://github.com/ametist-dev/workerlib
Project-URL: Repository, https://github.com/ametist-dev/workerlib
Project-URL: Issues, https://github.com/ametist-dev/workerlib/issues
Keywords: async,rabbitmq,aio-pika,workers,queue,messaging,background-jobs
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Classifier: Intended Audience :: Developers
Classifier: Topic :: Software Development :: Libraries
Classifier: Development Status :: 5 - Production/Stable
Requires-Python: >=3.10
Description-Content-Type: text/markdown
Requires-Dist: aio-pika<10,>=9.0.0
Requires-Dist: httpx<1,>=0.24.0

# WorkerLib

Асинхронные утилиты для работы с RabbitMQ: пул воркеров, очереди, retry, DLQ, вебхуки. Основа — [aio-pika](https://aio-pika.readthedocs.io/).

## Установка

```bash
pip install workerlib
```

Python 3.10+.

## Минимальный пример

```python
import asyncio
from workerlib import WorkerPool

async def task_handler(data: dict) -> bool:
    print(data)
    return True

async def main():
    async with WorkerPool() as pool:
        pool.add_worker("tasks", task_handler)
        await pool.send("tasks", {"id": 1})

asyncio.run(main())
```

## Документация

Полное описание, конфигурация, обработка ошибок, метрики, вебхуки и интеграция с FastAPI — в каталоге **[docs/](docs/)**:

- [Обзор и навигация](docs/index.md)
- [Быстрый старт](docs/quickstart.md)
- [Руководство](docs/guide/configuration.md) (конфигурация, ошибки, метрики, вебхуки, FastAPI)
- [Справочник API](docs/api.md)
