codex-django 0.2.5__tar.gz

codex_django-0.2.5/.djlintrc

@@ -0,0 +1,6 @@
+{
+    "profile": "django",
+    "indent": 4,
+    "ignore": "H016,H030,H031",
+    "extension": "html"
+}

codex_django-0.2.5/.github/workflows/ci.yml

@@ -0,0 +1,111 @@
+name: CI Pipeline
+
+on:
+  push:
+    branches: [develop, main]
+    paths-ignore: ["**.md", "docs/**", ".gitignore"]
+  pull_request:
+    branches: [main]
+  workflow_dispatch:
+
+jobs:
+  quality-gate:
+    name: Quality Gate
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - uses: actions/setup-python@v5
+        with:
+          python-version: "3.12"
+      - uses: astral-sh/setup-uv@v7
+        with:
+          version: "0.10.7"
+
+      - name: Sync dev environment
+        run: uv sync --locked --extra maintainer
+
+      - name: Run pre-commit
+        run: uv run pre-commit run --all-files
+
+      - name: Run pip-audit
+        run: uv run pip-audit --skip-editable --ignore-vuln CVE-2026-4539
+
+      - name: Run mypy
+        run: uv run mypy src/
+
+  unit-tests:
+    name: Unit Tests
+    needs: quality-gate
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - uses: actions/setup-python@v5
+        with:
+          python-version: "3.12"
+      - uses: astral-sh/setup-uv@v7
+        with:
+          version: "0.10.7"
+
+      - name: Sync dev environment
+        run: uv sync --locked --extra maintainer
+
+      - name: Run unit tests
+        run: uv run pytest tests/ -m "unit" -v --tb=short
+
+  integration-tests:
+    name: Integration Tests
+    needs: unit-tests
+    runs-on: ubuntu-latest
+
+    steps:
+      - uses: actions/checkout@v4
+      - uses: actions/setup-python@v5
+        with:
+          python-version: "3.12"
+      - uses: astral-sh/setup-uv@v7
+        with:
+          version: "0.10.7"
+
+      - name: Sync dev environment
+        run: uv sync --locked --extra maintainer
+
+      - name: Run integration tests
+        run: |
+          set +e
+          uv run pytest --override-ini addopts='' tests/ -m "integration" -v --tb=short
+          status=$?
+          set -e
+          if [ "$status" -eq 5 ]; then
+            echo "No integration tests collected; treating as success."
+            exit 0
+          fi
+          exit "$status"
+
+  e2e-tests:
+    name: E2E Tests
+    needs: integration-tests
+    runs-on: ubuntu-latest
+
+    steps:
+      - uses: actions/checkout@v4
+      - uses: actions/setup-python@v5
+        with:
+          python-version: "3.12"
+      - uses: astral-sh/setup-uv@v7
+        with:
+          version: "0.10.7"
+
+      - name: Sync dev environment
+        run: uv sync --locked --extra maintainer
+
+      - name: Run E2E tests
+        run: |
+          set +e
+          uv run pytest --override-ini addopts='' tests/ -m "e2e" -v --tb=short
+          status=$?
+          set -e
+          if [ "$status" -eq 5 ]; then
+            echo "No E2E tests collected; treating as success."
+            exit 0
+          fi
+          exit "$status"

codex_django-0.2.5/.github/workflows/docs.yml

