sandwitches 0.1.0__tar.gz

sandwitches-0.1.0/PKG-INFO

@@ -0,0 +1,21 @@
+Metadata-Version: 2.3
+Name: sandwitches
+Version: 0.1.0
+Summary: Add your description here
+Author: Martyn van Dijke
+Author-email: Martyn van Dijke <martijnvdijke600@gmail.com>
+Requires-Dist: django-debug-toolbar>=6.1.0
+Requires-Dist: django-filter>=25.2
+Requires-Dist: django-simple-history>=3.10.1
+Requires-Dist: django>=5.2.7
+Requires-Dist: djangorestframework>=3.16.1
+Requires-Dist: gunicorn>=23.0.0
+Requires-Dist: markdown>=3.10
+Requires-Dist: pillow>=12.0.0
+Requires-Dist: uwsgi>=2.0.31
+Requires-Python: >=3.12
+Description-Content-Type: text/markdown
+
+# broodjes.vandijke.xyz
+
+Website files for broodjes.vandijke.xyz

sandwitches-0.1.0/README.md

@@ -0,0 +1,3 @@
+# broodjes.vandijke.xyz
+
+Website files for broodjes.vandijke.xyz

sandwitches-0.1.0/pyproject.toml

@@ -0,0 +1,42 @@
+[project]
+name = "sandwitches"
+version = "0.1.0"
+description = "Add your description here"
+readme = "README.md"
+authors = [
+    { name = "Martyn van Dijke", email = "martijnvdijke600@gmail.com" }
+]
+
+requires-python = ">=3.12"
+
+dependencies = [
+    "django-debug-toolbar>=6.1.0",
+    "django-filter>=25.2",
+    "django-simple-history>=3.10.1",
+    "django>=5.2.7",
+    "djangorestframework>=3.16.1",
+    "gunicorn>=23.0.0",
+    "markdown>=3.10",
+    "pillow>=12.0.0",
+    "uwsgi>=2.0.31",
+]
+
+
+[build-system]
+requires = ["uv_build>=0.8.19,<0.9.0"]
+build-backend = "uv_build"
+
+[dependency-groups]
+dev = [
+    "invoke>=2.2.1",
+    "pytest-django>=4.11.1",
+    "pytest>=8.4.2",
+    "ruff>=0.14.3",
+    "ty>=0.0.1a26",
+]
+
+[tool.uv]
+package = true
+
+[tool.pytest.ini_options]
+DJANGO_SETTINGS_MODULE = "sandwitches.settings"

sandwitches-0.1.0/src/sandwitches/admin.py

@@ -0,0 +1,6 @@
+from django.contrib import admin
+from .models import Recipe, Tag
+
+
+admin.site.register(Recipe)
+admin.site.register(Tag)

sandwitches-0.1.0/src/sandwitches/asgi.py

@@ -0,0 +1,16 @@
+"""
+ASGI config for sandwitches project.
+
+It exposes the ASGI callable as a module-level variable named ``application``.
+
+For more information on this file, see
+https://docs.djangoproject.com/en/5.2/howto/deployment/asgi/
+"""
+
+import os
+
+from django.core.asgi import get_asgi_application
+
+os.environ.setdefault("DJANGO_SETTINGS_MODULE", "sandwitches.settings")
+
+application = get_asgi_application()

sandwitches-0.1.0/src/sandwitches/forms.py

@@ -0,0 +1,60 @@
+from django import forms
+from django.contrib.auth import get_user_model
+from .models import Recipe
+
+User = get_user_model()
+
+
+class AdminSetupForm(forms.Form):
+    username = forms.CharField(max_length=150, label="Username")
+    email = forms.EmailField(required=False, label="Email (optional)")
+    password1 = forms.CharField(label="Password", widget=forms.PasswordInput)
+    password2 = forms.CharField(label="Confirm password", widget=forms.PasswordInput)
+    first_name = forms.CharField(max_length=30, required=False, label="First name")
+    last_name = forms.CharField(max_length=150, required=False, label="Last name")
+
+    def clean_username(self):
+        username = self.cleaned_data.get("username")
+        if User.objects.filter(username=username).exists():
+            raise forms.ValidationError("A user with that username already exists.")
+        return username
+
+    def clean(self):
+        cleaned = super().clean()
+        p1 = cleaned.get("password1")
+        p2 = cleaned.get("password2")
+        if p1 and p2 and p1 != p2:
+            raise forms.ValidationError("Passwords do not match.")
+        return cleaned
+
+    def save(self):
+        data = self.cleaned_data
+        user = User.objects.create_superuser(
+            username=data["username"],
+            email=data.get("email") or "",
+            password=data["password1"],
+        )
+        # set optional names
+        if data.get("first_name"):
+            user.first_name = data["first_name"]
+        if data.get("last_name"):
+            user.last_name = data["last_name"]
+        user.is_staff = True
+        user.save()
+        return user
+
+
+class RecipeForm(forms.ModelForm):
+    class Meta:
+        model = Recipe
+        fields = [
+            "title",
+            "description",
+            "ingredients",
+            "instructions",
+            "image",
+            "tags",
+        ]
+        widgets = {
+            "tags": forms.TextInput(attrs={"placeholder": "tag1,tag2"}),
+        }

