TG-162 Add API support

Author: niccolomineo

{{cookiecutter.project_dirname}}/.env_template

@@ -15,4 +15,5 @@ [email protected]
 DJANGO_SUPERUSER_PASSWORD={{ cookiecutter.project_slug }}
 DJANGO_SUPERUSER_USERNAME=${USER}
 EMAIL_URL=console:///
+DJANGO_ENABLE_API_DOC=True
 PYTHONBREAKPOINT=ipdb.set_trace

{{cookiecutter.project_dirname}}/docker-compose.yaml

@@ -19,6 +19,7 @@ services:
       - DJANGO_CONFIGURATION=${DJANGO_CONFIGURATION:-Remote}
       - DJANGO_DEBUG
       - DJANGO_DEFAULT_FROM_EMAIL
+      - DJANGO_ENABLE_API_DOC
       - DJANGO_SECRET_KEY
       - DJANGO_SERVER_EMAIL
       - DJANGO_SESSION_COOKIE_DOMAIN

{{cookiecutter.project_dirname}}/pacts/handler.py

@@ -1,4 +1,4 @@
-"""Define pacts provider state handler."""
+"""Pacts provider state handler."""
 
 import re
 from datetime import datetime

{{cookiecutter.project_dirname}}/pacts/verify_pacts.py

@@ -1,4 +1,4 @@
-"""Define tests to verify pacts."""
+"""Tests to verify pacts."""
 
 from django.utils.module_loading import autodiscover_modules
 

{{cookiecutter.project_dirname}}/requirements/common.in

@@ -1,2 +1,6 @@
 # pip-compile --output-file common.txt common.in
 -r base.in
+django-cors-headers~=3.11.0
+djangorestframework-camel-case~=1.3.0
+djangorestframework~=3.13.0
+drf-spectacular~=0.22.0

{{cookiecutter.project_dirname}}/terraform/main.tf

