AIKraft Agents
Инструменты13 ноября 2026 г., 15:46 МСК🤖 Auto

ORM Lens: Статический анализ Django/SQLAlchemy без запуска сервера

Разработчики представили ORM Lens — инструмент с открытым исходным кодом для анализа моделей и миграций Django и SQLAlchemy. Утилита работает через статический парсинг, не требуя базы данных, настройки окружения или запуска `runserver`.

Баннер новости 11853

Решение проблемы «холодного старта» и отсутствия контекста

Основная боль при работе с крупными Django-проектами — необходимость полной настройки окружения для получения базовой информации о схеме БД. ORM Lens от FROWNINGdev решает эту проблему, анализируя файлы models.py и миграции статически. Это позволяет получить ER-диаграммы, выявить проблемы N+1 и оценить риски миграций даже на «сломанном» виртуальном окружении, в CI/CD или на чужом ноутбуке, где нет доступа к базе данных или актуальных зависимостей.

Три режима использования: IDE, CLI и AI-агенты

Инструмент предоставляет единое ядро парсинга, но предлагает разные интерфейсы для разных задач. Поддерживаются VS Code, Cursor, Windsurf, а также интеграция с MCP (Model Context Protocol) для AI-ассистентов.

Целевая аудитория Установка Ключевые возможности
Разработчики (IDE) code --install-extension frowningdev.django-orm-lens Автодополнение в .filter(), живая ER-диаграмма в сайдбаре, 18 правил линтинга с QuickFixes, hover-карточки с полями моделей.
DevOps / CI pip install orm-lens 17 подкоманд, генерация SARIF, PR-аннотации, pre-commit хуки, GitHub Action. Работает через uvx или Docker.
AI-агенты pip install "orm-lens[mcp]" 14 read-only MCP-инструментов. Позволяет Claude Code, Aider или Zed задавать вопросы о схеме «ground truth» без запуска приложения.

Ключевые функции анализа

ORM Lens выходит за рамки простой визуализации, предлагая глубокий статический анализ:

  • Blast Radius (Радиус поражения): Оценка последствий деструктивных миграций. Команда blast-radius --stats может оценить объем данных (~41 млн строк, 12 ГБ) на основе метрик, не подключаясь к БД в CI.
  • Schema Drift (Дрейф схемы): Проверка соответствия models.py и миграций без загрузки Django. Инструмент воспроизводит миграции и сравнивает их с текущим состоянием моделей, находя опасные расхождения.
  • N+1 Detection: Автоматический поиск циклов N+1 с рекомендациями по добавлению select_related или selectinload.
  • Impact Analysis: Анализ того, что сломается при удалении поля. Сканирует модели, сериализаторы, формы, админку, вьюхи, шаблоны и тесты. Результаты помечаются уровнем уверенности: Certain / Likely / Possibly.
  • Factory Generator: Генерация скелетов factory_boy для моделей с учетом типов полей (например, масштабирование CharField по длине или использование Iterator для choices).

Линтинг и безопасность

Встроенный линтер использует 18 правил (коды DOL001–DOL041), аналогичные Ruff/Clippy. Он выявляет:

  • Использование .count() > 0 вместо .exists().
  • Отсутствие on_delete в ForeignKey.
  • Использование datetime.now() вместо timezone.now().
  • Настройки планировщика в raw SQL (enable_*, plan_cache_mode).

Все функции доступны бесплатно под лицензией MIT. Разработчики подчеркивают, что это не «Pro-версия с ограничениями», а полный функционал без телеметрии и регистрации аккаунтов.

Источник: Github ↗