Upload 238 files

app/core/enums.py

@@ -0,0 +1,18 @@
+"""Enum compatibility helpers for the supported Python 3.10+ runtimes."""
+
+from __future__ import annotations
+
+from enum import Enum
+
+
+class StrEnum(str, Enum):
+    """String-valued enum with the Python 3.11 ``enum.StrEnum`` behavior.
+
+    MediaRouter supports Python 3.10, where the standard-library StrEnum does
+    not exist. Keeping this small compatibility type in one place gives API,
+    database, and Pydantic serialization the same string behavior on every
+    supported runtime.
+    """
+
+    __str__ = str.__str__
+    __format__ = str.__format__

app/social/domain/enums.py

@@ -1,6 +1,6 @@
 from __future__ import annotations
 
-from enum import StrEnum
+from app.core.enums import StrEnum
 
 
 class Provider(StrEnum):

app/social/schemas/tiktok.py

@@ -1,10 +1,11 @@
 from __future__ import annotations
 
-from enum import StrEnum
 from typing import Literal
 
 from pydantic import BaseModel, ConfigDict, Field, field_validator
 
+from app.core.enums import StrEnum
+
 
 class TikTokPrivacyLevel(StrEnum):
     PUBLIC_TO_EVERYONE = "PUBLIC_TO_EVERYONE"

app/social/schemas/youtube.py

@@ -1,10 +1,11 @@
 from __future__ import annotations
 
 from datetime import datetime, timezone
-from enum import StrEnum
 
 from pydantic import BaseModel, ConfigDict, Field, field_validator, model_validator
 
+from app.core.enums import StrEnum
+
 
 class YouTubePrivacyStatus(StrEnum):
     PRIVATE = "private"

tests/test_python310_compat.py

@@ -0,0 +1,23 @@
+"""Regression tests for the Python 3.10 production runtime contract."""
+
+from app.core.enums import StrEnum
+from app.social.domain.enums import JobStatus, Provider
+from app.social.schemas.tiktok import TikTokPrivacyLevel
+from app.social.schemas.youtube import YouTubePrivacyStatus
+
+
+def test_string_enums_do_not_require_python_311_stdlib() -> None:
+    class Example(StrEnum):
+        VALUE = "value"
+
+    assert Example.VALUE == "value"
+    assert str(Example.VALUE) == "value"
+    assert f"{Example.VALUE}" == "value"
+    assert Example.VALUE.value == "value"
+
+
+def test_social_schema_enums_keep_wire_values() -> None:
+    assert str(Provider.TIKTOK) == "tiktok"
+    assert str(JobStatus.PUBLISHED) == "published"
+    assert str(TikTokPrivacyLevel.SELF_ONLY) == "SELF_ONLY"
+    assert str(YouTubePrivacyStatus.PRIVATE) == "private"