django 4.2 docs

Author: SKairinos

codeforlife/models/abstract_base_session.py

@@ -29,7 +29,7 @@
 class AbstractBaseSession(_AbstractBaseSession):
     """
     Base session class to be inherited by all session classes.
-    https://docs.djangoproject.com/en/3.2/topics/http/sessions/#example
+    https://docs.djangoproject.com/en/4.2/topics/http/sessions/#example
     """
 
     pk: str  # type: ignore[assignment]

codeforlife/models/abstract_base_user.py

@@ -22,7 +22,7 @@
 class AbstractBaseUser(_AbstractBaseUser):
     """
     Base user class to be inherited by all user classes.
-    https://docs.djangoproject.com/en/3.2/topics/auth/customizing/#using-a-custom-user-model-when-starting-a-project
+    https://docs.djangoproject.com/en/4.2/topics/auth/customizing/#using-a-custom-user-model-when-starting-a-project
     """
 
     pk: int

codeforlife/models/base_session_store.py

@@ -32,7 +32,7 @@ class BaseSessionStore(
 ):
     """
     Base session store class to be inherited by all session store classes.
-    https://docs.djangoproject.com/en/3.2/topics/http/sessions/#example
+    https://docs.djangoproject.com/en/4.2/topics/http/sessions/#example
     """
 
     @classmethod

codeforlife/models/signals/__init__.py

@@ -3,7 +3,7 @@
 Created on 14/03/2024 at 12:52:50(+00:00).
 
 Helpers for module "django.db.models.signals".
-https://docs.djangoproject.com/en/3.2/ref/signals/#module-django.db.models.signals
+https://docs.djangoproject.com/en/4.2/ref/signals/#module-django.db.models.signals
 """
 
 from .general import UpdateFields, update_fields_includes

codeforlife/models/signals/post_save.py

@@ -3,7 +3,7 @@
 Created on 20/06/2024 at 11:46:02(+01:00).
 
 Helpers for module "django.db.models.signals.post_save".
-https://docs.djangoproject.com/en/3.2/ref/signals/#post-save
+https://docs.djangoproject.com/en/4.2/ref/signals/#post-save
 """
 
 import typing as t

codeforlife/models/signals/pre_save.py

@@ -3,7 +3,7 @@
 Created on 14/03/2024 at 13:08:13(+00:00).
 
 Helpers for module "django.db.models.signals.pre_save".
-https://docs.djangoproject.com/en/3.2/ref/signals/#pre-save
+https://docs.djangoproject.com/en/4.2/ref/signals/#pre-save
 """
 
 import typing as t

codeforlife/settings/django.py

@@ -1,6 +1,6 @@
 """
 This file contains all the settings Django supports out of the box.
