# FluxGuard

FluxGuard — это библиотека для автоматического мониторинга и адаптации асинхронного кода в Python. Она анализирует runtime-потоки (flows), выявляет проблемы вроде deadlocks, race conditions и bottlenecks, генерирует отчёты и предлагает автофиксы. Поддерживает asyncio, trio и gevent. Идеально для веб-приложений (FastAPI, Django) и долгоживущих проектов, где код "стареет" и нуждается в оптимизации.

## Ключевые фичи:

* Динамический граф потоков с выявлением проблем.
* Автофиксы через "guards" (мини-функции для предотвращения issues).
* Хранение истории и "обучение" на прошлых запусках.
* Логирование отчётов в файл (fluxguard.log) с деталями эндпоинтов.
* Минимальный overhead, настраиваемые thresholds.

## Быстрый старт

### 1. Через PyPI (Ещё не опубликовано)

```bash
    pip install fluxguard
```

### 2. Из whl (локальная установка)
```bash
    pip install fluxguard-0.1.0-py3-none-any.whl
```

## Тестирование

* Запустите ваш сервер: python main.py (или uvicorn main:app --reload).
* Выполните запросы (POST/GET) — проверьте fluxguard.log на наличие полных отчётов с именами эндпоинтов и данными от gevent (если используете gevent.spawn в коде).

## Если проблемы
* Ошибки сборки: Пришлите лог (вывод python -m build) — часто из-за отсутствующих импортов в setup.py или неправильной структуры (файлы не в подпапке fluxguard/).
* Версия Python: Убедитесь в Python 3.7+ (python --version).
* Gevent: Установите pip install gevent в venv, если используете его в тестовом коде.