sandwitches-0.1.0/src/sandwitches/migrations/0001_initial.py

@@ -0,0 +1,75 @@
+# Generated by Django 5.2.8 on 2025-11-05 19:15
+
+import sandwitches.storage
+from django.db import migrations, models
+
+
+class Migration(migrations.Migration):
+    initial = True
+
+    dependencies = []
+
+    operations = [
+        migrations.CreateModel(
+            name="Tag",
+            fields=[
+                (
+                    "id",
+                    models.BigAutoField(
+                        auto_created=True,
+                        primary_key=True,
+                        serialize=False,
+                        verbose_name="ID",
+                    ),
+                ),
+                ("name", models.CharField(max_length=50, unique=True)),
+                ("slug", models.SlugField(blank=True, max_length=60, unique=True)),
+            ],
+            options={
+                "verbose_name": "Tag",
+                "verbose_name_plural": "Tags",
+                "ordering": ("name",),
+            },
+        ),
+        migrations.CreateModel(
+            name="Recipe",
+            fields=[
+                (
+                    "id",
+                    models.BigAutoField(
+                        auto_created=True,
+                        primary_key=True,
+                        serialize=False,
+                        verbose_name="ID",
+                    ),
+                ),
+                ("title", models.CharField(max_length=255, unique=True)),
+                ("slug", models.SlugField(blank=True, max_length=255, unique=True)),
+                ("description", models.TextField(blank=True)),
+                ("ingredients", models.TextField(blank=True)),
+                ("instructions", models.TextField(blank=True)),
+                (
+                    "image",
+                    models.ImageField(
+                        blank=True,
+                        null=True,
+                        storage=sandwitches.storage.HashedFilenameStorage(),
+                        upload_to="recipes/",
+                    ),
+                ),
+                ("created_at", models.DateTimeField(auto_now_add=True)),
+                ("updated_at", models.DateTimeField(auto_now=True)),
+                (
+                    "tags",
+                    models.ManyToManyField(
+                        blank=True, related_name="recipes", to="sandwitches.tag"
+                    ),
+                ),
+            ],
+            options={
+                "verbose_name": "Recipe",
+                "verbose_name_plural": "Recipes",
+                "ordering": ("-created_at",),
+            },
+        ),
+    ]

sandwitches-0.1.0/src/sandwitches/migrations/0002_historicalrecipe.py

@@ -0,0 +1,61 @@
+# Generated by Django 5.2.8 on 2025-11-10 18:55
+
+import django.db.models.deletion
+import simple_history.models
+from django.conf import settings
+from django.db import migrations, models
+
+
+class Migration(migrations.Migration):
+    dependencies = [
+        ("sandwitches", "0001_initial"),
+        migrations.swappable_dependency(settings.AUTH_USER_MODEL),
+    ]
+
+    operations = [
+        migrations.CreateModel(
+            name="HistoricalRecipe",
+            fields=[
+                (
+                    "id",
+                    models.BigIntegerField(
+                        auto_created=True, blank=True, db_index=True, verbose_name="ID"
+                    ),
+                ),
+                ("title", models.CharField(db_index=True, max_length=255)),
+                ("slug", models.SlugField(blank=True, max_length=255)),
+                ("description", models.TextField(blank=True)),
+                ("ingredients", models.TextField(blank=True)),
+                ("instructions", models.TextField(blank=True)),
+                ("image", models.TextField(blank=True, max_length=100, null=True)),
+                ("created_at", models.DateTimeField(blank=True, editable=False)),
+                ("updated_at", models.DateTimeField(blank=True, editable=False)),
+                ("history_id", models.AutoField(primary_key=True, serialize=False)),
+                ("history_date", models.DateTimeField(db_index=True)),
+                ("history_change_reason", models.CharField(max_length=100, null=True)),
+                (
+                    "history_type",
+                    models.CharField(
+                        choices=[("+", "Created"), ("~", "Changed"), ("-", "Deleted")],
+                        max_length=1,
+                    ),
+                ),
+                (
+                    "history_user",
+                    models.ForeignKey(
+                        null=True,
+                        on_delete=django.db.models.deletion.SET_NULL,
+                        related_name="+",
+                        to=settings.AUTH_USER_MODEL,
+                    ),
+                ),
+            ],
+            options={
+                "verbose_name": "historical Recipe",
+                "verbose_name_plural": "historical Recipes",
+                "ordering": ("-history_date", "-history_id"),
+                "get_latest_by": ("history_date", "history_id"),
+            },
+            bases=(simple_history.models.HistoricalChanges, models.Model),
+        ),
+    ]

sandwitches-0.1.0/src/sandwitches/models.py

