Skip to content

Режимы Установки

Выбирайте Самый Узкий Режим Под Задачу

Практически codex-django используется в трех режимах:

  1. Runtime library mode, когда проекту нужны только переиспользуемые Django-модули.
  2. Scaffold mode, когда разработчик генерирует или расширяет Codex-shaped проект через codex-django-cli.
  3. Contributor mode, когда меняется сама библиотека codex-django.

Runtime Library Mode

Ставьте только пакет и те extras, которые реально нужны вашему Django-проекту:

pip install codex-django
pip install "codex-django[cli]"
pip install "codex-django[admin,observability]"
pip install "codex-django[dev]"

Этот режим нужен командам, которые используют runtime-модули core, system, booking, messaging и cabinet. Базовая установка намеренно не тянет debug toolbar, admin theme и metrics-пакеты; ставьте admin для django-unfold, observability для django-prometheus, а dev для contributor/debug tooling.

Scaffold Mode

Используйте companion CLI package, когда нужно создать новый проект или добавить в него feature scaffolds:

pip install "codex-django[cli]"
# или: pip install codex-django-cli
codex-django init myproject --with-booking --with-messaging
codex-django menu

CLI больше не является частью runtime-дистрибутива. CLI — самостоятельный генератор; от codex-django зависят созданные им проекты. Необязательный extra [cli] runtime-пакета устанавливает генератор вместе с runtime.

Contributor Mode

Если вы меняете сам codex-django, поднимайте полное development-окружение:

uv sync --extra maintainer
uv run pytest
uv run mypy src/
uv run pre-commit run --all-files
uv run python tools/dev/check.py --ci
uv build --no-sources

Production Guidance

  • generated project code должен жить в вашем application repository;
  • scaffolding лучше считать developer-time или build-time активностью;
  • production images должны тянуть только те зависимости, которые реально нужны runtime-приложению;
  • не завязывайте production container на interactive CLI flows без явной операционной причины.

Что Читать Дальше