@@ -0,0 +1,73 @@
+name: Deploy Docs
+
+on:
+  push:
+    tags:
+      - "v*"
+  workflow_dispatch:
+    inputs:
+      version:
+        description: "Version alias to deploy (e.g. 0.x, 1.x)"
+        required: true
+      alias:
+        description: "Alias (latest, stable, or leave empty)"
+        required: false
+        default: "latest"
+
+env:
+  FORCE_JAVASCRIPT_ACTIONS_TO_NODE24: true
+
+permissions:
+  contents: write
+
+jobs:
+  deploy:
+    name: Build & Deploy Docs
+    runs-on: ubuntu-latest
+    steps:
+      - name: Checkout code
+        uses: actions/checkout@v4
+        with:
+          fetch-depth: 0
+
+      - name: Configure Git Credentials
+        run: |
+          git config user.name github-actions[bot]
+          git config user.email 41898282+github-actions[bot]@users.noreply.github.com
+
+      - name: Set up Python 3.12
+        uses: actions/setup-python@v5
+        with:
+          python-version: "3.12"
+      - uses: astral-sh/setup-uv@v7
+        with:
+          version: "0.10.7"
+
+      - name: Sync docs environment
+        run: uv sync --locked --extra docs
+
+      - name: Resolve version alias (tag push)
+        if: github.event_name == 'push'
+        id: version
+        run: |
+          TAG="${GITHUB_REF_NAME}"
+          VERSION=$(echo "$TAG" | sed 's/^v//')
+          MAJOR=$(echo "$VERSION" | cut -d. -f1)
+          echo "version=${VERSION}" >> "$GITHUB_OUTPUT"
+          echo "alias=${MAJOR}.x" >> "$GITHUB_OUTPUT"
+
+      - name: Deploy versioned docs (tag push)
+        if: github.event_name == 'push'
+        run: |
+          uv run mike deploy --push --update-aliases "${{ steps.version.outputs.version }}" "${{ steps.version.outputs.alias }}" latest
+          uv run mike set-default --push latest
+
+      - name: Deploy versioned docs (manual)
+        if: github.event_name == 'workflow_dispatch'
+        run: |
+          if [ -n "${{ inputs.alias }}" ]; then
+            uv run mike deploy --push --update-aliases "${{ inputs.version }}" "${{ inputs.alias }}"
+          else
+            uv run mike deploy --push "${{ inputs.version }}"
+          fi
+          uv run mike set-default --push latest

codex_django-0.2.5/.github/workflows/publish.yml

