chore: add demo project

.gitignore

@@ -1,3 +1,4 @@
 __pycache__/
 .coverage
 dist/
+*.sqlite3

manage.py

@@ -0,0 +1,24 @@
+#!/usr/bin/env python
+"""Django's command-line utility for administrative tasks."""
+
+import os
+import sys
+
+
+def main():
+    """Run administrative tasks."""
+    os.environ.setdefault("DJANGO_SETTINGS_MODULE", "testproj.settings")
+    try:
+        from django.core.management import execute_from_command_line
+    except ImportError as exc:
+        msg = (
+            "Couldn't import Django. Are you sure it's installed and "
+            "available on your PYTHONPATH environment variable? Did you "
+            "forget to activate a virtual environment?"
+        )
+        raise ImportError(msg) from exc
+    execute_from_command_line(sys.argv)
+
+
+if __name__ == "__main__":
+    main()

pyproject.toml

@@ -58,7 +58,7 @@ exclude_lines = [
 ]
 
 [tool.pytest.ini_options]
-DJANGO_SETTINGS_MODULE = "tests.settings"
+DJANGO_SETTINGS_MODULE = "testproj.settings"
 pythonpath = [".", "src"]
 
 [tool.hatch.build.targets.wheel]

testproj/asgi.py

@@ -0,0 +1,7 @@
+import os
+
+from django.core.asgi import get_asgi_application
+
+os.environ.setdefault("DJANGO_SETTINGS_MODULE", "testproj.settings")
+
+application = get_asgi_application()

tests/settings.py → testproj/settings.py

@@ -5,12 +5,14 @@
 from pathlib import Path
 
 # Build paths inside the project like this: BASE_DIR / 'subdir'.
-BASE_DIR = Path(__file__).absolute()
+BASE_DIR = Path(__file__).resolve().parent.parent
 
-SECRET_KEY = "12345healthy67890"
+SECRET_KEY = "django-insecure-txy9b_=khny3ax$up%i&)&axs!inx7dy1b0nu26g!q-z$b)f-f"  # noqa: S105
 
 DEBUG = True
 
+ALLOWED_HOSTS = []
+
 INSTALLED_APPS = [
     "django.contrib.auth",
     "django.contrib.contenttypes",
@@ -30,7 +32,7 @@
     "django.middleware.clickjacking.XFrameOptionsMiddleware",
 ]
 
-ROOT_URLCONF = "tests.urls"
+ROOT_URLCONF = "testproj.urls"
 
 TEMPLATES = [
     {
@@ -48,6 +50,8 @@
     },
 ]
 
+WSGI_APPLICATION = "testproj.wsgi.application"
+
 DATABASES = {
     "default": {
         "ENGINE": "django.db.backends.sqlite3",
@@ -62,17 +66,32 @@
     "dummy": {
         "BACKEND": "django.core.cache.backends.dummy.DummyCache",
     },
-    "broken": {
-        "BACKEND": "tests.cache.BrokenCache",
-    },
 }
 
 STORAGES = {
     "default": {
         "BACKEND": "django.core.files.storage.InMemoryStorage",
     },
+    "staticfiles": {
+        "BACKEND": "django.contrib.staticfiles.storage.StaticFilesStorage",
+    },
 }
 
+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",
+    },
+]
+
 
 LANGUAGE_CODE = "en-us"
 TIME_ZONE = "UTC"
@@ -83,8 +102,9 @@
 
 DEFAULT_AUTO_FIELD = "django.db.models.BigAutoField"
 
+# Application health
 HEALTH_CHECK_BACKENDS = {
-    "default_cache": {
+    "cache": {
         "BACKEND": "healthy.backends.CacheHealthBackend",
         "OPTIONS": {
             "alias": "default",
@@ -96,7 +116,7 @@
             "alias": "default",
         },
     },
-    "default_storage": {
+    "storage": {
         "BACKEND": "healthy.backends.StorageBackend",
         "OPTIONS": {
             "alias": "default",

testproj/wsgi.py

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

tests/test_backends.py

@@ -4,6 +4,7 @@
 from unittest import mock
 
 import pytest
+from django.core.cache import caches
 from django.core.files.storage import storages
 from django.db import connections
 
@@ -103,9 +104,11 @@ async def test_with_working_cache(self):
         assert got.status == backends.HealthStatus.UP
 
     async def test_with_broken_cache(self):
-        backend = backends.CacheHealthBackend("broken")
+        backend = backends.CacheHealthBackend()
+        cache = caches[backend.alias]
 
-        got = await backend.run_health_check()
+        with mock.patch.object(cache, "aset", side_effect=RuntimeError):
+            got = await backend.run_health_check()
 
         assert isinstance(got, backends.Health)
         assert got.status == backends.HealthStatus.DOWN