Add django example using DO backend and R2 (#101)

Author: ryanking13

README.md

@@ -37,6 +37,7 @@ Need to deploy your Worker to Cloudflare? Python Workers are in open beta and ha
 - [**`image-redraw/`**](image-redraw) — an example that combines [FastAPI](https://fastapi.tiangolo.com/), [R2](https://developers.cloudflare.com/r2/), [Queues](https://developers.cloudflare.com/queues/), [Workflows](https://developers.cloudflare.com/workflows/) and [Workers AI](https://developers.cloudflare.com/workers-ai/) to redraw uploaded images.
 - [**`django/`**](django) — runs a naive Django WSGI application directly on Python Workers.
 - [**`django-todo-d1/`**](django-todo-d1) — uses Django with D1 for a basic TODO application.
+- [**`django-markdown-r2/`**](django-markdown-r2) — a server-rendered Django blog using Durable Object SQLite and R2 for media storage.
 - [**`fastapi-todo/`**](fastapi-todo) — implements the [Todo-Backend](https://todobackend.com) spec with FastAPI (ASGI) and D1.
 - [**`flask-todo/`**](flask-todo) — implements the same [Todo-Backend](https://todobackend.com) API with [Flask](https://flask.palletsprojects.com/) (WSGI) and D1.
 

django-markdown-r2/README.md

@@ -0,0 +1,24 @@
+# Django Markdown Blog + Durable Objects + R2
+
+[![Deploy to Cloudflare](https://deploy.workers.cloudflare.com/button)](https://deploy.workers.cloudflare.com/?url=https://github.com/cloudflare/python-workers-examples/tree/main/django-markdown-r2)
+
+A blog built with Django on Cloudflare Python Workers, using Durable Objects for database storage and R2 for image storage.
+
+## Local setup
+
+Install [uv](https://docs.astral.sh/uv/getting-started/installation/#standalone-installer), then install the project dependencies and start the Worker:
+
+```sh
+uv sync
+uv run pywrangler dev
+```
+
+Open http://localhost:8787/. Wrangler provisions the configured Durable Object locally and simulates the `IMAGES` R2 binding.
+
+## Remote setup and deployment
+
+Create an R2 bucket, update the `IMAGES` bucket name in `wrangler.jsonc`, and deploy:
+
+```sh
+uv run pywrangler deploy
+```

django-markdown-r2/package.json

@@ -0,0 +1,13 @@
+{
+	"name": "django-markdown-r2-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"
+	}
+}

django-markdown-r2/pyproject.toml

@@ -0,0 +1,17 @@
+[project]
+name = "django-markdown-r2-worker"
+version = "0.1.0"
+description = "Server-rendered Django blog backed by Durable Object SQLite and R2"
+readme = "README.md"
+requires-python = ">=3.13"
+dependencies = [
+    "django",
+    "django-cf>=0.2.16",
+    "markdown-it-py==4.2.0",
+]
+
+[dependency-groups]
+dev = [
+    "workers-py",
+    "workers-runtime-sdk",
+]

django-markdown-r2/src/articles/__init__.py

@@ -0,0 +1,6 @@
+from django.apps import AppConfig
+
+
+class ArticlesConfig(AppConfig):
+    default_auto_field = "django.db.models.BigAutoField"
+    name = "articles"

django-markdown-r2/src/articles/apps.py

@@ -0,0 +1,21 @@
+from django import forms
+
+from .models import Article
+
+
+class ArticleForm(forms.ModelForm):
+    class Meta:
+        model = Article
+        fields = ["title", "body", "image"]
+        widgets = {
+            "body": forms.Textarea(attrs={"rows": 16}),
+            "image": forms.ClearableFileInput(
+                attrs={"accept": "image/gif,image/jpeg,image/png,image/webp"}
+            ),
+        }
+        help_texts = {"image": "PNG, JPEG, GIF, or WebP."}
+
+
+class ArticleEditForm(ArticleForm):
+    class Meta(ArticleForm.Meta):
+        fields = ["title", "body"]

django-markdown-r2/src/articles/forms.py

@@ -0,0 +1,39 @@
+import uuid
+
+from django.core.validators import FileExtensionValidator
+from django.db import models
+from django.utils.text import slugify
+
+
+def generate_article_id() -> str:
+    return str(uuid.uuid4())
+
+
+class Article(models.Model):
+    id = models.CharField(primary_key=True, max_length=36, default=generate_article_id)
+    title = models.CharField(max_length=200)
+    slug = models.SlugField(max_length=100, unique=True)
+    body = models.TextField(max_length=20_000)
+    image = models.FileField(
+        upload_to="articles",
+        blank=True,
+        validators=[FileExtensionValidator(["gif", "jpeg", "jpg", "png", "webp"])],
+    )
+    created_at = models.DateTimeField(auto_now_add=True)
+    updated_at = models.DateTimeField(auto_now=True)
+
+    class Meta:
+        db_table = "articles"
+        ordering = ["-created_at"]
+
+    def save(self, *args, **kwargs):
+        if not self.slug:
+            base = (slugify(self.title) or "article")[:100].rstrip("-")
+            candidate = base
+            suffix_number = 2
+            while type(self).objects.filter(slug=candidate).exists():
+                suffix = f"-{suffix_number}"
+                candidate = f"{base[: 100 - len(suffix)].rstrip('-')}{suffix}"
+                suffix_number += 1
+            self.slug = candidate
+        return super().save(*args, **kwargs)

django-markdown-r2/src/articles/models.py

@@ -0,0 +1,33 @@
+{% extends "articles/base.html" %}
+
+{% block title %}{{ article.title }} | Knowledge base{% endblock %}
+
+{% block content %}
+  <article aria-labelledby="article-title">
+    <header>
+      <hgroup>
+        <h1 id="article-title">{{ article.title }}</h1>
+        <p>
+          <small>
+            Published <time datetime="{{ created_iso }}">{{ created_date }}</time>
+            &middot; Updated <time datetime="{{ updated_iso }}">{{ updated_date }}</time>
+          </small>
+        </p>
+      </hgroup>
+      <nav aria-label="Article actions">
+        <ul>
+          <li><a href="{% url 'article-list' %}">Back to articles</a></li>
+          <li><a href="{% url 'article-edit' slug=article.slug %}">Edit article</a></li>
+        </ul>
+      </nav>
+    </header>
+    {% if article.image %}
+      <figure>
+        <img src="{{ article.image.url }}" alt="Illustration for {{ article.title }}">
+      </figure>
+    {% endif %}
+    <section aria-label="Article content">
+      {{ rendered_body }}
+    </section>
+  </article>
+{% endblock %}

django-markdown-r2/src/articles/templates/articles/article_detail.html

@@ -0,0 +1,44 @@
+{% extends "articles/base.html" %}
+
+{% block title %}{% if is_edit %}Edit {{ article.title }}{% else %}New article{% endif %} | Knowledge base{% endblock %}
+
+{% block content %}
+  <section aria-labelledby="article-form-heading">
+    <header>
+      <h1 id="article-form-heading">{% if is_edit %}Edit article{% else %}New article{% endif %}</h1>
+      <p>{% if is_edit %}Refine this entry and save the updated reference for readers.{% else %}Add a clear, useful entry to the knowledge base.{% endif %}</p>
+    </header>
+    <form method="post"{% if not is_edit %} enctype="multipart/form-data"{% endif %}>
+      {% csrf_token %}
+      {% if form.non_field_errors %}
+        <div role="alert">
+          {{ form.non_field_errors }}
+        </div>
+      {% endif %}
+      <fieldset>
+        <legend>Article details</legend>
+        {% for field in form %}
+          {% if field.is_hidden %}
+            {{ field }}
+            {% if field.errors %}
+              <div role="alert">{{ field.errors }}</div>
+            {% endif %}
+          {% else %}
+            <label for="{{ field.id_for_label }}">{{ field.label }}</label>
+            {{ field }}
+            {% if field.help_text %}
+              <small>{{ field.help_text }}</small>
+            {% endif %}
+            {% if field.errors %}
+              <div role="alert">{{ field.errors }}</div>
+            {% endif %}
+          {% endif %}
+        {% endfor %}
+      </fieldset>
+      <footer>
+        <button type="submit">{% if is_edit %}Save changes{% else %}Create article{% endif %}</button>
+        <a href="{% if is_edit %}{% url 'article-detail' slug=article.slug %}{% else %}{% url 'article-list' %}{% endif %}">Cancel</a>
+      </footer>
+    </form>
+  </section>
+{% endblock %}