@@ -0,0 +1,94 @@
+from django.db import models
+from django.urls import reverse
+from django.utils.text import slugify
+from .storage import HashedFilenameStorage
+from simple_history.models import HistoricalRecords
+
+hashed_storage = HashedFilenameStorage()
+
+
+class Tag(models.Model):
+    name = models.CharField(max_length=50, unique=True)
+    slug = models.SlugField(max_length=60, unique=True, blank=True)
+
+    class Meta:
+        ordering = ("name",)
+        verbose_name = "Tag"
+        verbose_name_plural = "Tags"
+
+    def save(self, *args, **kwargs):
+        if not self.slug:
+            base = slugify(self.name)[:55]
+            slug = base
+            n = 1
+            while Tag.objects.filter(slug=slug).exclude(pk=self.pk).exists():
+                slug = f"{base}-{n}"
+                n += 1
+            self.slug = slug
+        super().save(*args, **kwargs)
+
+    def __str__(self):
+        return self.name
+
+
+class Recipe(models.Model):
+    title = models.CharField(max_length=255, unique=True)
+    slug = models.SlugField(max_length=255, unique=True, blank=True)
+    description = models.TextField(blank=True)
+    ingredients = models.TextField(blank=True)
+    instructions = models.TextField(blank=True)
+    image = models.ImageField(
+        upload_to="recipes/",  # storage will replace with hashed path
+        storage=hashed_storage,
+        blank=True,
+        null=True,
+    )
+
+    # ManyToMany: tags are reusable and shared between recipes
+    tags = models.ManyToManyField(Tag, blank=True, related_name="recipes")
+
+    created_at = models.DateTimeField(auto_now_add=True)
+    updated_at = models.DateTimeField(auto_now=True)
+    history = HistoricalRecords()
+
+    class Meta:
+        ordering = ("-created_at",)
+        verbose_name = "Recipe"
+        verbose_name_plural = "Recipes"
+
+    def save(self, *args, **kwargs):
+        if not self.slug:
+            base = slugify(self.title)[:240]
+            slug = base
+            n = 1
+            while Recipe.objects.filter(slug=slug).exclude(pk=self.pk).exists():
+                slug = f"{base}-{n}"
+                n += 1
+            self.slug = slug
+        super().save(*args, **kwargs)
+
+    def tag_list(self):
+        # returns list of tag names
+        return list(self.tags.values_list("name", flat=True))
+
+    def set_tags_from_string(self, tag_string):
+        """
+        Accepts a comma separated string like "tag1, tag2" and attaches existing tags
+        or creates new ones as needed. Returns the Tag queryset assigned.
+        """
+        names = [t.strip() for t in (tag_string or "").split(",") if t.strip()]
+        tags = []
+        for name in names:
+            tag = Tag.objects.filter(name__iexact=name).first()
+            if not tag:
+                tag = Tag.objects.create(name=name)
+            tags.append(tag)
+        # replace existing tags with these
+        self.tags.set(tags)
+        return self.tags.all()
+
+    def get_absolute_url(self):
+        return reverse("recipe_detail", kwargs={"pk": self.pk, "slug": self.slug})
+
+    def __str__(self):
+        return self.title

sandwitches-0.1.0/src/sandwitches/settings.py

@@ -0,0 +1,134 @@
+"""
+Django settings for sandwitches project.
+
+Generated by 'django-admin startproject' using Django 5.2.7.
+
+For more information on this file, see
+https://docs.djangoproject.com/en/5.2/topics/settings/
+
+For the full list of settings and their values, see
+https://docs.djangoproject.com/en/5.2/ref/settings/
+"""
+
+from pathlib import Path
+import os
+
+
+SECRET_KEY = os.environ.get("SECRET_KEY")
+DEBUG = bool(os.environ.get("DEBUG", default=0))
+ALLOWED_HOSTS = os.environ.get("ALLOWED_HOSTS", "127.0.0.1").split(",")
+CSRF_TRUSTED_ORIGINS = os.environ.get("CSRF_TRUSTED_ORIGINS", "").split(",")
+
+# Build paths inside the project like this: BASE_DIR / 'subdir'.
+BASE_DIR = Path(__file__).resolve().parent.parent
+
+# Application definition
+
+INSTALLED_APPS = [
+    "django.contrib.admin",
+    "django.contrib.auth",
+    "django.contrib.contenttypes",
+    "django.contrib.sessions",
+    "django.contrib.messages",
+    "django.contrib.staticfiles",
+    "sandwitches",
+    "debug_toolbar",
+    "simple_history",
+]
+
+MIDDLEWARE = [
+    "django.middleware.security.SecurityMiddleware",
+    "django.contrib.sessions.middleware.SessionMiddleware",
+    "django.middleware.common.CommonMiddleware",
+    "django.middleware.csrf.CsrfViewMiddleware",
+    "django.contrib.auth.middleware.AuthenticationMiddleware",
+    "django.contrib.messages.middleware.MessageMiddleware",
+    "django.middleware.clickjacking.XFrameOptionsMiddleware",
+    "debug_toolbar.middleware.DebugToolbarMiddleware",
+    "simple_history.middleware.HistoryRequestMiddleware",
+]
+
+ROOT_URLCONF = "sandwitches.urls"
+
+TEMPLATES = [
+    {
+        "BACKEND": "django.template.backends.django.DjangoTemplates",
+        "DIRS": [],
+        "APP_DIRS": True,
+        "OPTIONS": {
+            "context_processors": [
+                "django.template.context_processors.request",
+                "django.contrib.auth.context_processors.auth",
+                "django.contrib.messages.context_processors.messages",
+                "django.template.context_processors.csrf",
+            ],
+        },
+    },
+]
+
+WSGI_APPLICATION = "sandwitches.wsgi.application"
+
+
+# Database
+# https://docs.djangoproject.com/en/5.2/ref/settings/#databases
+
+DATABASES = {
+    "default": {
+        "ENGINE": "django.db.backends.sqlite3",
+        "NAME": Path("/config/db.sqlite3"),
+    }
+}
+
+
+# Password validation
+# https://docs.djangoproject.com/en/5.2/ref/settings/#auth-password-validators
+
+AUTH_PASSWORD_VALIDATORS = [
+    {
+        "NAME": "django.contrib.auth.password_validation.UserAttributeSimilarityValidator",
+    },
+    {
+        "NAME": "django.contrib.auth.password_validation.MinimumLengthValidator",
+    },
+    {
+        "NAME": "django.contrib.auth.password_validation.CommonPasswordValidator",
+    },
+    {
+        "NAME": "django.contrib.auth.password_validation.NumericPasswordValidator",
+    },
+]
+
+
+# Media files (for uploaded images)
+MEDIA_URL = "/media/"
+MEDIA_ROOT = Path("/config/media")
+
+# Static (for CSS etc)
+STATIC_URL = "/static/"
+STATIC_ROOT = Path("/config/staticfiles")
+
+# Internationalization
+# https://docs.djangoproject.com/en/5.2/topics/i18n/
+
+LANGUAGE_CODE = "en-us"
+
+TIME_ZONE = "UTC"
+
+USE_I18N = True
+
+USE_TZ = True
+
+INTERNAL_IPS = [
+    "127.0.0.1",
+]
+
+
+# Static files (CSS, JavaScript, Images)
+# https://docs.djangoproject.com/en/5.2/howto/static-files/
+
+STATIC_URL = "static/"
+
+# Default primary key field type
+# https://docs.djangoproject.com/en/5.2/ref/settings/#default-auto-field
+
+DEFAULT_AUTO_FIELD = "django.db.models.BigAutoField"

