Решение проблемы «холодного старта» и отсутствия контекста
Основная боль при работе с крупными 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 ↗
