Add examples using django (#92)

* Add examples using django

* Update 18-django/pyproject.toml

Co-authored-by: Dominik Picheta <dominik@cloudflare.com>

* chore: update readme

---------

Co-authored-by: Dominik Picheta <dominik@cloudflare.com>

Author: ryanking13

18-django/README.md

@@ -0,0 +1,34 @@
+# Django WSGI Example
+
+[![Deploy to Cloudflare](https://deploy.workers.cloudflare.com/button)](https://deploy.workers.cloudflare.com/?url=https://github.com/cloudflare/python-workers-examples/tree/main/18-django)
+
+This example runs a small, conventional Django project directly on Cloudflare Workers using Django's WSGI application.
+
+## How to Run
+
+First ensure that `uv` is installed:
+https://docs.astral.sh/uv/getting-started/installation/#standalone-installer
+
+Run:
+
+```sh
+uv run pywrangler dev
+```
+
+Then try:
+
+```sh
+curl http://localhost:8787/
+```
+
+You should receive:
+
+```json
+{"message": "Hello from Django on Cloudflare Workers!"}
+```
+
+You can also deploy with:
+
+```sh
+uv run pywrangler deploy
+```

18-django/package.json

@@ -0,0 +1,13 @@
+{
+	"name": "django-worker",
+	"version": "0.0.0",
+	"private": true,
+	"scripts": {
+		"deploy": "uv run pywrangler deploy",
+		"dev": "uv run pywrangler dev",
+		"start": "uv run pywrangler dev"
+	},
+	"devDependencies": {
+		"wrangler": "^4.114.0"
+	}
+}

18-django/pyproject.toml

@@ -0,0 +1,15 @@
+[project]
+name = "django-worker"
+version = "0.1.0"
+description = "Simple Django example for Python Workers"
+readme = "README.md"
+requires-python = ">=3.13"
+dependencies = [
+    "django",
+]
+
+[dependency-groups]
+dev = [
+    "workers-py",
+    "workers-runtime-sdk",
+]

18-django/src/entry.py

@@ -0,0 +1,12 @@
+import os
+
+from workers import WorkerEntrypoint, wsgi
+
+os.environ.setdefault("DJANGO_SETTINGS_MODULE", "hello_django.settings")
+
+from hello_django.wsgi import application
+
+
+class Default(WorkerEntrypoint):
+    async def fetch(self, request):
+        return await wsgi.fetch(application, request, self.env)

18-django/src/hello_django/__init__.py

@@ -0,0 +1,8 @@
+SECRET_KEY = "django-insecure-development-placeholder"
+DEBUG = False
+ALLOWED_HOSTS = ["*"]
+ROOT_URLCONF = "hello_django.urls"
+MIDDLEWARE = []
+INSTALLED_APPS = []
+WSGI_APPLICATION = "hello_django.wsgi.application"
+DEFAULT_AUTO_FIELD = "django.db.models.BigAutoField"

18-django/src/hello_django/settings.py

@@ -0,0 +1,11 @@
+from django.http import JsonResponse
+from django.urls import path
+
+
+def root(_request):
+    return JsonResponse({"message": "Hello from Django on Cloudflare Workers!"})
+
+
+urlpatterns = [
+    path("", root),
+]

18-django/src/hello_django/urls.py

@@ -0,0 +1,7 @@
+import os
+
+from django.core.wsgi import get_wsgi_application
+
+os.environ.setdefault("DJANGO_SETTINGS_MODULE", "hello_django.settings")
+
+application = get_wsgi_application()

18-django/src/hello_django/wsgi.py

@@ -0,0 +1,12 @@
+{
+	"$schema": "node_modules/wrangler/config-schema.json",
+	"name": "django-worker",
+	"main": "src/entry.py",
+	"compatibility_date": "2026-07-29",
+	"compatibility_flags": [
+		"python_workers"
+	],
+	"observability": {
+		"enabled": true
+	}
+}

18-django/wrangler.jsonc

@@ -0,0 +1,50 @@
+# Django TODO + D1 Example
+
+[![Deploy to Cloudflare](https://deploy.workers.cloudflare.com/button)](https://deploy.workers.cloudflare.com/?url=https://github.com/cloudflare/python-workers-examples/tree/main/19-django-todo-d1)
+
+This example uses Django with [django-cf](https://pypi.org/project/django-cf/) and a D1 database to serve a small TODO API under `/api/*`, plus a static frontend from `public/` served by [Workers Static Assets](https://developers.cloudflare.com/workers/static-assets/).
+
+## How to Run
+
+First ensure that `uv` is installed:
+https://docs.astral.sh/uv/getting-started/installation/#standalone-installer
+
+Apply local migrations before development:
+
+```sh
+uv run pywrangler d1 migrations apply django-todo-d1 --local
+```
+
+Start the development server:
+
+```sh
+uv run pywrangler dev
+```
+
+Then open http://localhost:8787/ in your browser.
+
+## How to deploy
+
+Replace the `database_id` in `wrangler.jsonc` with your actual D1 database UUID.
+
+Then run
+
+```sh
+uv run pywrangler deploy
+```
+
+
+## Endpoints
+
+| Endpoint | Description |
+|---|---|
+| `GET /api/health/` | Health check |
+| `GET /api/todos/` | List TODOs, newest first |
+| `POST /api/todos/` | Create a TODO |
+| `GET /api/todos/<id>/` | Fetch one TODO |
+| `PATCH /api/todos/<id>/` | Partially update `title` and/or `completed` |
+| `DELETE /api/todos/<id>/` | Delete a TODO |
+
+## Notes
+
+- Schema changes are managed by hand-written Wrangler D1 SQL migrations, not Django `manage.py migrate`.