feat: support announcement banner (defined in afterpython.toml)

Author: softwareentrepreneer

afterpython/afterpython.toml

@@ -9,6 +9,7 @@ favicon = "favicon.ico"
 logo = "logo.svg"
 logo_dark = "logo.svg"
 thumbnail = "thumbnail.png"  # thumbnail for the website, also used as default thumbnail for all content types, e.g. blog posts, tutorials, examples, and guides
+announcement = ""
 
 # [website.blog]
 # thumbnail = "blog_default_thumbnail.png"  # inside blog/static/ folder, default thumbnail for blog posts

src/afterpython/builders/metadata.py

@@ -36,15 +36,26 @@ def convert_paths():
 
 
 def build_metadata():
-    """Build metadata.json using pyproject.toml"""
+    """Build metadata.json using pyproject.toml + afterpython.toml.
+
+    Adds an `announcement` field (markdown string) sourced from
+    `[website].announcement` in afterpython.toml, so the frontend can render
+    a top-of-site banner. Empty/missing announcement → empty string.
+    """
+    from afterpython._io.toml import _from_tomlkit
+    from afterpython.tools._afterpython import read_afterpython
     from afterpython.tools.pyproject import read_metadata
 
     click.echo("Building metadata.json...")
 
     metadata: StandardMetadata = read_metadata()
+    metadata_json = metadata.as_json()
+
+    afterpython = read_afterpython()
+    website = _from_tomlkit(afterpython.get("website", {}))
+    metadata_json["announcement"] = str(website.get("announcement", "")).strip()
 
-    # Write to metadata.json
     with open(build_path / "metadata.json", "w") as f:
-        json.dump(metadata.as_json(), f, indent=2)
+        json.dump(metadata_json, f, indent=2)
 
     convert_paths()