Refactor texts app: jinja2, JSON helpers, tests

Reorganize and modernize the texts app: rename app package to 'swing_text', add a Jinja2 environment, and move/rename template files into a dedicated jinja2 package. Replace real site/contact values with example.com and update manifest/robots/security/humans entries. Rewrite helper_json with pathlib, UTF-8 handling and type hints; add read_json/write_json helpers. Update views to load brand, social and meta data from JSON and surface richer context (current_year, site, site_contact, social, meta). Extend URL patterns (additional text endpoints and manifest.json alias) and add comprehensive pytest-based tests for helpers, URLs and views. Remove legacy duplicate template files.

Author: vanvianen

src/swing_text/apps.py

@@ -23,7 +23,6 @@
 # =============================================================================
 
 # Import | Standard Library
-from typing import Dict, List, Union
 
 
 # Import | Libraries
@@ -45,9 +44,8 @@ class TextsConfig(AppConfig):
     """
 
 
-
     # Full Python path to the application
-    name = "website.texts"
+    name = "swing_text"
 
     # Short name for the application
     label = "texts"
@@ -67,7 +65,7 @@ class TextsConfig(AppConfig):
     #     """
     #     Apps Config Ready Function
     #     """
-        
+
         # Implicitly connect signal handlers decorated with @receiver.
         # from .. import signals
 

src/swing_text/data/_brand.json

@@ -11,16 +11,16 @@
         "contact" : {
             "url" : 
             {
-                "main" :        "https://www.starling.associates/"
+                "main" :        "https://www.example.com/"
             },
             "phone" : 
             {
                 "mobile" :       ""
             },
             "email" : 
             {
-                "main" :        "info@starling.associates",
-                "people" :        "people@starling.associates"
+                "main" :        "info@example.com",
+                "people" :        "people@example.com"
             },
             "locations" : 
             [
@@ -34,8 +34,8 @@
                     "province":         "Noord-Holland",
                     "country":          "The Netherlands",
                     "phone":            "+31 (0)20 2234658",
-                    "email":            "info@starling.associates",
-                    "image" :           "locations/starling_amsterdam.jpg",
+                    "email":            "info@example.com",
+                    "image" :           "locations/office_amsterdam.jpg",
                     "google_map" :      "https://www.google.com/maps/embed?pb=!1m18!1m12!1m3!1d1084.9204347769628!2d4.864936721209129!3d52.37832244426546!2m3!1f0!2f0!3f0!3m2!1i1024!2i768!4f13.1!3m3!1m2!1s0x47c5e30cdb797ce1%3A0xc64f2837b3ae5f2b!2sCentrale%20Markthal!5e0!3m2!1snl!2snl!4v1663139258129!5m2!1snl!2snl",
                     "description" :     ""
                 },   
@@ -49,8 +49,8 @@
                     "province":         "Zuid-Holland",
                     "country":          "The Netherlands",
                     "phone":            "",
-                    "email":            "info@starling.associates",
-                    "image" :           "locations/starling_rotterdam.jpg",
+                    "email":            "info@example.com",
+                    "image" :           "locations/office_rotterdam.jpg",
                     "google_map" :      "https://www.google.com/maps/embed?pb=!1m14!1m8!1m3!1d615.0817345682342!2d4.4751986!3d51.9279899!3m2!1i1024!2i768!4f13.1!3m3!1m2!1s0x47c434a8f77ab6ab%3A0x2de24d4210bcaffe!2sSchiekade%20830%2C%203032%20AL%20Rotterdam!5e0!3m2!1snl!2snl!4v1663139189803!5m2!1snl!2snl",
                     "description" :     ""
                 },
@@ -64,8 +64,8 @@
                     "province":         "Zuid-Holland",
                     "country":          "The Netherlands",
                     "phone":            "+31 (0)70 2051066",
-                    "email":            "info@starling.associates",
-                    "image" :           "locations/starling_the_hague.jpg",
+                    "email":            "info@example.com",
+                    "image" :           "locations/office_the_hague.jpg",
                     "google_map" :      "https://www.google.com/maps/embed?pb=!1m18!1m12!1m3!1d153.22948806145547!2d4.310559007340239!3d52.08570400000001!2m3!1f0!2f0!3f0!3m2!1i1024!2i768!4f13.1!3m3!1m2!1s0x47c5b73a23fb7c35%3A0xbd5a40c493150b3!2sNieuwe%20Schoolstraat%2052%2C%202514%20HZ%20Den%20Haag!5e0!3m2!1snl!2snl!4v1663139292813!5m2!1snl!2snl",
                     "description" :     ""
                 }

src/swing_text/data/_social.json

