Files
govoplan-postbox/tests/test_interface_documentation_contract.py
T
zemion b24d291cc8
Module Package Release / publish-packages (push) Successful in 12s
docs(postbox): complete German reference coverage
2026-08-22 06:50:34 +02:00

83 lines
3.5 KiB
Python

from __future__ import annotations
import unittest
from pathlib import Path
from govoplan_postbox.backend.manifest import manifest
REPOSITORY_ROOT = Path(__file__).resolve().parents[1]
class PostboxInterfaceDocumentationContractTests(unittest.TestCase):
def test_public_topics_have_complete_german_coverage(self) -> None:
topics = manifest.documentation
self.assertEqual(9, len(topics))
for topic in topics:
translation = topic.translations["de"]
self.assertEqual({"title", "summary", "body"}, set(translation))
self.assertTrue(
all(str(translation[field]).strip() for field in translation)
)
def test_route_and_contributed_surfaces_remain_declared(self) -> None:
frontend = manifest.frontend
self.assertIsNotNone(frontend)
self.assertEqual(
{"/postbox"},
{route.path for route in frontend.routes}, # type: ignore[union-attr]
)
self.assertEqual(
{
"postbox.admin.templates",
"postbox.inbox.directory",
"postbox.inbox.messages",
"postbox.quick_access.messages",
"postbox.widget.inbox",
},
{surface.id for surface in frontend.view_surfaces}, # type: ignore[union-attr]
)
self.assertTrue(all(item.icon == "inbox" for item in manifest.nav_items))
def test_topics_publish_stable_help_privacy_and_consequence_metadata(self) -> None:
topics = {topic.id: topic for topic in manifest.documentation}
self.assertIn("postbox.function-bound-containers", topics)
self.assertIn("postbox.reference.fields-and-consequences", topics)
guide = topics["postbox.function-bound-containers"]
self.assertIn("postbox.inbox.messages", guide.metadata["help_contexts"])
self.assertIn("postbox.state.unavailable", guide.metadata["help_contexts"])
self.assertGreaterEqual(len(guide.metadata["privacy_notes"]), 3)
reference = topics["postbox.reference.fields-and-consequences"]
self.assertIn("postbox.field.classification", reference.metadata["help_contexts"])
self.assertIn("postbox.action.delete-grouping", reference.metadata["help_contexts"])
self.assertIn("archive_postbox", reference.metadata["consequence_classes"])
self.assertIn("withdraw_or_expire", reference.metadata["consequence_classes"])
quick_tool = manifest.frontend.quick_access_tools[0]
self.assertEqual(("postbox.message",), quick_tool.returned_reference_kinds)
self.assertEqual("postbox.quick_access.messages", quick_tool.help_context_id)
self.assertEqual("/postbox", quick_tool.full_page_path)
def test_quick_access_is_bounded_and_owner_launched(self) -> None:
quick_access = (
REPOSITORY_ROOT / "webui/src/features/postbox/PostboxQuickAccess.tsx"
).read_text(encoding="utf-8")
page = (
REPOSITORY_ROOT / "webui/src/features/postbox/PostboxPage.tsx"
).read_text(encoding="utf-8")
self.assertIn("const MESSAGE_LIMIT = 7", quick_access)
self.assertIn('"unread"', quick_access)
self.assertIn('kind: "message"', quick_access)
self.assertIn("launchContext.actingContext", quick_access)
self.assertIn("quickAccessLaunchState(launchContext)", quick_access)
self.assertIn('parameters.get("quickAction") !== "compose"', page)
self.assertIn("openComposeFor(postbox)", page)
if __name__ == "__main__":
unittest.main()