Introduce jinja templating and nhs_frontend_jinja

Author: Themitchell

lung_cancer_screening/core/jinja2/home/index.jinja

@@ -0,0 +1 @@
+<h1>hello world</h1>

lung_cancer_screening/jinja2_env.py

@@ -0,0 +1,22 @@
+from jinja2 import ChoiceLoader, Environment, PackageLoader
+
+def environment(**options):
+
+    env = Environment(**options, extensions=["jinja2.ext.do"])
+    if env.loader:
+        env.loader = ChoiceLoader(
+            [
+                env.loader,
+                PackageLoader(
+                    "nhsuk_frontend_jinja",
+                    package_path="templates/components"
+                ),
+                PackageLoader(
+                    "nhsuk_frontend_jinja",
+                    package_path="templates/macros"
+                ),
+                PackageLoader("nhsuk_frontend_jinja"),
+            ]
+        )
+
+    return env

lung_cancer_screening/settings.py

@@ -13,6 +13,7 @@
 from os import environ
 from pathlib import Path
 
+from jinja2 import ChainableUndefined
 
 def boolean_env(key, default=None):
     value = environ.get(key)
@@ -44,6 +45,7 @@ def boolean_env(key, default=None):
     'django.contrib.sessions',
     'django.contrib.messages',
     'django.contrib.staticfiles',
+    'lung_cancer_screening.core'
 ]
 
 MIDDLEWARE = [
@@ -59,6 +61,15 @@ def boolean_env(key, default=None):
 ROOT_URLCONF = 'lung_cancer_screening.urls'
 
 TEMPLATES = [
+    {
+        "BACKEND": "django.template.backends.jinja2.Jinja2",
+        "DIRS": [BASE_DIR / "jinja2"],
+        "APP_DIRS": True,
+        "OPTIONS": {
+            "environment": "lung_cancer_screening.jinja2_env.environment",
+            "undefined": ChainableUndefined,
+        },
+    },
     {
         'BACKEND': 'django.template.backends.django.DjangoTemplates',
         'DIRS': [],

lung_cancer_screening/views.py

@@ -1,5 +1,7 @@
-from django.http import HttpResponse
+from django.shortcuts import render
 
 def home(request):
-    """Homepage view that displays hello world."""
-    return HttpResponse("hello world")
+    return render(
+        request,
+        "home/index.jinja"
+    )

makefiles/dev.mk

@@ -1,5 +1,8 @@
 .PHONY: dev-run dev-up dev-down dev-logs dev-shell dev-migrate dev-makemigrations dev-clean dev-test
 
+dev-build:
+	docker-compose build
+
 dev-run:
 	docker-compose up --build
 

requirements.txt

@@ -1,2 +1,3 @@
 django
 psycopg2-binary
+nhsuk-frontend-jinja