[Release/2025.12] Update template project

.github/workflows/run-linters.yml

@@ -19,7 +19,7 @@ jobs:
       - name: Set up Python
         uses: actions/setup-python@v2
         with:
-          python-version: 3.10
+          python-version: "3.10"
 
       - name: Install dependencies
         run: |

containers/compose.yaml

@@ -1,7 +1,7 @@
 name: django-tpl
 services:
   database:
-    image: postgres:16.10-alpine
+    image: docker.io/postgres:16.10-alpine
     container_name: postgres
     restart: unless-stopped
     environment:
@@ -18,6 +18,10 @@ services:
     ports:
       - "${SMTP_PORT:-1025}:1025"
       - "${SMTP_WEB_PORT:-8025}:8025"
+    volumes:
+      - ./mailhog:/etc/mailhog:ro
+    environment:
+      - MH_AUTH_FILE=/etc/mailhog/auth.txt
 
   staticfiles:
     image: docker.io/caddy:2.10.2-alpine

containers/mailhog/auth.txt

@@ -0,0 +1 @@
+django:$2a$12$cWb4JgyAwd9BoD.4sr6mOuSg9/1vTq6JUYRZfCjSgJJmTtG3rz1FC

pyproject.toml

@@ -30,10 +30,31 @@ dependencies = [
     "psycopg[binary]",
 ]
 
-[project.optional-dependencies]
+[dependency-groups]
 dev = [
-    "pytest-django",
     "black>=25.9.0",
+    "bumpver>=2025.1131",
+    "pytest-django>=4.11.1",
 ]
 
-[project.urls]
+[tool.bumpver]
+current_version = "2025.12rc1"
+version_pattern = "YYYY.0M[.PATCH][PYTAGNUM]"
+commit_message = "bump version {old_version} -> {new_version}"
+tag_message = "{new_version}"
+tag_scope = "default"
+pre_commit_hook = ""
+post_commit_hook = ""
+commit = true
+tag = true
+push = false
+
+[tool.bumpver.file_patterns]
+"pyproject.toml" = [
+    'current_version = "{version}"',
+]
+
+[tool.black]
+line-length = 119
+target-version = ["py310", "py311", "py312"]
+include = "\\.pyi?$"

src/manage.py

@@ -6,7 +6,7 @@
 
 def main():
     """Run administrative tasks."""
-    os.environ.setdefault("DJANGO_SETTINGS_MODULE", "project_core.settings")
+    os.environ.setdefault("DJANGO_SETTINGS_MODULE", "website.settings")
     try:
         from django.core.management import execute_from_command_line
     except ImportError as exc:

src/user/admin.py

@@ -0,0 +1,5 @@
+from django.contrib import admin
+from django.contrib.auth.admin import UserAdmin
+from .models import User
+
+admin.site.register(User, UserAdmin)

src/user/apps.py

@@ -0,0 +1,5 @@
+from django.apps import AppConfig
+
+
+class UserConfig(AppConfig):
+    name = "user"

src/user/migrations/0001_initial.py

@@ -0,0 +1,120 @@
+# Generated by Django 6.0 on 2025-12-10 08:53
+
+import django.contrib.auth.models
+import django.contrib.auth.validators
+import django.utils.timezone
+from django.db import migrations, models
+
+
+class Migration(migrations.Migration):
+
+    initial = True
+
+    dependencies = [
+        ("auth", "0012_alter_user_first_name_max_length"),
+    ]
+
+    operations = [
+        migrations.CreateModel(
+            name="User",
+            fields=[
+                (
+                    "id",
+                    models.BigAutoField(
+                        auto_created=True,
+                        primary_key=True,
+                        serialize=False,
+                        verbose_name="ID",
+                    ),
+                ),
+                ("password", models.CharField(max_length=128, verbose_name="password")),
+                (
+                    "last_login",
+                    models.DateTimeField(blank=True, null=True, verbose_name="last login"),
+                ),
+                (
+                    "is_superuser",
+                    models.BooleanField(
+                        default=False,
+                        help_text="Designates that this user has all permissions without explicitly assigning them.",
+                        verbose_name="superuser status",
+                    ),
+                ),
+                (
+                    "username",
+                    models.CharField(
+                        error_messages={"unique": "A user with that username already exists."},
+                        help_text="Required. 150 characters or fewer. Letters, digits and @/./+/-/_ only.",
+                        max_length=150,
+                        unique=True,
+                        validators=[django.contrib.auth.validators.UnicodeUsernameValidator()],
+                        verbose_name="username",
+                    ),
+                ),
+                (
+                    "first_name",
+                    models.CharField(blank=True, max_length=150, verbose_name="first name"),
+                ),
+                (
+                    "last_name",
+                    models.CharField(blank=True, max_length=150, verbose_name="last name"),
+                ),
+                (
+                    "email",
+                    models.EmailField(blank=True, max_length=254, verbose_name="email address"),
+                ),
+                (
+                    "is_staff",
+                    models.BooleanField(
+                        default=False,
+                        help_text="Designates whether the user can log into this admin site.",
+                        verbose_name="staff status",
+                    ),
+                ),
+                (
+                    "is_active",
+                    models.BooleanField(
+                        default=True,
+                        help_text="Designates whether this user should be treated as active. "
+                        "Unselect this instead of deleting accounts.",
+                        verbose_name="active",
+                    ),
+                ),
+                (
+                    "date_joined",
+                    models.DateTimeField(default=django.utils.timezone.now, verbose_name="date joined"),
+                ),
+                (
+                    "groups",
+                    models.ManyToManyField(
+                        blank=True,
+                        help_text="The groups this user belongs to. A user will get all permissions granted "
+                        "to each of their groups.",
+                        related_name="user_set",
+                        related_query_name="user",
+                        to="auth.group",
+                        verbose_name="groups",
+                    ),
+                ),
+                (
+                    "user_permissions",
+                    models.ManyToManyField(
+                        blank=True,
+                        help_text="Specific permissions for this user.",
+                        related_name="user_set",
+                        related_query_name="user",
+                        to="auth.permission",
+                        verbose_name="user permissions",
+                    ),
+                ),
+            ],
+            options={
+                "verbose_name": "user",
+                "verbose_name_plural": "users",
+                "abstract": False,
+            },
+            managers=[
+                ("objects", django.contrib.auth.models.UserManager()),
+            ],
+        ),
+    ]