@@ -89,9 +89,10 @@ resource "kubernetes_secret_v1" "env" {
 
   data = { for k, v in merge(
     {
-      DJANGO_SECRET_KEY = random_password.django_secret_key.result
-      EMAIL_URL         = var.email_url
-      SENTRY_DSN        = var.sentry_dsn
+      DJANGO_SECRET_KEY        = random_password.django_secret_key.result
+      DJANGO_ENABLE_API_DOC    = var.environment_slug == "prod" ? "False" : "True"
+      EMAIL_URL                = var.email_url
+      SENTRY_DSN               = var.sentry_dsn
     },
     local.use_s3 ? {
       AWS_ACCESS_KEY_ID     = var.s3_bucket_access_id

{{cookiecutter.project_dirname}}/{{cookiecutter.django_settings_dirname}}/settings.py

@@ -47,9 +47,13 @@ class ProjectDefault(Configuration):
         "django.contrib.sessions",
         "django.contrib.messages",
         "django.contrib.staticfiles",
+        "rest_framework",
+        "cors_headers",
+        "drf_spectacular",
     ]
 
     MIDDLEWARE = [
+        "corsheaders.middleware.CorsMiddleware",
         "django.middleware.security.SecurityMiddleware",
         "django.contrib.sessions.middleware.SessionMiddleware",
         "django.middleware.common.CommonMiddleware",
@@ -181,6 +185,56 @@ class ProjectDefault(Configuration):
 
     SECURE_PROXY_SSL_HEADER = ("HTTP_X_FORWARDED_PROTO", "https")
 
+    # Django REST Framework
+    # https://www.django-rest-framework.org/api-guide/settings/
+
+    REST_FRAMEWORK: dict = {
+        "DEFAULT_AUTHENTICATION_CLASSES": [
+            "rest_framework.authentication.SessionAuthentication",
+        ],
+        "DEFAULT_FILTER_BACKENDS": [
+            "django_filters.rest_framework.DjangoFilterBackend"
+        ],
+        "DEFAULT_PARSER_CLASSES": [
+            "djangorestframework_camel_case.parser.CamelCaseMultiPartParser",
+            "djangorestframework_camel_case.parser.CamelCaseJSONParser",
+        ],
+        "DEFAULT_PERMISSION_CLASSES": ["rest_framework.permissions.IsAuthenticated"],
+        "DEFAULT_RENDERER_CLASSES": [
+            "djangorestframework_camel_case.render.CamelCaseJSONRenderer",
+        ],
+        "DEFAULT_SCHEMA_CLASS": "drf_spectacular.openapi.AutoSchema",
+    }
+
+    # Django CORS Headers
+    # https://github.com/adamchainz/django-cors-headers
+
+    CORS_ALLOW_ALL_ORIGINS = True
+
+    # API Documentation
+
+    ENABLE_API_DOC = values.BooleanValue(False)
+
+    # drf-spectacular
+    # https://drf-spectacular.readthedocs.io/en/latest/
+
+    SPECTACULAR_SETTINGS = {
+        "TITLE": "{{ cookiecutter.project_name }}",
+        "DESCRIPTION": "API Documentation",
+        "VERSION": "1.0.0",
+        "CAMELIZE_NAMES": True,
+        "SWAGGER_UI_SETTINGS": {
+            "deepLinking": True,
+            "displayRequestDuration": True,
+            "persistAuthorization": True,
+            "syntaxHighlight.activate": True,
+        },
+        "POSTPROCESSING_HOOKS": [
+            "drf_spectacular.hooks.postprocess_schema_enums",
+            "drf_spectacular.contrib.djangorestframework_camel_case.camelize_serializer_fields",  # noqa
+        ],
+    }
+
 
 class Local(ProjectDefault):
     """The local settings."""
@@ -251,6 +305,18 @@ class Local(ProjectDefault):
             "verbose_names": True,
         }
 
+    # Django REST Framework
+    # https://www.django-rest-framework.org/api-guide/settings/
+
+    REST_FRAMEWORK = {
+        **ProjectDefault.REST_FRAMEWORK,
+        "DEFAULT_RENDERER_CLASSES": [
+            *ProjectDefault.REST_FRAMEWORK["DEFAULT_RENDERER_CLASSES"],
+            "djangorestframework_camel_case.render.CamelCaseBrowsableAPIRenderer",
+        ],
+    }
+
+
 
 class Testing(ProjectDefault):
     """The testing settings."""
@@ -318,13 +384,15 @@ class Testing(ProjectDefault):
 class Remote(ProjectDefault):
     """The remote settings."""
 
+    # Application definition
+
+    MIDDLEWARE = ProjectDefault.MIDDLEWARE.copy()
+
     # Debug
     # https://docs.djangoproject.com/en/stable/ref/settings/#debug
 
     DEBUG = False
 
-    MIDDLEWARE = ProjectDefault.MIDDLEWARE.copy()
-
     # Email URL
     # https://django-configurations.readthedocs.io/en/stable/values/
 

{{cookiecutter.project_dirname}}/{{cookiecutter.django_settings_dirname}}/urls.py

@@ -23,6 +23,21 @@
 
 urlpatterns = [
     path("admin/", admin.site.urls),
+    path(
+        "api/",
+        include(
+            (
+                [
+                    *(
+                        [path("", include("{{ cookiecutter.project_slug }}.urls_apibrowser"))]
+                        if settings.ENABLE_API_DOC
+                        else []
+                    ),
+                ],
+                "api",
+            )
+        ),
+    ),
 ]
 
 if settings.DEBUG:  # pragma: no cover

{{cookiecutter.project_dirname}}/{{cookiecutter.django_settings_dirname}}/urls_apibrowser.py

@@ -0,0 +1,36 @@
+"""API browser URL configuration."""
+
+from django.contrib.admin.views.decorators import staff_member_required
+from django.urls import include, path
+from drf_spectacular.views import SpectacularAPIView, SpectacularSwaggerView
+
+urlpatterns = [
+    path(
+        "browser/",
+        include(
+            (
+                [
+                    path(
+                        "schema/",
+                        staff_member_required(
+                            SpectacularAPIView.as_view(
+                                urlconf="{{ cookiecutter.project_slug }}.urls"
+                            )
+                        ),
+                        name="schema",
+                    ),
+                    path(
+                        "docs/",
+                        staff_member_required(
+                            SpectacularSwaggerView.as_view(
+                                url_name="api:browser:schema"
+                            )
+                        ),
+                        name="docs",
+                    ),
+                ],
+                "browser",
+            ),
+        ),
+    )
+]