chore: merge origin/main

tests/test_site_nav.py

@@ -332,6 +332,28 @@ class PlatformShareCards(unittest.TestCase):
         self.assertEqual(sitestarlight.og_image("systems/no-such-maker.md", "explore"),
                          f"{sitestarlight.SITE_URL}assets/og/explore.png")
 
+    def test_an_emulator_page_shares_its_makers_card(self):
+        """Every emulator page shared the generic Explore card."""
+        saved = dict(sitestarlight.EMULATOR_CARDS)
+        self.addCleanup(lambda: (sitestarlight.EMULATOR_CARDS.clear(),
+                                 sitestarlight.EMULATOR_CARDS.update(saved)))
+        sitestarlight.EMULATOR_CARDS.update({"emulators/mgba": "nintendo", "emulators/odd": "no-such-maker"})
+        self.assertEqual(sitestarlight.og_image("emulators/mgba.mdx", "explore"),
+                         f"{sitestarlight.SITE_URL}assets/og/systems/nintendo.png")
+        self.assertEqual(sitestarlight.og_image("emulators/odd.md", "explore"),
+                         f"{sitestarlight.SITE_URL}assets/og/explore.png")
+
+    def test_a_shared_link_reads_the_search_title(self):
+        """og:title was the H1, "mGBA", under a result titled "mGBA BIOS files"."""
+        head = sitestarlight.page_head("emulators/mgba.md", "explore", "mGBA", "mGBA BIOS files", {})
+        shared = {tag["attrs"].get("property") or tag["attrs"].get("name"): tag["attrs"]["content"]
+                  for tag in head if tag.get("attrs", {}).get("content") and tag["tag"] == "meta"}
+        self.assertEqual(shared["og:title"], "mGBA BIOS files")
+        self.assertEqual(shared["twitter:title"], "mGBA BIOS files")
+        plain = sitestarlight.page_head("wiki/faq.md", "start", "FAQ", "FAQ", {})
+        self.assertFalse(any(tag.get("attrs", {}).get("property") == "og:title" for tag in plain))
+
+
 
 # The built site
 

tests/test_site_search.py

@@ -264,6 +264,13 @@ class Descriptions(unittest.TestCase):
         self.assertLessEqual(len(text), 155)
         self.assertFalse(text.endswith("..."), text)
 
+    def test_a_switch_emulator_reads_keys(self) -> None:
+        self.assertEqual(gs._snippet_noun(["prod.keys", "dev.keys", "title.keys", "key_retail.bin"], 4, 4), "keys")
+        self.assertEqual(gs._snippet_noun(["prod.keys", "title.keys", "<firmware>.zip", "a.txt"], 3, 4),
+                         "keys and firmware")
+        self.assertEqual(gs._snippet_noun(["gba_bios.bin", "gb_bios.bin"], 2, 2), "BIOS")
+        self.assertEqual(gs._snippet_noun(["oot.z64", "oot-mq.z64", "font.bin"], 1, 3), "files")
+
     def test_an_any_name_snippet_says_what_to_do(self) -> None:
         saved = dict(gs.PAGE_DATA)
         self.addCleanup(lambda: (gs.PAGE_DATA.clear(), gs.PAGE_DATA.update(saved)))
@@ -357,6 +364,15 @@ class GetPagesSitInYourSetup(unittest.TestCase):
             with self.subTest(page=rel):
                 self.assertIn("/" + sitestarlight._sidebar_link(rel).strip("/"), setup)
 
+    def test_a_get_page_is_dated_by_its_release(self):
+        """The sitemap gave no date to the pages that change only with a release."""
+        saved = dict(gs.PAGE_DATA)
+        self.addCleanup(lambda: (gs.PAGE_DATA.clear(), gs.PAGE_DATA.update(saved)))
+        record = json.loads((REPO_ROOT / "release.json").read_text(encoding="utf-8"))
+        tag = re.fullmatch(r"v(\d{4})\.(\d{2})\.(\d{2})", record["tag"])
+        gs.generate_get_page("retroarch")
+        self.assertEqual(gs.PAGE_DATA["get/retroarch.md"], {"dateModified": "-".join(tag.groups())})
+
     def test_no_page_is_left_out_of_every_tab(self):
         nav = _nav()
         present = _present(nav) | {"orphans/alone.md"}