src/user/models.py

@@ -0,0 +1,15 @@
+"""
+Custom user model
+
+.. seealso::
+    https://docs.djangoproject.com/en/dev/topics/auth/customizing/
+    https://docs.djangoproject.com/en/5.2/topics/auth/customizing/#substituting-a-custom-user-model
+    https://docs.djangoproject.com/en/5.2/topics/auth/customizing/#referencing-the-user-model
+
+"""
+
+from django.contrib.auth.models import AbstractUser
+
+
+class User(AbstractUser):
+    pass

src/project_core/asgi.py → src/website/asgi.py

@@ -11,6 +11,6 @@
 
 from django.core.asgi import get_asgi_application
 
-os.environ.setdefault("DJANGO_SETTINGS_MODULE", "project_core.settings")
+os.environ.setdefault("DJANGO_SETTINGS_MODULE", "website.settings")
 
 application = get_asgi_application()

src/project_core/settings.py → src/website/settings.py

@@ -20,6 +20,7 @@
 # See https://docs.djangoproject.com/en/5.2/howto/deployment/checklist/
 
 # SECURITY WARNING: keep the secret key used in production secret!
+# noinspection SpellCheckingInspection
 SECRET_KEY = "django-insecure-ir1a1f!bjywcs+1$shmpbq=6ss3!0!^%tha*midcv=mn*48x^f"
 
 # SECURITY WARNING: don't run with debug turned on in production!
@@ -37,6 +38,7 @@
     "django.contrib.sessions",
     "django.contrib.messages",
     "django.contrib.staticfiles",
+    "user.apps.UserConfig",
 ]
 
 MIDDLEWARE = [
@@ -49,7 +51,7 @@
     "django.middleware.clickjacking.XFrameOptionsMiddleware",
 ]
 
-ROOT_URLCONF = "project_core.urls"
+ROOT_URLCONF = "website.urls"
 
 TEMPLATES = [
     {
@@ -66,7 +68,7 @@
     },
 ]
 
-WSGI_APPLICATION = "project_core.wsgi.application"
+WSGI_APPLICATION = "website.wsgi.application"
 
 
 # Database
@@ -121,10 +123,24 @@
 # Static files (CSS, JavaScript, Images)
 # https://docs.djangoproject.com/en/5.2/howto/static-files/
 
-STATIC_URL = "static/"
+STATIC_URL = "http://localhost:8888/"
 STATIC_ROOT = BASE_DIR.parent / "staticfiles"
 
 # Default primary key field type
 # https://docs.djangoproject.com/en/5.2/ref/settings/#default-auto-field
 
 DEFAULT_AUTO_FIELD = "django.db.models.BigAutoField"
+
+# Sending email
+# https://docs.djangoproject.com/en/5.2/topics/email/
+
+EMAIL_HOST = "localhost"
+EMAIL_PORT = 1025
+EMAIL_HOST_USER = "django"
+EMAIL_HOST_PASSWORD = "django"
+EMAIL_SUBJECT_PREFIX = ""
+
+# Custom user model
+# https://docs.djangoproject.com/en/5.2/topics/auth/customizing/
+
+AUTH_USER_MODEL = "user.User"

src/project_core/wsgi.py → src/website/wsgi.py

@@ -11,6 +11,6 @@
 
 from django.core.wsgi import get_wsgi_application
 
-os.environ.setdefault("DJANGO_SETTINGS_MODULE", "project_core.settings")
+os.environ.setdefault("DJANGO_SETTINGS_MODULE", "website.settings")
 
 application = get_wsgi_application()