-https://docs.djangoproject.com/en/3.2/ref/settings/
+https://docs.djangoproject.com/en/4.2/ref/settings/
 """
 
 import json
@@ -28,12 +28,12 @@
 DEBUG = bool(int(os.getenv("DEBUG", "1")))
 
 # Quick-start development settings - unsuitable for production
-# See https://docs.djangoproject.com/en/3.2/howto/deployment/checklist/
+# See https://docs.djangoproject.com/en/4.2/howto/deployment/checklist/
 
 ALLOWED_HOSTS = ["*"]
 
 # Database
-# https://docs.djangoproject.com/en/3.2/ref/settings/#databases
+# https://docs.djangoproject.com/en/4.2/ref/settings/#databases
 
 
 def get_databases():
@@ -106,12 +106,12 @@ def get_databases():
 SECRET_KEY = os.getenv("SECRET_KEY", "replace-me")
 
 # Auth
-# https://docs.djangoproject.com/en/3.2/topics/auth/default/
+# https://docs.djangoproject.com/en/4.2/topics/auth/default/
 
 LOGIN_URL = f"{SERVICE_BASE_URL}/session/expired/"
 
 # Authentication backends
-# https://docs.djangoproject.com/en/3.2/ref/settings/#authentication-backends
+# https://docs.djangoproject.com/en/4.2/ref/settings/#authentication-backends
 
 AUTHENTICATION_BACKENDS = [
     "codeforlife.user.auth.backends.EmailBackend",
@@ -122,7 +122,7 @@ def get_databases():
 ]
 
 # Sessions
-# https://docs.djangoproject.com/en/3.2/topics/http/sessions/
+# https://docs.djangoproject.com/en/4.2/topics/http/sessions/
 
 SESSION_ENGINE = "codeforlife.user.models.session"
 SESSION_SAVE_EVERY_REQUEST = True
@@ -135,14 +135,14 @@ def get_databases():
 SESSION_COOKIE_DOMAIN = os.getenv("SESSION_COOKIE_DOMAIN", "localhost")
 
 # Security
-# https://docs.djangoproject.com/en/3.2/topics/security/
+# https://docs.djangoproject.com/en/4.2/topics/security/
 
 SECURE_CONTENT_TYPE_NOSNIFF = True
 SECURE_BROWSER_XSS_FILTER = True
 SECURE_REFERRER_POLICY = "strict-origin-when-cross-origin"
 
 # Internationalization
-# https://docs.djangoproject.com/en/3.2/topics/i18n/
+# https://docs.djangoproject.com/en/4.2/topics/i18n/
 
 LANGUAGE_CODE = "en-gb"
 LANGUAGES = [("en-gb", _("English"))]
@@ -152,12 +152,12 @@ def get_databases():
 USE_TZ = True
 
 # Default primary key field type
-# https://docs.djangoproject.com/en/3.2/ref/settings/#default-auto-field
+# https://docs.djangoproject.com/en/4.2/ref/settings/#default-auto-field
 
 DEFAULT_AUTO_FIELD = "django.db.models.AutoField"
 
 # CSRF
-# https://docs.djangoproject.com/en/3.2/ref/csrf/
+# https://docs.djangoproject.com/en/4.2/ref/csrf/
 
 CSRF_COOKIE_NAME = f"{SERVICE_NAME}_csrftoken"
 CSRF_COOKIE_DOMAIN = os.getenv("CSRF_COOKIE_DOMAIN", "localhost")
@@ -166,7 +166,7 @@ def get_databases():
 CSRF_COOKIE_SECURE = True
 
 # Logging
-# https://docs.djangoproject.com/en/3.2/topics/logging/
+# https://docs.djangoproject.com/en/4.2/topics/logging/
 
 LOGGING = {
     "version": 1,
@@ -194,17 +194,17 @@ def get_databases():
 }
 
 # URLs
-# https://docs.djangoproject.com/en/3.2/ref/settings/#root-urlconf
+# https://docs.djangoproject.com/en/4.2/ref/settings/#root-urlconf
 
 ROOT_URLCONF = "api.urls"
 
 # App
-# https://docs.djangoproject.com/en/3.2/ref/settings/#wsgi-application
+# https://docs.djangoproject.com/en/4.2/ref/settings/#wsgi-application
 
 WSGI_APPLICATION = "application.app"
 
 # Password validation
-# https://docs.djangoproject.com/en/3.2/ref/settings/#auth-password-validators
+# https://docs.djangoproject.com/en/4.2/ref/settings/#auth-password-validators
 
 # TODO: compare Django's default common password validator with our own and
 #  decide which to keep
@@ -232,7 +232,7 @@ def get_databases():
 # pylint: enable=line-too-long
 
 # Installed Apps
-# https://docs.djangoproject.com/en/3.2/ref/settings/#installed-apps
+# https://docs.djangoproject.com/en/4.2/ref/settings/#installed-apps
 
 INSTALLED_APPS = [
     "django.contrib.admin",
@@ -255,13 +255,13 @@ def get_databases():
 ]
 
 # Static files (CSS, JavaScript, Images)
-# https://docs.djangoproject.com/en/3.2/howto/static-files/
+# https://docs.djangoproject.com/en/4.2/howto/static-files/
 
 STATIC_ROOT = SERVICE_BASE_DIR / "static"
 STATIC_URL = os.getenv("STATIC_URL", "/static/")
 
 # Templates
-# https://docs.djangoproject.com/en/3.2/ref/templates/
+# https://docs.djangoproject.com/en/4.2/ref/templates/
 
 TEMPLATES = [
     {
@@ -280,7 +280,7 @@ def get_databases():
 ]
 
 # File storage
-# https://docs.djangoproject.com/en/3.2/topics/files/#file-storage
+# https://docs.djangoproject.com/en/4.2/topics/files/#file-storage
 
 DEFAULT_FILE_STORAGE = (
     "django.core.files.storage.FileSystemStorage"

codeforlife/urls/handlers.py

@@ -5,7 +5,7 @@
 Custom error handlers which override django's default behavior to render a
 template.
 
-https://docs.djangoproject.com/en/3.2/ref/urls/#module-django.conf.urls
+https://docs.djangoproject.com/en/4.2/ref/urls/#module-django.conf.urls
 """
 
 from django.http import (

codeforlife/user/auth/password_validators/common.py

@@ -1,4 +1,4 @@
 # pylint: skip-file
-# TODO: https://docs.djangoproject.com/en/3.2/topics/auth/passwords/#writing-your-own-validator
+# TODO: https://docs.djangoproject.com/en/4.2/topics/auth/passwords/#writing-your-own-validator
 class CommonPasswordValidator:
     pass

codeforlife/user/models/session.py

@@ -17,7 +17,7 @@
 class Session(AbstractBaseSession):
     """
     A custom session model to support querying a user's session.
-    https://docs.djangoproject.com/en/3.2/topics/http/sessions/#example
+    https://docs.djangoproject.com/en/4.2/topics/http/sessions/#example
     """
 
     auth_factors: QuerySet["SessionAuthFactor"]
@@ -35,7 +35,7 @@ class SessionStore(BaseSessionStore[Session, User]):
     1. creating only one session per user;
     2. setting a session's auth factors;
     3. clearing a user's expired sessions.
-    https://docs.djangoproject.com/en/3.2/topics/http/sessions/#example
+    https://docs.djangoproject.com/en/4.2/topics/http/sessions/#example
     """
 
     def associate_session_to_user(self, session, user_id):