generated from erangel1/generic-template
192 lines
6.8 KiB
Python
192 lines
6.8 KiB
Python
"""
|
|
Base settings shared across all LabGraph environments.
|
|
|
|
Never imported directly — always imported via development.py or production.py.
|
|
All secrets are read from environment variables; missing required vars raise
|
|
ImproperlyConfigured immediately on startup.
|
|
"""
|
|
|
|
from pathlib import Path
|
|
|
|
import environ
|
|
|
|
BASE_DIR = Path(__file__).resolve().parent.parent.parent # backend/
|
|
|
|
env = environ.Env(
|
|
DEBUG=(bool, False),
|
|
ALLOWED_HOSTS=(list, ["localhost", "127.0.0.1"]),
|
|
)
|
|
|
|
environ.Env.read_env(BASE_DIR.parent / ".env")
|
|
|
|
# =============================================================================
|
|
# Security — no defaults for secrets; missing value raises ImproperlyConfigured
|
|
# =============================================================================
|
|
SECRET_KEY = env("SECRET_KEY")
|
|
ALLOWED_HOSTS = env.list("ALLOWED_HOSTS")
|
|
|
|
# =============================================================================
|
|
# Application definition
|
|
# =============================================================================
|
|
DJANGO_APPS = [
|
|
"django.contrib.admin",
|
|
"django.contrib.auth",
|
|
"django.contrib.contenttypes",
|
|
"django.contrib.sessions",
|
|
"django.contrib.messages",
|
|
"django.contrib.staticfiles",
|
|
]
|
|
|
|
THIRD_PARTY_APPS = [
|
|
"rest_framework",
|
|
"corsheaders",
|
|
"django_celery_beat",
|
|
"django_celery_results",
|
|
"drf_spectacular",
|
|
"django_filters",
|
|
]
|
|
|
|
LOCAL_APPS = [
|
|
"apps.core",
|
|
"apps.health",
|
|
]
|
|
|
|
INSTALLED_APPS = DJANGO_APPS + THIRD_PARTY_APPS + LOCAL_APPS
|
|
|
|
# =============================================================================
|
|
# Middleware — CorsMiddleware must be first
|
|
# =============================================================================
|
|
MIDDLEWARE = [
|
|
"corsheaders.middleware.CorsMiddleware",
|
|
"django.middleware.security.SecurityMiddleware",
|
|
"whitenoise.middleware.WhiteNoiseMiddleware",
|
|
"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",
|
|
]
|
|
|
|
ROOT_URLCONF = "config.urls"
|
|
WSGI_APPLICATION = "config.wsgi.application"
|
|
|
|
TEMPLATES = [
|
|
{
|
|
"BACKEND": "django.template.backends.django.DjangoTemplates",
|
|
"DIRS": [BASE_DIR / "templates"],
|
|
"APP_DIRS": True,
|
|
"OPTIONS": {
|
|
"context_processors": [
|
|
"django.template.context_processors.debug",
|
|
"django.template.context_processors.request",
|
|
"django.contrib.auth.context_processors.auth",
|
|
"django.contrib.messages.context_processors.messages",
|
|
],
|
|
},
|
|
},
|
|
]
|
|
|
|
# =============================================================================
|
|
# Database — parsed from DATABASE_URL env var by django-environ
|
|
# =============================================================================
|
|
DATABASES = {
|
|
"default": env.db("DATABASE_URL")
|
|
}
|
|
|
|
# Ensure Django uses UTC-aware datetimes in queries
|
|
DATABASES["default"]["OPTIONS"] = {"options": "-c timezone=UTC"}
|
|
|
|
# =============================================================================
|
|
# Cache — Redis
|
|
# =============================================================================
|
|
CACHES = {
|
|
"default": {
|
|
"BACKEND": "django.core.cache.backends.redis.RedisCache",
|
|
"LOCATION": env("REDIS_URL"),
|
|
}
|
|
}
|
|
|
|
# =============================================================================
|
|
# Celery — all CELERY_* prefixed settings are picked up by
|
|
# app.config_from_object("django.conf:settings", namespace="CELERY")
|
|
# =============================================================================
|
|
CELERY_BROKER_URL = env("CELERY_BROKER_URL")
|
|
CELERY_RESULT_BACKEND = "django-db"
|
|
CELERY_CACHE_BACKEND = "default"
|
|
CELERY_BEAT_SCHEDULER = "django_celery_beat.schedulers:DatabaseScheduler"
|
|
CELERY_TASK_SERIALIZER = "json"
|
|
CELERY_RESULT_SERIALIZER = "json"
|
|
CELERY_ACCEPT_CONTENT = ["json"]
|
|
CELERY_TIMEZONE = "UTC"
|
|
CELERY_TASK_TRACK_STARTED = True
|
|
CELERY_TASK_TIME_LIMIT = 300
|
|
CELERY_TASK_SOFT_TIME_LIMIT = 270
|
|
CELERY_WORKER_MAX_TASKS_PER_CHILD = 100
|
|
|
|
# =============================================================================
|
|
# Django REST Framework
|
|
# =============================================================================
|
|
REST_FRAMEWORK = {
|
|
"DEFAULT_AUTHENTICATION_CLASSES": [
|
|
"rest_framework.authentication.SessionAuthentication",
|
|
],
|
|
"DEFAULT_PERMISSION_CLASSES": [
|
|
"rest_framework.permissions.IsAuthenticated",
|
|
],
|
|
"DEFAULT_SCHEMA_CLASS": "drf_spectacular.openapi.AutoSchema",
|
|
"DEFAULT_FILTER_BACKENDS": [
|
|
"django_filters.rest_framework.DjangoFilterBackend",
|
|
"rest_framework.filters.SearchFilter",
|
|
"rest_framework.filters.OrderingFilter",
|
|
],
|
|
"DEFAULT_PAGINATION_CLASS": "rest_framework.pagination.PageNumberPagination",
|
|
"PAGE_SIZE": 50,
|
|
}
|
|
|
|
# =============================================================================
|
|
# drf-spectacular — OpenAPI schema
|
|
# =============================================================================
|
|
SPECTACULAR_SETTINGS = {
|
|
"TITLE": "LabGraph API",
|
|
"DESCRIPTION": "HomeLab infrastructure documentation engine — graph-based inventory and monitoring.",
|
|
"VERSION": "1.0.0",
|
|
"SERVE_INCLUDE_SCHEMA": False,
|
|
}
|
|
|
|
# =============================================================================
|
|
# CORS
|
|
# =============================================================================
|
|
CORS_ALLOW_CREDENTIALS = True
|
|
|
|
# =============================================================================
|
|
# Static & media files
|
|
# =============================================================================
|
|
STATIC_URL = "/static/"
|
|
STATIC_ROOT = BASE_DIR / "staticfiles"
|
|
MEDIA_URL = "/media/"
|
|
MEDIA_ROOT = BASE_DIR / "mediafiles"
|
|
|
|
# =============================================================================
|
|
# Internationalisation
|
|
# =============================================================================
|
|
LANGUAGE_CODE = "en-us"
|
|
TIME_ZONE = "UTC"
|
|
USE_I18N = True
|
|
USE_TZ = True
|
|
|
|
# =============================================================================
|
|
# Default primary key
|
|
# =============================================================================
|
|
DEFAULT_AUTO_FIELD = "django.db.models.BigAutoField"
|
|
|
|
# =============================================================================
|
|
# Password validation
|
|
# =============================================================================
|
|
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"},
|
|
]
|