integrations

Склад готовых интеграций с разными системами — каждый кейс в отдельной самодостаточной папке с рабочим кодом, проверенным на практике.

Структура

integrations/
├── README.md          # этот файл (оглавление склада)
├── ydb-orm/           # YDB + SQLAlchemy ORM (sync + async + Alembic, local и serverless)
├── dynamodb-orm/      # DynamoDB + SQLAlchemy ORM (PartiQL через pydynamodb)
└── <next>/            # следующая интеграция

Интеграции

Папка	Что	Стек	Статус
ydb-orm	YDB через SQLAlchemy ORM	Python 3.14, sqlalchemy 2.0, ydb-sqlalchemy, alembic	✅ рабочий (local Docker + serverless YC)
dynamodb-orm	DynamoDB через SQLAlchemy ORM	Python 3.12, sqlalchemy 2.0, pydynamodb, boto3	✅ рабочий (DynamoDB Local, Docker)

Конвенции

• Каждая интеграция — отдельная папка с собственным README.md и pyproject.toml.
• Секреты (ключи, токены, .env) — никогда не коммитить; в .gitignore каждой папки и в корне. Используйте примеры конфигов (*.example).
• Код проверяется реальным прогоном (не только компиляцией) перед публикацией.