This content was loaded via HTMX!
```
### Step 7: Testing Infrastructure
**pytest.ini**:
```ini
[pytest]
DJANGO_SETTINGS_MODULE = config.settings.dev
python_files = tests.py test_*.py *_tests.py
addopts = --reuse-db --cov=apps --cov-report=html --cov-report=term
testpaths = apps
```
**conftest.py** (with type annotations):
```python
"""Pytest configuration and fixtures."""
import pytest
from pytest_factoryboy import register
from rest_framework.test import APIClient
from apps.core.factories import UserFactory
from apps.core.models import User
# Register factories
register(UserFactory)
@pytest.fixture
def api_client() -> APIClient:
"""DRF API client."""
return APIClient()
@pytest.fixture
def authenticated_client(api_client: APIClient, user: User) -> APIClient:
"""Authenticated API client."""
api_client.force_authenticate(user=user)
return api_client
```
**apps/core/factories.py** (with type annotations):
```python
"""Factory Boy factories for core models."""
from typing import Any
import factory
from factory.django import DjangoModelFactory
from .models import User
class UserFactory(DjangoModelFactory):
"""Factory for User model."""
class Meta:
model = User
email: factory.Faker = factory.Faker('email')
username: factory.Faker = factory.Faker('user_name')
is_active: bool = True
is_staff: bool = False
is_superuser: bool = False
@factory.post_generation
def password(
self,
create: bool,
extracted: str | None,
**kwargs: Any
) -> None:
"""Set user password after generation."""
if not create:
return
password = extracted or 'testpass123'
self.set_password(password)
self.save()
```
**apps/core/tests/test_models.py** (with type annotations):
```python
"""Tests for core models."""
from typing import Any
from uuid import UUID
import pytest
from apps.core.models import User
@pytest.mark.django_db
class TestUserModel:
"""Tests for User model."""
def test_user_creation(self, user_factory: Any) -> None:
"""Test creating a user."""
user: User = user_factory()
assert user.id is not None
assert user.email
assert user.username
def test_user_str(self, user_factory: Any) -> None:
"""Test user string representation."""
user: User = user_factory(email="test@example.com")
assert str(user) == "test@example.com"
def test_user_uuid_primary_key(self, user_factory: Any) -> None:
"""Test user has UUID primary key."""
user: User = user_factory()
assert isinstance(user.id, UUID)
```
### Step 8: Type Checking & Linting
Add to **pyproject.toml** (with strict typing enabled):
```toml
[tool.mypy]
plugins = ["mypy_django_plugin.main"]
python_version = "3.12"
warn_return_any = true
warn_unused_configs = true
disallow_untyped_defs = true # Strict: all functions must have type annotations
warn_redundant_casts = true
warn_unused_ignores = true
strict_equality = true
check_untyped_defs = true
exclude = [
"migrations/",
"venv/",
".venv/",
]
[[tool.mypy.overrides]]
module = [
"factory.*",
"environ.*",
"oauth2_provider.*",
"rest_framework.*",
]
ignore_missing_imports = true
[tool.django-stubs]
django_settings_module = "config.settings.dev"
[tool.ruff]
line-length = 100
target-version = "py312"
exclude = [
"migrations",
".venv",
"venv",
]
[tool.ruff.lint]
select = ["E", "F", "I", "N", "W", "UP"]
ignore = ["E501"]
[tool.ruff.lint.per-file-ignores]
"__init__.py" = ["F401"]
"*/migrations/*" = ["E501", "N806"]
"*/tests/*" = ["F401", "F811"]
"*/admin.py" = ["F401"]
"*/models.py" = ["F401"]
"*/views.py" = ["F401"]
[tool.pytest.ini_options]
DJANGO_SETTINGS_MODULE = "config.settings.dev"
python_files = ["tests.py", "test_*.py", "*_tests.py"]
addopts = "--reuse-db --cov=apps --cov-report=html --cov-report=term"
testpaths = ["apps"]
```
**Note**: `disallow_untyped_defs = true` enforces that all functions and methods must have type annotations. This is intentional to ensure maximum compatibility with AI coding assistants.
### Step 9: Update URLs
**config/urls.py**:
```python
"""URL configuration."""
from django.contrib import admin
from django.urls import path, include
urlpatterns = [
path('admin/', admin.site.urls),
path('oauth/', include('oauth2_provider.urls', namespace='oauth2_provider')),
path('api-auth/', include('rest_framework.urls')),
]
```
### Step 10: Create .gitignore
```gitignore
# Python
__pycache__/
*.py[cod]
*$py.class
*.so
.Python
build/
develop-eggs/
dist/
downloads/
eggs/
.eggs/
lib/
lib64/
parts/
sdist/
var/
wheels/
*.egg-info/
.installed.cfg
*.egg
# Virtual environments
.venv/
venv/
ENV/
env/
# Django
*.log
db.sqlite3
db.sqlite3-journal
/static/
/staticfiles/
/media/
# Environment variables
.env
.envrc.local
# Testing
.pytest_cache/
.coverage
htmlcov/
.tox/
# IDEs
.vscode/
.idea/
*.swp
*.swo
*~
# OS
.DS_Store
Thumbs.db
# Docker
postgres_data/
```
### Step 11: Create CLAUDE.md
See template in `templates/CLAUDE.md.template`.
### Step 12: Install Dependencies
```bash
# Core dependencies
uv add django psycopg[binary] django-environ
# Third-party apps
uv add djangorestframework django-oauth-toolkit django-htmx pydantic
# Development tools
uv add --group dev pytest pytest-django pytest-cov pytest-asyncio
uv add --group dev factory-boy pytest-factoryboy
uv add --group dev mypy django-stubs types-requests
uv add --group dev ruff
uv add --group dev django-extensions ipython
```
### Step 13: Run Initial Migrations
```bash
# Create migrations for core app
uv run python manage.py makemigrations core
# Run migrations
uv run python manage.py migrate
# Create superuser
export DJANGO_SUPERUSER_PASSWORD=admin
uv run python manage.py createsuperuser --noinput --username admin --email admin@example.com
```
## Verification Steps
After setup, verify:
1. ✅ **Project Structure**: Correct `config/` and `apps/` layout
2. ✅ **Environment**: `direnv allow` succeeds
3. ✅ **Database**:
- **Docker**: Container running (`docker ps` shows postgres)
- **Supabase**: DATABASE_URL configured in `.env.local`
4. ✅ **Migrations**: Applied successfully (or Supabase setup instructions provided)
5. ✅ **Superuser**: Created and can log in to admin
6. ✅ **Dev Server**: `uv run python manage.py runserver` starts
7. ✅ **Admin**: http://localhost:8000/admin/ accessible
8. ✅ **Tests**: `uv run pytest` passes
9. ✅ **Type Check**: `uv run mypy .` passes with strict mode (`disallow_untyped_defs = true`)
10. ✅ **Linting**: `uv run ruff check .` passes
11. ✅ **HTMX**: Basic view works
12. ✅ **OAuth**: `/oauth/` endpoint accessible
13. ✅ **AI Tooling**: All generated files have comprehensive type annotations
## Related Skills
- `/python-experts:django-dev` - Django development patterns
- `/python-experts:django-api` - API development with DRF
- `/devops-data:direnv` - Environment management
- `/git-workflow:commit` - Commit the initial project
## References
- [Django 6.0 Documentation](https://docs.djangoproject.com/en/6.0/)
- [uv Package Manager](https://github.com/astral-sh/uv)
- [uv Python Version Management](https://docs.astral.sh/uv/concepts/python-versions/)
- [Supabase Database](https://supabase.com/docs/guides/database)
- [django-htmx](https://django-htmx.readthedocs.io/)
- [django-oauth-toolkit](https://django-oauth-toolkit.readthedocs.io/)
- [Django REST Framework](https://www.django-rest-framework.org/)
- [Factory Boy](https://factoryboy.readthedocs.io/)
- [pytest-django](https://pytest-django.readthedocs.io/)