"""Blog app fragment endpoints. Exposes HTML fragments at ``/internal/fragments/`` for consumption by other coop apps via the fragment client. """ from __future__ import annotations from quart import Blueprint, Response, g, render_template, request from shared.infrastructure.fragments import FRAGMENT_HEADER from shared.services.navigation import get_navigation_tree from shared.sexp.jinja_bridge import sexp def register(): bp = Blueprint("fragments", __name__, url_prefix="/internal/fragments") # Registry of fragment handlers: type -> async callable returning HTML str _handlers: dict[str, object] = {} @bp.before_request async def _require_fragment_header(): if not request.headers.get(FRAGMENT_HEADER): return Response("", status=403) @bp.get("/") async def get_fragment(fragment_type: str): handler = _handlers.get(fragment_type) if handler is None: return Response("", status=200, content_type="text/html") html = await handler() return Response(html, status=200, content_type="text/html") # --- nav-tree fragment --- async def _nav_tree_handler(): app_name = request.args.get("app_name", "") path = request.args.get("path", "/") first_seg = path.strip("/").split("/")[0] menu_items = list(await get_navigation_tree(g.s)) # Append Art-DAG as a synthetic nav entry (not a DB MenuNode) class _NavItem: __slots__ = ("slug", "label", "feature_image") def __init__(self, slug, label, feature_image=None): self.slug = slug self.label = label self.feature_image = feature_image menu_items.append(_NavItem("artdag", "art-dag")) return await render_template( "fragments/nav_tree.html", menu_items=menu_items, frag_app_name=app_name, frag_first_seg=first_seg, ) _handlers["nav-tree"] = _nav_tree_handler # --- link-card fragment (s-expression rendered) --- def _render_blog_link_card(post, link: str) -> str: """Render a blog link-card via the ~link-card s-expression component.""" published = post.published_at.strftime("%d %b %Y") if post.published_at else None return sexp( '(~link-card :link link :title title :image image' ' :icon "fas fa-file-alt" :subtitle excerpt' ' :detail published :data-app "blog")', link=link, title=post.title, image=post.feature_image, excerpt=post.custom_excerpt or post.excerpt, published=published, ) async def _link_card_handler(): from shared.services.registry import services from shared.infrastructure.urls import blog_url slug = request.args.get("slug", "") keys_raw = request.args.get("keys", "") # Batch mode if keys_raw: slugs = [k.strip() for k in keys_raw.split(",") if k.strip()] parts = [] for s in slugs: parts.append(f"") post = await services.blog.get_post_by_slug(g.s, s) if post: parts.append(_render_blog_link_card(post, blog_url(f"/{post.slug}"))) return "\n".join(parts) # Single mode if not slug: return "" post = await services.blog.get_post_by_slug(g.s, slug) if not post: return "" return _render_blog_link_card(post, blog_url(f"/{post.slug}")) _handlers["link-card"] = _link_card_handler # Store handlers dict on blueprint so app code can register handlers bp._fragment_handlers = _handlers return bp