create-caspian-app 1.6.4 → 1.8.1

package/dist/settings/build-static.py

@@ -46,6 +46,8 @@ sys.path.insert(0, str(ROOT))
 # Keep the app in non-production mode: dev generates an ephemeral session secret,
 # so the build does not require production secrets to be present.
 os.environ.setdefault("APP_ENV", "development")
+# Starting the app's lifespan for the export must not start the task scheduler.
+os.environ["CASPIAN_STATIC_EXPORT"] = "1"
 
 import httpx2  # noqa: E402  (the app's HTTP client; drives the ASGI app in-process)
 
@@ -96,8 +98,12 @@ def _fill_rule(fastapi_rule: str, params) -> str:
         params = {names[0]: params} if names else {}
     url = fastapi_rule
     for key, value in params.items():
+        if value is None or value == "":
+            # An optional catch-all (`[[...slug]]`) exports its base URL.
+            url = url.replace(f"/{{{key}:path}}", "")
+            continue
         url = url.replace(f"{{{key}:path}}", str(value)).replace(f"{{{key}}}", str(value))
-    return url
+    return url or "/"
 
 
 def _out_path_for(url_path: str) -> Path:
@@ -242,6 +248,19 @@ def build() -> int:
 
                     await export_one(client, url)
 
+                # sitemap.py / robots.py -> static/sitemap.xml, static/robots.txt
+                for url in getattr(main, "SEO_ROUTES", []):
+                    resp = await client.get(url)
+                    if resp.status_code != 200:
+                        skipped.append((url, f"returned HTTP {resp.status_code}"))
+                        continue
+                    out_file = OUT_DIR / url.lstrip("/")
+                    out_file.write_text(resp.text, encoding="utf-8")
+                    exported.append(url)
+                    if not os.getenv("APP_BASE_URL"):
+                        seo_warnings.append(url)
+
+    seo_warnings: list[str] = []
     asyncio.run(render_all())
 
     _copy_assets()
@@ -249,9 +268,20 @@ def build() -> int:
     # ---- Report ----
     print(f"\n{GREEN}Exported {len(exported)} page(s):{RESET}")
     for url in exported:
-        rel = _out_path_for(url).relative_to(ROOT)
+        target = (
+            OUT_DIR / url.lstrip("/")
+            if url in getattr(main, "SEO_ROUTES", [])
+            else _out_path_for(url)
+        )
+        rel = target.relative_to(ROOT)
         print(f"  {GREEN}OK{RESET}  {url}  ->  {rel}")
 
+    if seo_warnings:
+        print(
+            f"\n{YELLOW}Note: APP_BASE_URL is not set{RESET}{DIM} -- {', '.join(seo_warnings)} "
+            "contain http://testserver URLs. Set APP_BASE_URL to the public origin and rebuild.{RESET}"
+        )
+
     if rpc_warnings:
         print(f"\n{YELLOW}Note: these pages appear to use pp.rpc()/server actions{RESET}")
         print(f"{DIM}  (they render, but those interactions are dead without the backend):{RESET}")