@@ -2,62 +2,62 @@
     "social": [
         {
             "service": "500px",
-            "profile": "https://www.500px.com/p/starling-cloud",
+            "profile": "https://www.500px.com/p/example",
             "active" :  false
         },
         {
             "service": "AngelList",
-            "profile": "https://www.angel.co/starling-cloud",
+            "profile": "https://www.angel.co/example",
             "active" :  false
         },
         {
             "service": "Archinect",
-            "profile": "https://archinect.com/starling_associates",
+            "profile": "https://archinect.com/example",
             "active" :  false
         },
         {
             "service": "Crunchbase",
-            "profile": "https://www.crunchbase.com/organization/starling-cloud",
+            "profile": "https://www.crunchbase.com/organization/example",
             "active" :  false
         },
         {
             "service" : "Facebook",
-            "profile" : "https://www.facebook.com/starlingclouds",
+            "profile" : "https://www.facebook.com/example",
             "active" :  true
         },
         {
             "service": "Figma",
-            "profile": "https://www.figma.com/@starling",
+            "profile": "https://www.figma.com/@example",
             "active" :  false
         },
         {
             "service": "GitHub",
-            "profile": "https://www.github.com/starling-associates",
+            "profile": "https://www.github.com/example",
             "active" :  true
         },
         {
             "service": "Instagram",
-            "profile": "https://www.instagram.com/starling.cloud",
+            "profile": "https://www.instagram.com/example",
             "active" :  true
         },
         {
             "service": "Issuu",
-            "profile": "https://www.issuu.com/starlingcloud",
+            "profile": "https://www.issuu.com/example",
             "active" :  false
         },
         {
             "service": "LinkedIn",
-            "profile": "https://www.linkedin.com/company/starling-associates/",
+            "profile": "https://www.linkedin.com/company/example/",
             "active" :  true
         },
         {
             "service": "Pinterest",
-            "profile": "https://www.pinterest.com/starlingcloud/",
+            "profile": "https://www.pinterest.com/example/",
             "active" :  false
         },
         {
             "service": "Vimeo",
-            "profile": "https://www.vimeo.com/starlingcloud",
+            "profile": "https://www.vimeo.com/example",
             "active" :  true
         }
     ]

src/swing_text/helpers/helper_json.py

@@ -1,23 +1,32 @@
+# -*- coding: utf-8 -*-
+
+"""
+Provides JSON file I/O utilities.
+"""
+
 import json
+from pathlib import Path
+from typing import Any, Union
 
 
-def read_file(path):
-    file = open(path, "r")
-    data = file.read()
-    file.close()
-    return data
+def read_file(path: Union[str, Path]) -> str:
+    """Read content from a file."""
+    with open(path, "r", encoding="utf-8") as file:
+        return file.read()
 
 
-def read_json(path):
+def read_json(path: Union[str, Path]) -> dict[str, Any]:
+    """Read and parse JSON from a file."""
     return json.loads(read_file(path))
 
 
-def write_json(path, data):
-    return write_file(path, json.dumps(data))
+def write_file(path: Union[str, Path], data: str) -> str:
+    """Write content to a file."""
+    with open(path, "w", encoding="utf-8") as file:
+        file.write(str(data))
+    return data
 
 
-def write_file(path, data):
-    file = open(path, "w")
-    file.write(str(data))
-    file.close()
-    return data
+def write_json(path: Union[str, Path], data: dict[str, Any]) -> str:
+    """Write data as JSON to a file."""
+    return write_file(path, json.dumps(data, indent=2))

src/swing_text/jinja2.py

@@ -0,0 +1,21 @@
+# -*- coding: utf-8 -*-
+
+"""
+Provides Jinja2 environment configuration.
+"""
+
+from django.templatetags.static import static
+from django.urls import reverse
+from jinja2 import Environment
+
+
+def environment(**options):
+    """
+    Create Jinja2 environment with Django integrations.
+    """
+    env = Environment(**options)
+    env.globals.update({
+        "static": static,
+        "url": reverse,
+    })
+    return env

…ing_text/templates/_manifest.webmanifest …/swing_text/jinja2/_manifest.webmanifestsrc/swing_text/templates/_manifest.webmanifest renamed to src/swing_text/jinja2/_manifest.webmanifest src/swing_text/templates/_manifest.webmanifest renamed to src/swing_text/jinja2/_manifest.webmanifest

@@ -1,6 +1,6 @@
 {
-    "name": "Scape Agency",
-    "short_name": "Scape Agency",
+    "name": "Scape Press",
+    "short_name": "Scape Press",
     "description": "",
     "icons": [
         {
@@ -61,4 +61,4 @@
             "icons": [{ "src": "", "sizes": "" }]
         }
     ]
-}
+}