sandwitches-0.1.0/src/sandwitches/storage.py

@@ -0,0 +1,29 @@
+import hashlib
+import os
+from django.core.files.base import ContentFile
+from django.core.files.storage import FileSystemStorage
+
+
+class HashedFilenameStorage(FileSystemStorage):
+    """
+    Save uploaded files under a hash of their contents + original extension.
+    Example output: media/recipes/3f8a9d...png
+    """
+
+    def _save(self, name, content):
+        # ensure we read bytes
+        try:
+            content.seek(0)
+        except Exception:
+            pass
+
+        data = content.read()
+        # compute hash (use first 32 hex chars to keep names shorter)
+        h = hashlib.sha256(data).hexdigest()[:32]
+        ext = os.path.splitext(name)[1].lower() or ""
+        # store all recipe images under recipes/
+        name = f"recipes/{h}{ext}"
+
+        # wrap bytes into a ContentFile so Django storage works consistently
+        content = ContentFile(data)
+        return super()._save(name, content)

sandwitches-0.1.0/src/sandwitches/templates/base.html

@@ -0,0 +1,14 @@
+<!DOCTYPE html>
+<html lang="en">
+  <head>
+    <meta charset="utf-8" />
+    <meta name="viewport" content="width=device-width,initial-scale=1.0" />
+    <title>{% block title %}Sandwitches{% endblock %}</title>
+    {% block extra_head %}{% endblock %}
+  </head>
+  <body class="{% block body_class %}{% endblock %}">
+    {% block navbar %}{% endblock %}
+    <main class="container" role="main">{% block content %}{% endblock %}</main>
+    {% block extra_scripts %}{% endblock %}
+  </body>
+</html>

sandwitches-0.1.0/src/sandwitches/templates/base_pico.html

