flowguard-py 0.1.0

Smart task orchestrator with automatic state management and fault tolerance.

⚡ FlowGuard

Умный оркестратор задач с автоматическим управлением состоянием, откатами (Saga) и отказоустойчивостью.

FlowGuard позволяет строить надежные пайплайны обработки данных на Python без тяжелых зависимостей вроде Celery или Airflow. Идеально для микросервисов, скриптов автоматизации и ETL-процессов.

🚀 Почему FlowGuard?

Представьте сценарий:

1. Создать пользователя в БД.
2. Списать деньги с карты.
3. Отправить приветственное письмо.

Что если шаг 2 упадет? Пользователь создан, но не оплачен. Мусор в базе. Что если шаг 3 упадет? Деньги списаны, пользователь создан, но он не знает об этом.

FlowGuard решает это:

• 🛡 Автоматический откат (Compensation): Если шаг падает, библиотека автоматически запускает функции отката для всех предыдущих шагов (паттерн Saga).
• 🔌 Circuit Breaker: Если внешний сервис (например, SMTP) лежит, FlowGuard перестанет его дергать на время «охлаждения», чтобы не усугублять ситуацию.
• 💾 Сохранение состояния (Persistence): Прогресс сохраняется на диск (JSON) или в Redis. Перезапустите скрипт — он продолжится с места сбоя, а не с начала.
• ⏳ Умные повторные попытки (Retries): Экспоненциальная задержка между попытками.

📦 Установка

pip install flowguard-py