simple-module-hosting 0.0.20__tar.gz → 0.0.22__tar.gz

{simple_module_hosting-0.0.20 → simple_module_hosting-0.0.22}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: simple_module_hosting
-Version: 0.0.20
+Version: 0.0.22
 Summary: FastAPI + Inertia.js host runtime for simple_module — app_builder, middleware stack, CLI (sm / simple-module), scaffolding
 Project-URL: Homepage, https://github.com/antosubash/simple_module_python
 Project-URL: Repository, https://github.com/antosubash/simple_module_python
@@ -26,8 +26,8 @@ Requires-Dist: fastapi-inertia>=1.0
 Requires-Dist: fastapi>=0.115
 Requires-Dist: httpx>=0.27
 Requires-Dist: jinja2>=3.1
-Requires-Dist: simple-module-core==0.0.20
-Requires-Dist: simple-module-db==0.0.20
+Requires-Dist: simple-module-core==0.0.22
+Requires-Dist: simple-module-db==0.0.22
 Requires-Dist: starlette>=0.44
 Requires-Dist: tomlkit>=0.13
 Requires-Dist: uvicorn[standard]>=0.34

{simple_module_hosting-0.0.20 → simple_module_hosting-0.0.22}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "simple_module_hosting"
-version = "0.0.20"
+version = "0.0.22"
 description = "FastAPI + Inertia.js host runtime for simple_module — app_builder, middleware stack, CLI (sm / simple-module), scaffolding"
 readme = "README.md"
 license = "MIT"
@@ -26,8 +26,8 @@ dependencies = [
     "fastapi-inertia>=1.0",
     "httpx>=0.27",
     "jinja2>=3.1",
-    "simple_module_core==0.0.20",
-    "simple_module_db==0.0.20",
+    "simple_module_core==0.0.22",
+    "simple_module_db==0.0.22",
     "starlette>=0.44",
     "tomlkit>=0.13",
     "uvicorn[standard]>=0.34",

{simple_module_hosting-0.0.20 → simple_module_hosting-0.0.22}/simple_module_hosting/_inertia_setup.py

@@ -10,6 +10,7 @@ from pathlib import Path
 
 from fastapi import FastAPI
 from inertia import InertiaConfig, inertia_dependency_factory
+from starlette.requests import Request
 
 from simple_module_hosting.settings import Settings
 
@@ -19,6 +20,33 @@ _INERTIA_VERSION = "1.0"
 _ROOT_TEMPLATE_FILENAME = "index.html"
 _ENTRYPOINT_FILENAME = "main.tsx"
 _ROOT_DIRECTORY = "."
+
+# Fallback app name when the (optional) branding module isn't installed. Mirrors
+# branding's own default so the unbranded title is identical everywhere.
+_DEFAULT_APP_NAME = "SimpleModule"
+
+
+def branding_head(request: Request) -> dict:
+    """Branding metadata for the root template's ``<head>``.
+
+    Reads the optional branding module's settings off ``app.state`` by name
+    (duck-typed, never imported) so the static ``<title>`` and ``theme-color``
+    are already branded *before* React hydrates. Degrades to the framework
+    default when branding isn't installed. Only plain settings strings are
+    surfaced here — the favicon is applied client-side by ``BrandingHead`` via
+    Inertia's ``<Head>``, keeping file_storage's download-route shape out of
+    framework code.
+    """
+    services = getattr(request.app.state, "branding", None)
+    settings = getattr(services, "settings", None)
+    if settings is None:
+        return {"app_name": _DEFAULT_APP_NAME, "theme_color": None}
+    return {
+        "app_name": getattr(settings, "app_name", "") or _DEFAULT_APP_NAME,
+        "theme_color": getattr(settings, "primary_color", "") or None,
+    }
+
+
 # Built assets are served from the "/static" mount under "dist/", so production
 # asset URLs are prefixed with "static/dist".
 _ASSETS_PREFIX = "static/dist"
@@ -120,6 +148,8 @@ def setup_inertia(
         return None
 
     templates = Jinja2Templates(directory=directories)
+    # Expose branding metadata to the root template (pre-hydration head tags).
+    templates.env.globals["branding_head"] = branding_head
 
     # fastapi-inertia only switches to the asset manifest when environment
     # equals the literal string "production". Anything else (staging, qa,

simple_module_hosting-0.0.22/tests/test_branding_head.py

@@ -0,0 +1,32 @@
+"""Tests for the root-template branding head metadata helper."""
+
+from __future__ import annotations
+
+from types import SimpleNamespace
+
+from simple_module_hosting._inertia_setup import branding_head
+
+
+def _request(branding: object | None) -> SimpleNamespace:
+    state = SimpleNamespace()
+    if branding is not None:
+        state.branding = branding
+    return SimpleNamespace(app=SimpleNamespace(state=state))
+
+
+def test_defaults_when_branding_not_installed() -> None:
+    meta = branding_head(_request(None))
+    assert meta == {"app_name": "SimpleModule", "theme_color": None}
+
+
+def test_reads_app_name_and_theme_color() -> None:
+    settings = SimpleNamespace(app_name="Acme", primary_color="#1a7dd1")
+    meta = branding_head(_request(SimpleNamespace(settings=settings)))
+    assert meta["app_name"] == "Acme"
+    assert meta["theme_color"] == "#1a7dd1"
+
+
+def test_blank_values_fall_back() -> None:
+    settings = SimpleNamespace(app_name="", primary_color="")
+    meta = branding_head(_request(SimpleNamespace(settings=settings)))
+    assert meta == {"app_name": "SimpleModule", "theme_color": None}