xcore-protocol 0.5.1__py3-none-any.whl

tests/test_canonical_protocol_fixtures.py

@@ -0,0 +1,171 @@
+from __future__ import annotations
+
+import json
+from collections.abc import Callable, Mapping
+from pathlib import Path
+from typing import Any
+
+import pytest
+
+from xcore_protocol.generated import (
+    ActorRefV1ActorType,
+    DiscordAdminAccessChangedCommandV1,
+    DiscordUnlinkCommandV1,
+    MetricsSnapshotV1,
+    ServerHeartbeatV1,
+)
+from xcore_protocol.paths import fixtures_root, spec_root
+from xcore_protocol.schema_validation import assert_valid
+
+
+REPO_ROOT = fixtures_root().parent
+CANONICAL_FIXTURES_ROOT = REPO_ROOT / "spec" / "fixtures" / "valid"
+
+
+def _load_fixture(path: Path) -> dict[str, Any]:
+    return json.loads(path.read_text(encoding="utf-8"))
+
+
+def _model_dump_json(model: Any) -> dict[str, Any]:
+    model_dump = getattr(model, "model_dump", None)
+    if callable(model_dump):
+        payload = model_dump(mode="json")
+        if not isinstance(payload, dict):
+            raise TypeError("model_dump(mode='json') must return a dict payload")
+        return payload
+
+    to_payload = getattr(model, "to_payload", None)
+    if callable(to_payload):
+        payload = to_payload()
+        if not isinstance(payload, dict):
+            raise TypeError("to_payload() must return a dict payload")
+        return payload
+
+    raise TypeError("Generated model must provide model_dump(mode='json') or to_payload()")
+
+
+def _assert_no_snake_case_keys(value: Any) -> None:
+    if isinstance(value, Mapping):
+        for key, nested_value in value.items():
+            assert "_" not in key, f"Found legacy snake_case key: {key}"
+            _assert_no_snake_case_keys(nested_value)
+        return
+
+    if isinstance(value, list):
+        for item in value:
+            _assert_no_snake_case_keys(item)
+
+
+CanonicalAssertion = Callable[[Any, dict[str, Any]], None]
+
+
+def _assert_admin_access_semantics(model: DiscordAdminAccessChangedCommandV1, payload: dict[str, Any]) -> None:
+    assert model.source.actorType is ActorRefV1ActorType.SYSTEM
+    assert payload["source"]["actorType"] == "system"
+    assert model.actor.actorType is ActorRefV1ActorType.DISCORD
+    assert model.actor.actorName == payload["actor"]["actorName"]
+
+
+def _assert_unlink_semantics(model: DiscordUnlinkCommandV1, payload: dict[str, Any]) -> None:
+    assert model.actor.actorType is ActorRefV1ActorType.DISCORD
+    assert model.actor.actorName == payload["actor"]["actorName"]
+    assert payload["actor"]["actorName"] == "Beta Display"
+
+
+def _assert_heartbeat_semantics(model: ServerHeartbeatV1, payload: dict[str, Any]) -> None:
+    assert model.serverName == payload["serverName"]
+    assert model.discordChannelId == payload["discordChannelId"]
+
+
+def _assert_telemetry_semantics(model: MetricsSnapshotV1, payload: dict[str, Any]) -> None:
+    assert model.server == payload["server"]
+    assert model.SCHEMA_VERSION == payload["schemaVersion"]
+    assert model.samples[2].count == payload["samples"][2]["count"]
+
+
+CANONICAL_CASES: list[tuple[str, Path, Path, type[Any], CanonicalAssertion]] = [
+    (
+        "discord_admin_access_grant",
+        spec_root() / "messages" / "discord" / "discord.admin-access.changed.command.v1.json",
+        CANONICAL_FIXTURES_ROOT / "discord" / "discord.admin-access.changed.command.v1.grant.json",
+        DiscordAdminAccessChangedCommandV1,
+        _assert_admin_access_semantics,
+    ),
+    (
+        "discord_admin_access_revoke",
+        spec_root() / "messages" / "discord" / "discord.admin-access.changed.command.v1.json",
+        CANONICAL_FIXTURES_ROOT / "discord" / "discord.admin-access.changed.command.v1.revoke.json",
+        DiscordAdminAccessChangedCommandV1,
+        _assert_admin_access_semantics,
+    ),
+    (
+        "discord_unlink",
+        spec_root() / "messages" / "discord" / "discord.unlink.command.v1.json",
+        CANONICAL_FIXTURES_ROOT / "discord" / "discord.unlink.command.v1.json",
+        DiscordUnlinkCommandV1,
+        _assert_unlink_semantics,
+    ),
+    (
+        "server_heartbeat",
+        spec_root() / "messages" / "chat" / "server.heartbeat.v1.json",
+        CANONICAL_FIXTURES_ROOT / "chat" / "server.heartbeat.v1.json",
+        ServerHeartbeatV1,
+        _assert_heartbeat_semantics,
+    ),
+    (
+        "metrics_snapshot",
+        spec_root() / "messages" / "telemetry" / "metrics.snapshot.v1.json",
+        CANONICAL_FIXTURES_ROOT / "telemetry" / "metrics.snapshot.v1.json",
+        MetricsSnapshotV1,
+        _assert_telemetry_semantics,
+    ),
+]
+
+
+def test_canonical_fixture_inventory_exists() -> None:
+    assert fixtures_root().exists()
+
+    for _, schema_path, fixture_path, _, _ in CANONICAL_CASES:
+        assert schema_path.exists()
+        assert fixture_path.exists()
+
+
+@pytest.mark.parametrize(
+    ("_case_name", "schema_path", "fixture_path", "model_type", "assert_semantics"),
+    CANONICAL_CASES,
+)
+def test_canonical_fixtures_remain_schema_valid(
+    _case_name: str,
+    schema_path: Path,
+    fixture_path: Path,
+    model_type: type[Any],
+    assert_semantics: CanonicalAssertion,
+) -> None:
+    del model_type, assert_semantics
+    assert_valid(schema_path, fixture_path)
+
+
+@pytest.mark.parametrize(
+    ("_case_name", "schema_path", "fixture_path", "model_type", "assert_semantics"),
+    CANONICAL_CASES,
+)
+def test_canonical_generated_models_roundtrip(
+    _case_name: str,
+    schema_path: Path,
+    fixture_path: Path,
+    model_type: type[Any],
+    assert_semantics: CanonicalAssertion,
+) -> None:
+    del schema_path
+    payload = _load_fixture(fixture_path)
+
+    model = model_type.from_payload(payload)
+    roundtrip_payload = _model_dump_json(model)
+
+    assert roundtrip_payload == payload
+    assert_semantics(model, payload)
+
+
+def test_canonical_fixtures_do_not_use_legacy_snake_case_keys() -> None:
+    for _, _, fixture_path, _, _ in CANONICAL_CASES:
+        _assert_no_snake_case_keys(_load_fixture(fixture_path))