@@ -0,0 +1,244 @@
+{% extends "base.html" %} {% block extra_head %}
+<!-- Pico.css (CDN) -->
+<link
+  rel="stylesheet"
+  href="https://unpkg.com/@picocss/pico@1.*/css/pico.min.css"
+/>
+<style>
+  :root {
+    --card-radius: 12px;
+    --card-shadow-sm: 0 6px 18px rgba(15, 23, 42, 0.06);
+    --card-shadow-lg: 0 18px 40px rgba(15, 23, 42, 0.12);
+    --accent: #ff7a18;
+  }
+
+  /* responsive grid for cards */
+  section.grid {
+    display: grid;
+    gap: 1.25rem;
+    grid-template-columns: repeat(auto-fit, minmax(260px, 1fr));
+    align-items: start;
+  }
+
+  /* unified card */
+  article.card {
+    background: var(--pico-card-background);
+    border-radius: var(--card-radius);
+    overflow: hidden;
+    padding: 0.12rem 0.45rem;
+    box-shadow: var(--card-shadow-sm);
+    transition: transform 0.18s ease, box-shadow 0.18s ease;
+    display: flex;
+    flex-direction: column;
+    border: 1px solid rgba(0, 0, 0, 0.04);
+  }
+  article.card:hover {
+    transform: translateY(-8px);
+    box-shadow: var(--card-shadow-lg);
+  }
+
+  /* image area on top */
+  .recipe-figure {
+    width: 100%;
+    display: block;
+    position: relative;
+    background: #f6f6f6;
+    flex: 0 0 auto;
+  }
+  .recipe-figure img {
+    width: 100%;
+    height: auto;
+    object-fit: cover;
+    display: block;
+  }
+
+  /* card body below image */
+  .card-body {
+    padding: 0.05rem 0.05rem;
+    display: flex;
+    flex-direction: column;
+    gap: 0.4rem;
+    min-height: 64px;
+    flex: 1 1 auto;
+  }
+
+  .card-title,
+  article header {
+    margin: 0;
+    font-size: 1.02rem;
+    line-height: 1.2;
+    font-weight: 600;
+    color: inherit;
+    word-break: break-word;
+  }
+
+  /* compact chips */
+  .chip,
+  .tag {
+    display: inline-block;
+    padding: 0.12rem 0.45rem;
+    margin: 0 0.35rem 0.35rem 0;
+    border-radius: 999px;
+    font-size: 0.78rem;
+    line-height: 1;
+    white-space: nowrap;
+    overflow: hidden;
+    text-overflow: ellipsis;
+    max-width: 9.5rem;
+    vertical-align: middle;
+    border: 1px solid rgba(0, 0, 0, 0.06);
+    background: rgba(0, 0, 0, 0.03);
+    color: rgba(0, 0, 0, 0.85);
+  }
+  .chip--accent {
+    background: rgba(255, 122, 24, 0.09);
+    color: var(--accent);
+    border-color: rgba(255, 122, 24, 0.12);
+  }
+  .tags-row {
+    display: flex;
+    flex-wrap: wrap;
+    gap: 0.15rem;
+    align-items: center;
+  }
+
+  footer.card-footer,
+  article.card footer {
+    padding: 0.5rem 0.9rem;
+    border-top: 1px solid rgba(0, 0, 0, 0.04);
+    background: rgba(0, 0, 0, 0.01);
+    display: flex;
+    justify-content: flex-start;
+    gap: 1rem;
+    flex: 0 0 auto;
+  }
+
+  footer a {
+    font-weight: 600;
+  }
+
+  @media (min-width: 900px) {
+    .recipe-figure img {
+      height: 200px;
+    }
+  }
+  @media (min-width: 1200px) {
+    .recipe-figure img {
+      height: 220px;
+    }
+  }
+</style>
+{% endblock %} {% block navbar %}
+<header class="container">
+  <nav>
+    <ul>
+      <li>
+        <a href="{% url 'index' %}"><strong>Sandwitches</strong></a>
+      </li>
+    </ul>
+    <ul class="icons">
+      <li>
+        <a
+          rel="noopener noreferrer"
+          class="contrast"
+          aria-label="GitHub repository"
+          href="https://github.com/martynvdijke/sandwitches"
+          target="_blank"
+          ><svg
+            xmlns="http://www.w3.org/2000/svg"
+            height="24"
+            width="24.25"
+            viewBox="0 0 496 512"
+            class="icon-github"
+          >
+            <path
+              d="M165.9 397.4c0 2-2.3 3.6-5.2 3.6-3.3.3-5.6-1.3-5.6-3.6 0-2 2.3-3.6 5.2-3.6 3-.3 5.6 1.3 5.6 3.6zm-31.1-4.5c-.7 2 1.3 4.3 4.3 4.9 2.6 1 5.6 0 6.2-2s-1.3-4.3-4.3-5.2c-2.6-.7-5.5.3-6.2 2.3zm44.2-1.7c-2.9.7-4.9 2.6-4.6 4.9.3 2 2.9 3.3 5.9 2.6 2.9-.7 4.9-2.6 4.6-4.6-.3-1.9-3-3.2-5.9-2.9zM244.8 8C106.1 8 0 113.3 0 252c0 110.9 69.8 205.8 169.5 239.2 12.8 2.3 17.3-5.6 17.3-12.1 0-6.2-.3-40.4-.3-61.4 0 0-70 15-84.7-29.8 0 0-11.4-29.1-27.8-36.6 0 0-22.9-15.7 1.6-15.4 0 0 24.9 2 38.6 25.8 21.9 38.6 58.6 27.5 72.9 20.9 2.3-16 8.8-27.1 16-33.7-55.9-6.2-112.3-14.3-112.3-110.5 0-27.5 7.6-41.3 23.6-58.9-2.6-6.5-11.1-33.3 2.6-67.9 20.9-6.5 69 27 69 27 20-5.6 41.5-8.5 62.8-8.5s42.8 2.9 62.8 8.5c0 0 48.1-33.6 69-27 13.7 34.7 5.2 61.4 2.6 67.9 16 17.7 25.8 31.5 25.8 58.9 0 96.5-58.9 104.2-114.8 110.5 9.2 7.9 17 22.9 17 46.4 0 33.7-.3 75.4-.3 83.6 0 6.5 4.6 14.4 17.3 12.1C428.2 457.8 496 362.9 496 252 496 113.3 383.5 8 244.8 8zM97.2 352.9c-1.3 1-1 3.3.7 5.2 1.6 1.6 3.9 2.3 5.2 1 1.3-1 1-3.3-.7-5.2-1.6-1.6-3.9-2.3-5.2-1zm-10.8-8.1c-.7 1.3.3 2.9 2.3 3.9 1.6 1 3.6.7 4.3-.7.7-1.3-.3-2.9-2.3-3.9-2-.6-3.6-.3-4.3.7zm32.4 35.6c-1.6 1.3-1 4.3 1.3 6.2 2.3 2.3 5.2 2.6 6.5 1 1.3-1.3.7-4.3-1.3-6.2-2.2-2.3-5.2-2.6-6.5-1zm-11.4-14.7c-1.6 1-1.6 3.6 0 5.9 1.6 2.3 4.3 3.3 5.6 2.3 1.6-1.3 1.6-3.9 0-6.2-1.4-2.3-4-3.3-5.6-2z"
+            ></path></svg
+        ></a>
+      </li>
+      <li>
+        <a
+          href="#"
+          id="theme-toggle"
+          aria-label="Toggle theme"
+          role="button"
+          title="Toggle theme"
+          >☀️</a
+        >
+      </li>
+    </ul>
+    <ul>
+      {% if user.is_authenticated %}
+      <li><a href="{% url 'admin:index' %}">Admin</a></li>
+      <li><a href="{% url 'admin:logout' %}">Logout</a></li>
+      {% else %}
+      <li><a href="{% url 'admin:login' %}">Login</a></li>
+      {% endif %}
+    </ul>
+  </nav>
+</header>
+
+<script>
+  // Simple toggle-style theme switcher (stores choice in localStorage)
+  const themeSwitcher = {
+    localStorageKey: "picoPreferredColorScheme",
+    buttonSelector: "#theme-toggle",
+    rootAttribute: "data-theme",
+    init() {
+      // read saved choice, fallback to system preference
+      const saved = window.localStorage?.getItem(this.localStorageKey);
+      this._scheme =
+        saved ??
+        (window.matchMedia &&
+        window.matchMedia("(prefers-color-scheme: dark)").matches
+          ? "dark"
+          : "light");
+      this.applyScheme();
+      this.initButton();
+    },
+    initButton() {
+      const btn = document.querySelector(this.buttonSelector);
+      if (!btn) return;
+      this.updateButton(btn);
+      btn.addEventListener("click", (e) => {
+        e.preventDefault();
+        this.toggle();
+        this.updateButton(btn);
+      });
+      // react to storage changes from other tabs
+      window.addEventListener("storage", (ev) => {
+        if (ev.key === this.localStorageKey) {
+          this._scheme =
+            ev.newValue ||
+            (window.matchMedia &&
+            window.matchMedia("(prefers-color-scheme: dark)").matches
+              ? "dark"
+              : "light");
+          this.applyScheme();
+          this.updateButton(document.querySelector(this.buttonSelector));
+        }
+      });
+    },
+    toggle() {
+      this._scheme = this._scheme === "dark" ? "light" : "dark";
+      this.applyScheme();
+      window.localStorage?.setItem(this.localStorageKey, this._scheme);
+    },
+    applyScheme() {
+      document.documentElement?.setAttribute(this.rootAttribute, this._scheme);
+    },
+    updateButton(btn) {
+      if (!btn) return;
+      btn.textContent = this._scheme === "dark" ? "🌙" : "☀️";
+      btn.title =
+        this._scheme === "dark" ? "Switch to light" : "Switch to dark";
+      btn.setAttribute(
+        "aria-pressed",
+        this._scheme === "dark" ? "true" : "false"
+      );
+    },
+  };
+  themeSwitcher.init();
+</script>
+{% endblock %} {% block extra_scripts %} {% block page_scripts %}{% endblock %}
+{% endblock %}