@@ -0,0 +1,42 @@
+name: Publish to PyPI
+
+on:
+  push:
+    tags:
+      - "v*"
+
+jobs:
+  build-n-publish:
+    name: Build and publish to PyPI
+    runs-on: ubuntu-latest
+    environment:
+      name: pypi
+      url: https://pypi.org/project/codex-django/
+    permissions:
+      id-token: write
+      contents: read
+
+    steps:
+      - name: Checkout code
+        uses: actions/checkout@v4
+        with:
+          fetch-depth: 0
+
+      - name: Set up Python
+        uses: actions/setup-python@v5
+        with:
+          python-version: "3.12"
+      - uses: astral-sh/setup-uv@v7
+        with:
+          version: "0.10.7"
+
+      - name: Build sdist and wheel
+        run: uv build --no-sources
+
+      - name: Check artifacts
+        run: uvx twine check dist/*
+
+      - name: Publish to PyPI
+        uses: pypa/gh-action-pypi-publish@release/v1
+        with:
+          print-hash: true

codex_django-0.2.5/.gitignore

@@ -0,0 +1,91 @@
+# Byte-compiled / optimized / DLL files
+__pycache__/
+*.py[codz]
+*$py.class
+
+# C extensions
+*.so
+
+# Distribution / packaging
+.Python
+build/
+develop-eggs/
+dist/
+downloads/
+eggs/
+.eggs/
+lib/
+lib64/
+parts/
+sdist/
+var/
+wheels/
+share/python-wheels/
+*.egg-info/
+.installed.cfg
+*.egg
+MANIFEST
+
+# Unit test / coverage reports
+htmlcov/
+.tox/
+.nox/
+.coverage
+.coverage.*
+.cache
+nosetests.xml
+coverage.xml
+*.cover
+*.py.cover
+.hypothesis/
+.pytest_cache/
+cover/
+
+# Django stuff:
+*.log
+local_settings.py
+db.sqlite3
+db.sqlite3-journal
+
+# Environments
+.env
+.envrc
+.venv
+.venv-rebuild/
+env/
+venv/
+ENV/
+env.bak/
+venv.bak/
+
+# mkdocs documentation
+/site
+
+# mypy
+.mypy_cache/
+.dmypy.json
+dmypy.json
+
+# Ruff stuff:
+.ruff_cache/
+.uv-cache/
+
+# PyPI configuration file
+.pypirc
+
+# Claude Code
+.claude/
+
+# IDEs
+.idea/
+.vscode/
+.cursorignore
+.cursorindexingignore
+
+# OS junk
+.DS_Store
+Thumbs.db
+*.swp
+
+# Codex Sandbox
+sandbox/

codex_django-0.2.5/.pre-commit-config.yaml

@@ -0,0 +1,37 @@
+repos:
+  - repo: https://github.com/pre-commit/pre-commit-hooks
+    rev: v5.0.0
+    hooks:
+      - id: trailing-whitespace
+      - id: end-of-file-fixer
+      - id: check-yaml
+        exclude: ^mkdocs\.yml$
+      - id: check-json
+      - id: check-added-large-files
+        args: ['--maxkb=2000']
+      - id: check-merge-conflict
+
+  - repo: https://github.com/astral-sh/ruff-pre-commit
+    rev: v0.9.6
+    hooks:
+      - id: ruff
+        args: [--fix]
+      - id: ruff-format
+
+  - repo: https://github.com/igorshubovych/markdownlint-cli
+    rev: v0.44.0
+    hooks:
+      - id: markdownlint
+        args: ["--fix", "--disable", "MD013"]
+
+  - repo: https://github.com/PyCQA/bandit
+    rev: 1.8.2
+    hooks:
+      - id: bandit
+        args: ["-c", "pyproject.toml"]
+        additional_dependencies: ["bandit[toml]"]
+
+  - repo: https://github.com/Yelp/detect-secrets
+    rev: v1.5.0
+    hooks:
+      - id: detect-secrets

codex_django-0.2.5/.python-version

@@ -0,0 +1 @@
+3.12

codex_django-0.2.5/CHANGELOG.md

@@ -0,0 +1,64 @@
+# Changelog
+
+All notable changes to this project will be documented in this file.
+
+## [Unreleased]
+
+- Ongoing release polish after the first public packaging pass.
+
+## [0.2.5] - 2026-03-29
+
+First public release.
+
+### Added
+
+- Optional `cli` extra that installs the published `codex-django-cli` companion package.
+- Runtime compatibility shims that forward legacy `codex_django.cli.*` imports to `codex-django-cli`.
+- Additional runtime test coverage for dashboard selectors, Redis managers, and showcase views.
+
+### Changed
+
+- Refocused `codex-django` on reusable Django runtime modules while project scaffolding lives in `codex-django-cli`.
+- Replaced the old runtime extras layout with `cli`, `dev`, `maintainer`, and `docs`.
+- Updated README, install guides, and CI workflow around the runtime/CLI split.
+- Reworked the docs landing page into a runtime-oriented entry screen with quick-start paths and module navigation.
+- Raised the runtime coverage threshold to reflect the audited baseline.
+
+### Fixed
+
+- Packaging metadata and lockfile resolution for `codex-django[cli]`.
+- Online installation flow where a built `codex-django` wheel pulls `codex-django-cli` from the package registry.
+- Compatibility typing around the lazy CLI dispatch module.
+- Empty integration/e2e marker handling in the maintainer quality gate.
+- Async test environment resolution by restoring `arq` and `pytest-asyncio` in development extras.
+- Missing `unit` marker coverage for cabinet context processor tests.
+
+## [0.2.0] - Internal milestone
+
+### Added
+
+- Broader runtime modules for cabinet, showcase, booking, system, notifications, and core integrations.
+- Expanded unit coverage for runtime helpers and compatibility surfaces.
+
+### Changed
+
+- Reworked the runtime architecture around reusable adapters, mixins, selectors, and generated-project boundaries.
+- Evolved scaffold templates and docs in parallel with the runtime modules.
+
+## [0.1.5] - Internal milestone
+
+### Added
+
+- Cabinet/dashboard foundation with selectors, widgets, settings, and templates.
+- Showcase reference implementation with mock data, views, and demo flows.
+- Booking runtime adapters and selectors.
+
+### Changed
+
+- Extended project templates, feature blueprints, and deployment-oriented repository scaffolds.
+
+## [0.1.0] - Internal milestone
+
+### Added
+
+- Initial library scaffold for Django runtime utilities, mixins, adapters, and Codex-oriented project structure.

codex_django-0.2.5/CLAUDE.md

@@ -0,0 +1,133 @@
+# CLAUDE.md — codex-django
+
+> Читать в начале каждой сессии. Содержит ориентацию по проекту, памяти и ветках.
+
+---
+
+## Расположение проекта
+
+```
+C:\install\projects\codex_tools\codex-django\
+```
+
+Все codex-* библиотеки — соседи на одном уровне:
+```
+C:\install\projects\codex_tools\
+  codex-core\
+  codex-platform\
+  codex-services\
+  codex-django\      ← этот проект
+  codex-bot\
+```
+
+---
+
+## Файлы памяти (локальные)
+
+```
+C:\Users\prime\.claude\projects\C--install-projects-codex-tools-codex-django\memory\
+```
+
+| Файл | Содержимое |
+|------|-----------|
+| `MEMORY.md` | Мастер-индекс. Читать первым. |
+| `claude_context.md` | Стиль работы, частые ошибки, активные проекты |
+| `roadmap_overview.md` | 8 блоков доделки, порядок, статусы |
+| `roadmap_block1.md` | ✅ Git hygiene + стабы |
+| `roadmap_block2.md` | Тесты: booking + notifications |
+| `roadmap_block3.md` | Тесты: system + core |
+| `roadmap_block4.md` | Cabinet: widget adapter + client cabinet |
+| `roadmap_block5.md` | i18n валидация |
+| `roadmap_block6.md` | Booking: мульти-сервис |
+| `roadmap_block7.md` | Docs + PyPI alpha |
+| `roadmap_block8.md` | Deploy blueprints + Showcase |
+| `cabinet_index.md` | Архитектура кабинета |
+| `cabinet_css_js.md` | CSS/JS стек |
+| `cabinet_dashboard_architecture.md` | DashboardSelector, Redis, adapter pattern |
+| `project_ecosystem.md` | Экосистема codex-*, lily_website |
+| `project_test_conventions.md` | Уровни тестов, команды запуска |
+
+---
+
+## MCP граф памяти (полная версия)
+
+Сервер: `memory` (MCP)
+
+```python
+# Старт навигации всегда с:
+search_nodes("MASTER_INDEX")
+```
+
+### Ключевые ноды по проекту:
+
+| Нода | Тип | Содержит |
+|------|-----|---------|
+| `MASTER_INDEX` | Index | 7 секций (SEC:*) |
+| `SEC:Architecture` | IndexSection | Архитектурные решения |
+| `codex-django:architecture:project` | Architecture | Структура, ветки, пути |
+| `codex-django:architecture:cabinet` | Architecture | CabinetApp дизайн |
+| `codex-django:architecture:cli-blueprint` | Architecture | Blueprint система |
+| `codex-django:cabinet:index` | project-index | Кабинет: подход и принципы |
+| `codex-django:cabinet:css-js` | conventions | CSS/JS стек, компилер |
+| `Claude:Index` | PersonalNotes | Стиль работы, уроки |
+| `Graph:ConventionStandard` | Standard | Правила именования нод |
+
+---
+
+## Git ветки
+
+| Ветка | Назначение |
+|-------|-----------|
+| `main` | Стабильный релиз (PyPI) |
+| `develop` | Активная разработка — **все коммиты сюда** |
+
+> **Важно:** merge в `main` только перед релизом (Block 7 — PyPI alpha).
+> Сейчас работаем в `develop`. Не пушим (`git push` запрещён без явного запроса).
+
+---
+
+## Quality gate
+
+```bash
+# Полная проверка (интерактивный — спросит про integration тесты):
+python tools/dev/check.py --all
+
+# Только lint:
+python tools/dev/check.py --lint
+
+# Только типы:
+python tools/dev/check.py --types
+
+# Только тесты:
+python tools/dev/check.py --tests unit
+```
+
+**Текущий статус gate (после Block 1):**
+- Lint (ruff + bandit) ✅
+- Mypy ✅ (93 файла, 0 ошибок)
+- pip-audit ✅ (CVE-2026-4539 pygments — no fix, ignored)
+- Unit tests ✅ 153 passed, coverage ~35%
+
+---
+
+## Roadmap статус
+
+| # | Блок | Статус |
+|---|------|--------|
+| 1 | Git hygiene + стабы | ✅ |
+| 2 | Тесты: booking + notifications | ⬜ |
+| 3 | Тесты: system + core | ⬜ |
+| 4 | Cabinet: widget adapter | ⬜ |
+| 5 | i18n валидация | ⬜ |
+| 6 | Booking мульти-сервис | ⬜ |
+| 7 | Docs + PyPI | ⬜ |
+| 8 | Deploy + Showcase | ⬜ |
+
+---
+
+## Как стартовать новую сессию
+
+1. Прочитай этот файл
+2. Прочитай `memory/roadmap_overview.md`
+3. Прочитай нужный `memory/roadmap_blockN.md`
+4. По необходимости: `search_nodes("MASTER_INDEX")` для полного контекста