tests/test_chat_fixtures.py

@@ -0,0 +1,145 @@
+from __future__ import annotations
+
+from xcore_protocol.paths import fixtures_root, spec_root
+from xcore_protocol.schema_validation import assert_invalid, assert_valid
+
+
+VALID_CASES = [
+    (
+        spec_root() / "messages" / "chat" / "chat.message.v1.json",
+        fixtures_root() / "valid" / "chat" / "chat.message.v1.json",
+    ),
+    (
+        spec_root() / "messages" / "chat" / "chat.global.v1.json",
+        fixtures_root() / "valid" / "chat" / "chat.global.v1.json",
+    ),
+    (
+        spec_root() / "messages" / "chat" / "chat.discord-ingress.command.v1.json",
+        fixtures_root() / "valid" / "chat" / "chat.discord-ingress.command.v1.json",
+    ),
+    (
+        spec_root() / "messages" / "chat" / "chat.private.v1.json",
+        fixtures_root() / "valid" / "chat" / "chat.private.v1.json",
+    ),
+    (
+        spec_root() / "messages" / "chat" / "server.action.v1.json",
+        fixtures_root() / "valid" / "chat" / "server.action.v1.json",
+    ),
+    (
+        spec_root() / "messages" / "chat" / "player.join-leave.v1.json",
+        fixtures_root() / "valid" / "chat" / "player.join-leave.v1.json",
+    ),
+    (
+        spec_root() / "messages" / "chat" / "player.custom-nickname.changed.command.v1.json",
+        fixtures_root() / "valid" / "chat" / "player.custom-nickname.changed.command.v1.json",
+    ),
+    (
+        spec_root() / "messages" / "chat" / "player.active-badge.changed.command.v1.json",
+        fixtures_root() / "valid" / "chat" / "player.active-badge.changed.command.v1.json",
+    ),
+    (
+        spec_root() / "messages" / "chat" / "player.badge-inventory.changed.command.v1.json",
+        fixtures_root() / "valid" / "chat" / "player.badge-inventory.changed.command.v1.json",
+    ),
+    (
+        spec_root() / "messages" / "chat" / "player.badge-symbol-color-mode.changed.command.v1.json",
+        fixtures_root() / "valid" / "chat" / "player.badge-symbol-color-mode.changed.command.v1.json",
+    ),
+    (
+        spec_root() / "messages" / "chat" / "player.password-reset.command.v1.json",
+        fixtures_root() / "valid" / "chat" / "player.password-reset.command.v1.json",
+    ),
+    (
+        spec_root() / "messages" / "chat" / "server.heartbeat.v1.json",
+        fixtures_root() / "valid" / "chat" / "server.heartbeat.v1.json",
+    ),
+]
+
+
+INVALID_CASES = [
+    (
+        spec_root() / "messages" / "chat" / "chat.message.v1.json",
+        fixtures_root() / "invalid" / "chat" / "chat.message.v1.snake-author.json",
+    ),
+    (
+        spec_root() / "messages" / "chat" / "chat.private.v1.json",
+        fixtures_root() / "invalid" / "chat" / "chat.private.v1.snake-from.json",
+    ),
+    (
+        spec_root() / "messages" / "chat" / "player.join-leave.v1.json",
+        fixtures_root()
+        / "invalid"
+        / "chat"
+        / "player.join-leave.v1.legacy-join.json",
+    ),
+    (
+        spec_root() / "messages" / "chat" / "player.custom-nickname.changed.command.v1.json",
+        fixtures_root()
+        / "invalid"
+        / "chat"
+        / "player.custom-nickname.changed.command.v1.legacy-uuid.json",
+    ),
+    (
+        spec_root() / "messages" / "chat" / "player.active-badge.changed.command.v1.json",
+        fixtures_root()
+        / "invalid"
+        / "chat"
+        / "player.active-badge.changed.command.v1.legacy-uuid.json",
+    ),
+    (
+        spec_root() / "messages" / "chat" / "player.badge-inventory.changed.command.v1.json",
+        fixtures_root()
+        / "invalid"
+        / "chat"
+        / "player.badge-inventory.changed.command.v1.legacy-uuid.json",
+    ),
+    (
+        spec_root() / "messages" / "chat" / "player.badge-symbol-color-mode.changed.command.v1.json",
+        fixtures_root()
+        / "invalid"
+        / "chat"
+        / "player.badge-symbol-color-mode.changed.command.v1.legacy-uuid.json",
+    ),
+    (
+        spec_root() / "messages" / "chat" / "player.password-reset.command.v1.json",
+        fixtures_root()
+        / "invalid"
+        / "chat"
+        / "player.password-reset.command.v1.legacy-uuid.json",
+    ),
+    (
+        spec_root() / "messages" / "chat" / "server.heartbeat.v1.json",
+        fixtures_root()
+        / "invalid"
+        / "chat"
+        / "server.heartbeat.v1.server-host-alias.json",
+    ),
+    (
+        spec_root() / "messages" / "chat" / "server.heartbeat.v1.json",
+        fixtures_root()
+        / "invalid"
+        / "chat"
+        / "server.heartbeat.v1.missing-channel.json",
+    ),
+]
+
+
+def test_valid_chat_fixtures_pass() -> None:
+    for schema_path, fixture_path in VALID_CASES:
+        assert_valid(schema_path, fixture_path)
+
+
+def test_invalid_chat_fixtures_fail() -> None:
+    for schema_path, fixture_path in INVALID_CASES:
+        error = assert_invalid(schema_path, fixture_path)
+        assert error is not None
+
+
+def test_chat_fixture_inventory_exists() -> None:
+    chat_valid_dir = fixtures_root() / "valid" / "chat"
+    chat_invalid_dir = fixtures_root() / "invalid" / "chat"
+
+    assert chat_valid_dir.exists()
+    assert chat_invalid_dir.exists()
+    assert any(chat_valid_dir.iterdir())
+    assert any(chat_invalid_dir.iterdir())