sandwitches-0.1.0/src/sandwitches/templates/detail.html

@@ -0,0 +1,44 @@
+{% extends "base_pico.html" %}
+{% block title %}{{ recipe.title }} — Sandwitch{% endblock %}
+
+{% block content %}
+
+{% load markdown_extras %}
+<nav aria-label="breadcrumb" class="container">
+  <a href="{% url 'index' %}">&larr; Back to all</a>
+</nav>
+
+<div class="grid">
+  <article class="card">
+    <figure>
+      {% if recipe.image %}
+        <img src="{{ recipe.image.url }}" alt="{{ recipe.title }}">
+      {% endif %}
+    </figure>
+    <header>
+      {{ recipe.title }}
+    </header>
+      <h4>Description</h4>
+      {{ recipe.description|convert_markdown|safe|default:"No description yet." }}
+
+      <h4>Ingredients</h4>
+      {{ recipe.ingredients|convert_markdown|safe|default:"No ingredients listed." }}
+
+      <h4>Instructions</h4>
+      {{ recipe.instructions|convert_markdown|safe|default:"No instructions yet." }}
+    
+    <div class="tags-row">
+      <div style="margin-top:12px;">
+        {% for tag in recipe.tags.all %}
+          <span class="tag">{{ tag.name }}</span>
+        {% endfor %}
+      </div>
+    </div>
+      {% if user.is_authenticated and user.is_staff %}
+    <footer>
+        <a href="/admin/sandwitches/recipe/{{ recipe.pk }}/change/">Edit</a>
+    </footer>
+    {% endif %}
+  </article>
+</div>
+{% endblock %}

