Ferronit

Высокопроизводительный Python ASGI-фреймворк с ядром на Rust. Маршрутизация, разбор запроса, JSON, gzip и CORS работают в нативном коде; ваши хендлеры — обычный Python.

Документация: docs/ — быстрый старт, роутинг, запросы, инъекция, слой данных (три варианта), DDD/DI, Rust-ядро, бенчмарки, ASVS.

Установка

pip install ferronit        # ставит сразу Python-слой и нативное ядро (ferronit._core + ferronit.db)

Ferronit — один пакет, собранный maturin-ом как mixed-проект. Ядро (ferronit._core) собирается с фичей abi3-py312 — один wheel работает на всех CPython от 3.12 до 3.14+. Внешних runtime-зависимостей нет.

# app.py
from ferronit import Ferronit

app = Ferronit()

@app.route("/hello/{name}")
async def hello(name: str):
    return {"hello": name}

ferronit dev                          # dev-сервер (uvicorn, reload)
ferronit dev --server granian         # granian (Rust, ~4× быстрее)
ferronit run --workers 4              # прод: granian, fallback uvicorn

Почему быстро

Маршрутизация — Rust matchit, фактически O(1): Ferronit не деградирует с ростом числа маршрутов, FastAPI теряет до 4× внутри одной таблицы. Методика — только ab (C-клиент); полный разбор — docs/benchmarks.md.

Слой данных

Три варианта под разные задачи — от «запрос → JSON целиком в Rust» до полноценного ORM. Какой выбрать: docs/data/overview.md.

Разработка

poetry install --all-extras             # окружение в .venv + все зависимости
PYO3_USE_ABI3_FORWARD_COMPATIBILITY=1 poetry run maturin develop --release   # Rust-ядро
./scripts/check.sh                      # линт → типы → докстринги → сборка ядра → тесты
poetry run pytest tests/ -q             # 263 теста

Окружение ведёт Poetry (poetry.toml — venv внутри проекта), wheel с Rust-ядром собирает maturin (см. [tool.maturin] в pyproject.toml), поэтому сам проект Poetry не ставит.

• AGENTS.md — инструкция для код-агентов (Claude Code, Codex, Cursor, ...).
• examples/ — minimal, DI, LLM + SSE, RAG, WebSocket; examples/app.py — DDD-пример.
• Пакет помечен py.typed; для Rust-ядра лежит ferronit/_core.pyi.
• bench/ — измерительный стенд (все цифры выше), не входит в пакет.

Релиз

# версия правится в двух файлах: ferronit/__init__.py и ferronit-rs/Cargo.toml
git tag -a v0.8.2 -m "Ferronit 0.8.2" && git push origin v0.8.2

Тег v* запускает .github/workflows/release.yml: проверки и тесты → колёса (Linux glibc/musl, macOS, Windows) и sdist → GitHub Release с артефактами → публикация на PyPI (Trusted Publishing). Если версия тега не совпадает с Cargo.toml/__init__.py, workflow падает до публикации.

Docker

docker build -t ferronit:0.9.0 .
docker run --rm -p 8000:8000 ferronit:0.9.0

Лицензия

Apache License 2.0 — см. LICENSE. Использование, изменение и распространение разрешены, включая коммерческое; сохраняются уведомления об авторстве и патентная оговорка.