tests/test_discord_fixtures.py

@@ -0,0 +1,87 @@
+from __future__ import annotations
+
+from xcore_protocol.paths import fixtures_root, spec_root
+from xcore_protocol.schema_validation import assert_invalid, assert_valid
+
+
+VALID_CASES = [
+    (
+        spec_root() / "messages" / "discord" / "discord.link-code-created.v1.json",
+        fixtures_root() / "valid" / "discord" / "discord.link-code-created.v1.json",
+    ),
+    (
+        spec_root() / "messages" / "discord" / "discord.link.confirm.command.v1.json",
+        fixtures_root() / "valid" / "discord" / "discord.link.confirm.command.v1.json",
+    ),
+    (
+        spec_root() / "messages" / "discord" / "discord.unlink.command.v1.json",
+        fixtures_root() / "valid" / "discord" / "discord.unlink.command.v1.json",
+    ),
+    (
+        spec_root() / "messages" / "discord" / "discord.link.status-changed.v1.json",
+        fixtures_root() / "valid" / "discord" / "discord.link.status-changed.v1.json",
+    ),
+    (
+        spec_root()
+        / "messages"
+        / "discord"
+        / "discord.admin-access.changed.command.v1.json",
+        fixtures_root()
+        / "valid"
+        / "discord"
+        / "discord.admin-access.changed.command.v1.json",
+    ),
+]
+
+
+INVALID_CASES = [
+    (
+        spec_root() / "messages" / "discord" / "discord.link-code-created.v1.json",
+        fixtures_root() / "invalid" / "discord" / "discord.link-code-created.v1.bad-time.json",
+    ),
+    (
+        spec_root() / "messages" / "discord" / "discord.link.confirm.command.v1.json",
+        fixtures_root()
+        / "invalid"
+        / "discord"
+        / "discord.link.confirm.command.v1.bad-time.json",
+    ),
+    (
+        spec_root() / "messages" / "discord" / "discord.unlink.command.v1.json",
+        fixtures_root()
+        / "invalid"
+        / "discord"
+        / "discord.unlink.command.v1.missing-discord.json",
+    ),
+    (
+        spec_root()
+        / "messages"
+        / "discord"
+        / "discord.admin-access.changed.command.v1.json",
+        fixtures_root()
+        / "invalid"
+        / "discord"
+        / "discord.admin-access.changed.command.v1.missing-reason.json",
+    ),
+]
+
+
+def test_valid_discord_fixtures_pass() -> None:
+    for schema_path, fixture_path in VALID_CASES:
+        assert_valid(schema_path, fixture_path)
+
+
+def test_invalid_discord_fixtures_fail() -> None:
+    for schema_path, fixture_path in INVALID_CASES:
+        error = assert_invalid(schema_path, fixture_path)
+        assert error is not None
+
+
+def test_discord_fixture_inventory_exists() -> None:
+    discord_valid_dir = fixtures_root() / "valid" / "discord"
+    discord_invalid_dir = fixtures_root() / "invalid" / "discord"
+
+    assert discord_valid_dir.exists()
+    assert discord_invalid_dir.exists()
+    assert any(discord_valid_dir.iterdir())
+    assert any(discord_invalid_dir.iterdir())