sandwitches-0.1.0/src/sandwitches/templates/form.html

@@ -0,0 +1,15 @@
+<!DOCTYPE html>
+<html>
+  <head>
+    <meta charset="utf-8" />
+    <title>Edit</title>
+  </head>
+  <body>
+    <h1>Edit Recipe: {{ recipe.title }}</h1>
+    <form method="post" enctype="multipart/form-data">
+      {% csrf_token %} {{ form.as_p }}
+      <button type="submit">Save</button>
+      <a href="{% url 'recipes:admin_list' %}">Cancel</a>
+    </form>
+  </body>
+</html>

sandwitches-0.1.0/src/sandwitches/templates/index.html

@@ -0,0 +1,71 @@
+{% extends "base_pico.html" %}
+
+{% block title %}Sandwitches{% endblock %}
+
+{% block content %}
+<div class="grid search-row">
+  <div>
+    <h4>Sandwitches: sandwiches so good, they haunt you!</h4>
+  </div>
+  <div>
+    <form role="search" onsubmit="return false;">
+      <input id="search" type="search" placeholder="Search by title or tag" aria-label="Search">
+    </form>
+  </div>
+</div>
+
+<section class="grid">
+  {% for recipe in recipes %}
+    <article class="card" onclick="location.href='{% url 'recipe_detail' recipe.slug %}';" style="cursor:pointer;">
+      {% if recipe.image %}
+      <figure class="recipe-figure">
+          <img src="{{ recipe.image.url }}" alt="{{ recipe.title }}">
+      </figure>
+      {% endif %}
+
+      <div class="card-body">
+        <header class="card-title">{{ recipe.title }}</header>
+
+        <div class="tags-row" aria-hidden="false">
+          {% for tag in recipe.tags.all %}
+            <span class="chip{% if tag|length < 8 %} chip--accent{% endif %}">{{ tag.name }}</span>
+          {% endfor %}
+        </div>
+      </div>
+
+      {% if user.is_authenticated and user.is_staff %}
+      <footer>            
+          <a href="/admin/sandwitches/recipe/{{ recipe.pk }}/change/" rel="noopener">Edit</a>
+      </footer>
+      {% endif %}
+    </article>
+
+  {% empty %}
+    <article class="card">
+      <div class="card-body">
+        <p>No sandwitches yet, please stay tuned.</p>
+      </div>
+    </article>
+  {% endfor %}
+</section>
+
+{% endblock %}
+
+{% block page_scripts %}
+<script>
+document.addEventListener('DOMContentLoaded', function() {
+  const search = document.getElementById('search');
+  if (!search) return;
+  search.addEventListener('input', function() {
+    const q = this.value.toLowerCase().trim();
+    document.querySelectorAll('section.grid article.card').forEach(card => {
+      const title = (card.querySelector('.card-title')?.textContent || '').toLowerCase();
+      const tags = Array.from(card.querySelectorAll('.tag, .chip')).map(t => t.textContent.toLowerCase());
+      const descr = (card.querySelector('.card-body p')?.textContent || '').toLowerCase();
+      const match = !q || title.includes(q) || descr.includes(q) || tags.some(t => t.includes(q));
+      card.style.display = match ? '' : 'none';
+    });
+  });
+});
+</script>
+{% endblock %}

sandwitches-0.1.0/src/sandwitches/templates/setup.html

@@ -0,0 +1,53 @@
+{% extends "base_pico.html" %}
+{% load static %}
+{% block title %}Initial setup — Create admin{% endblock %}
+
+{% block content %}
+<div class="container" style="max-width:720px; margin:2rem auto;">
+  <article class="card">
+    <div class="card-body">
+      <h2>Create initial administrator</h2>
+      <p>
+        This page is only available when there are no admin users in the database.
+        After creating the account you will be logged in and redirected to the admin.
+      </p>
+
+      <form method="post" novalidate>
+        {% csrf_token %}
+        {% if form.non_field_errors %}
+          <div class="card-panel" role="alert">
+            <ul>
+              {% for err in form.non_field_errors %}
+                <li>{{ err }}</li>
+              {% endfor %}
+            </ul>
+          </div>
+        {% endif %}
+
+        <label for="{{ form.username.id_for_label }}">Username</label>
+        {{ form.username }}
+
+        <label for="{{ form.email.id_for_label }}">Email (optional)</label>
+        {{ form.email }}
+
+        <label for="{{ form.first_name.id_for_label }}">First name</label>
+        {{ form.first_name }}
+
+        <label for="{{ form.last_name.id_for_label }}">Last name</label>
+        {{ form.last_name }}
+
+        <label for="{{ form.password1.id_for_label }}">Password</label>
+        {{ form.password1 }}
+
+        <label for="{{ form.password2.id_for_label }}">Confirm password</label>
+        {{ form.password2 }}
+
+        <p style="margin-top:1rem;">
+          <button type="submit">Create admin</button>
+          <a class="contrast" href="{% url 'index' %}">Cancel</a>
+        </p>
+      </form>
+    </div>
+  </article>
+</div>
+{% endblock %}

