Metadata-Version: 2.4
Name: flowguard-py
Version: 0.1.0
Summary: Smart task orchestrator with automatic state management and fault tolerance.
Author-email: JustPy Team <your-email@example.com>
License: MIT
Project-URL: Homepage, https://github.com/Programmist846flowguard
Project-URL: Repository, https://github.com/Programmist846/flowguard.git
Keywords: orchestrator,pipeline,circuit-breaker,asyncio
Classifier: Programming Language :: Python :: 3
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Classifier: Development Status :: 3 - Alpha
Classifier: Intended Audience :: Developers
Classifier: Topic :: Software Development :: Libraries :: Python Modules
Requires-Python: >=3.8
Description-Content-Type: text/markdown
License-File: LICENSE
Dynamic: license-file

# ⚡ FlowGuard

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

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

## 🚀 Почему FlowGuard?

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

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

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

## 📦 Установка

```bash
pip install flowguard-py