sandwitches-0.1.0/src/sandwitches/templatetags/markdown_extras.py

@@ -0,0 +1,17 @@
+import markdown
+
+from django import template
+from django.template.defaultfilters import stringfilter
+
+register = template.Library()
+
+
+@register.filter
+@stringfilter
+def convert_markdown(value):
+    md = markdown.markdown(
+        value,
+        extensions=["markdown.extensions.fenced_code", "markdown.extensions.tables"],
+    )
+
+    return md

sandwitches-0.1.0/src/sandwitches/urls.py

@@ -0,0 +1,45 @@
+"""
+URL configuration for sandwitches project.
+
+The `urlpatterns` list routes URLs to views. For more information please see:
+    https://docs.djangoproject.com/en/5.2/topics/http/urls/
+Examples:
+Function views
+    1. Add an import:  from my_app import views
+    2. Add a URL to urlpatterns:  path('', views.home, name='home')
+Class-based views
+    1. Add an import:  from other_app.views import Home
+    2. Add a URL to urlpatterns:  path('', Home.as_view(), name='home')
+Including another URLconf
+    1. Import the include() function: from django.urls import include, path
+    2. Add a URL to urlpatterns:  path('blog/', include('blog.urls'))
+"""
+
+from django.contrib import admin
+from django.urls import path
+from . import views
+
+from django.conf import settings
+from django.conf.urls.static import static
+from debug_toolbar.toolbar import debug_toolbar_urls
+import os
+import sys
+
+
+urlpatterns = [
+    path("", views.index, name="index"),
+    path("admin/", admin.site.urls),
+    path("recipes/<slug:slug>/", views.recipe_detail, name="recipe_detail"),
+    path("setup/", views.setup, name="setup"),
+]
+
+if "test" not in sys.argv or "PYTEST_VERSION" in os.environ:
+    from debug_toolbar.toolbar import debug_toolbar_urls
+
+    urlpatterns = [
+        *urlpatterns,
+    ] + debug_toolbar_urls()
+
+
+if settings.DEBUG:
+    urlpatterns += static(settings.MEDIA_URL, document_root=settings.MEDIA_ROOT)

sandwitches-0.1.0/src/sandwitches/views.py

@@ -0,0 +1,58 @@
+from django.shortcuts import render, get_object_or_404, redirect
+from django.urls import reverse
+from django.contrib import messages
+from django.contrib.auth import login
+from django.contrib.auth import get_user_model
+
+from .models import Recipe
+from .forms import RecipeForm, AdminSetupForm
+
+User = get_user_model()
+
+
+def recipe_edit(request, pk):
+    recipe = get_object_or_404(Recipe, pk=pk)
+    if request.method == "POST":
+        form = RecipeForm(request.POST, request.FILES, instance=recipe)
+        if form.is_valid():
+            form.save()
+            return redirect("recipes:admin_list")
+    else:
+        form = RecipeForm(instance=recipe)
+    return render(request, "recipe_form.html", {"form": form, "recipe": recipe})
+
+
+def recipe_detail(request, slug):
+    recipe = get_object_or_404(Recipe, slug=slug)
+    return render(request, "detail.html", {"recipe": recipe})
+
+
+def index(request):
+    if not User.objects.filter(is_superuser=True).exists():
+        return redirect("setup")
+    recipes = Recipe.objects.order_by("-created_at")
+    return render(request, "index.html", {"recipes": recipes})
+
+
+def setup(request):
+    """
+    First-time setup page: create initial superuser if none exists.
+    Visible only while there are no superusers in the DB.
+    """
+    # do not allow access if a superuser already exists
+    if User.objects.filter(is_superuser=True).exists():
+        return redirect("index")
+
+    if request.method == "POST":
+        form = AdminSetupForm(request.POST)
+        if form.is_valid():
+            user = form.save()
+            # log in the newly created admin
+            user.backend = "django.contrib.auth.backends.ModelBackend"
+            login(request, user)
+            messages.success(request, "Admin account created and signed in.")
+            return redirect(reverse("admin:index"))
+    else:
+        form = AdminSetupForm()
+
+    return render(request, "setup.html", {"form": form})

sandwitches-0.1.0/src/sandwitches/wsgi.py

@@ -0,0 +1,16 @@
+"""
+WSGI config for sandwitches project.
+
+It exposes the WSGI callable as a module-level variable named ``application``.
+
+For more information on this file, see
+https://docs.djangoproject.com/en/5.2/howto/deployment/wsgi/
+"""
+
+import os
+
+from django.core.wsgi import get_wsgi_application
+
+os.environ.setdefault("DJANGO_SETTINGS_MODULE", "sandwitches.settings")
+
+application = get_wsgi_application()