typecast-python 0.1.7__py3-none-any.whl → 0.1.9__py3-none-any.whl

typecast/async_client.py

@@ -196,12 +196,11 @@ class AsyncTypecast:
         params = {}
         if filter:
             filter_dict = filter.model_dump(exclude_none=True)
-            # Convert enum values to strings
+            # Convert enum values to their underlying str representation.
+            # Every VoicesV2Filter field is an Optional[Enum], so getattr
+            # falls back only if a future non-enum field is added.
             for key, value in filter_dict.items():
-                if hasattr(value, "value"):
-                    params[key] = value.value
-                else:
-                    params[key] = value
+                params[key] = getattr(value, "value", value)
 
         async with self.session.get(
             f"{self.host}{endpoint}", params=params

typecast/client.py

@@ -173,12 +173,11 @@ class Typecast:
         params = {}
         if filter:
             filter_dict = filter.model_dump(exclude_none=True)
-            # Convert enum values to strings
+            # Convert enum values to their underlying str representation.
+            # Every VoicesV2Filter field is an Optional[Enum], so getattr
+            # falls back only if a future non-enum field is added.
             for key, value in filter_dict.items():
-                if hasattr(value, "value"):
-                    params[key] = value.value
-                else:
-                    params[key] = value
+                params[key] = getattr(value, "value", value)
 
         response = self.session.get(f"{self.host}{endpoint}", params=params)
 

typecast/sse.py

@@ -7,12 +7,35 @@ from .exceptions import TypecastError
 
 
 class TypecastSSE:
-    SSE_URL = f"{conf.get_host()}/v1/text-to-speech/sse"
-
-    def __init__(self, api_key: str):
+    """Server-Sent Events client for Typecast streaming endpoints."""
+
+    def __init__(
+        self,
+        api_key: Optional[str] = None,
+        host: Optional[str] = None,
+        sse_url: Optional[str] = None,
+    ):
+        """Initialize the SSE client.
+
+        Args:
+            api_key: API key. Defaults to TYPECAST_API_KEY env var.
+            host: API host. Defaults to TYPECAST_API_HOST env var or
+                'https://api.typecast.ai'. Used to derive sse_url when
+                sse_url is not provided.
+            sse_url: Full SSE base URL override (escape hatch for tests).
+                When provided, takes precedence over host.
+        """
         self.api_key = conf.get_api_key(api_key)
+        self.host = conf.get_host(host)
+        self._sse_url_override = sse_url
         self.session: Optional[aiohttp.ClientSession] = None
 
+    @property
+    def sse_url(self) -> str:
+        if self._sse_url_override is not None:
+            return self._sse_url_override
+        return f"{self.host}/v1/text-to-speech/sse"
+
     async def connect(self, endpoint: str) -> AsyncIterator[str]:
         if self.session:
             await self.session.close()
@@ -21,7 +44,7 @@ class TypecastSSE:
             headers={"X-API-KEY": self.api_key, "Accept": "text/event-stream"}
         )
 
-        async with self.session.get(f"{self.SSE_URL}/{endpoint}") as response:
+        async with self.session.get(f"{self.sse_url}/{endpoint}") as response:
             if response.status != 200:
                 raise TypecastError(f"SSE connection failed: {response.status}")
 

typecast/websocket.py

@@ -9,17 +9,18 @@ from .models import WebSocketMessage
 
 
 class TypecastWebSocket:
-    WS_URL = "wss://api.typecast.ai/v1/ws"
+    """WebSocket client for Typecast streaming TTS."""
 
-    def __init__(self, api_key: str):
+    DEFAULT_WS_URL = "wss://api.typecast.ai/v1/ws"
+
+    def __init__(self, api_key: str, ws_url: Optional[str] = None):
         self.api_key = api_key
+        self.ws_url = ws_url or self.DEFAULT_WS_URL
         self.ws: Optional[websockets.WebSocketClientProtocol] = None
         self.callbacks: dict[str, Callable] = {}
 
     async def connect(self):
-        self.ws = await websockets.connect(f"{self.WS_URL}?token={self.api_key}")
-
-        # Start message handler
+        self.ws = await websockets.connect(f"{self.ws_url}?token={self.api_key}")
         asyncio.create_task(self._message_handler())
 
     async def _message_handler(self):
@@ -34,7 +35,7 @@ class TypecastWebSocket:
                 await self.callbacks[msg.type](msg.payload)
 
     def on(self, event_type: str, callback: Callable):
-        """Register event callback"""
+        """Register event callback."""
         self.callbacks[event_type] = callback
 
     async def send(self, message: WebSocketMessage):

{typecast_python-0.1.7.dist-info → typecast_python-0.1.9.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: typecast-python
-Version: 0.1.7
+Version: 0.1.9
 Summary: Official Typecast Python SDK - Convert text to lifelike speech using AI-powered voices
 Project-URL: Homepage, https://typecast.ai
 Project-URL: Documentation, https://typecast.ai/docs/overview
@@ -230,11 +230,13 @@ Requires-Dist: sseclient-py>=1.7.2
 Requires-Dist: typing-extensions>=4.0.0
 Requires-Dist: websockets>=10.0
 Provides-Extra: dev
+Requires-Dist: aioresponses>=0.7.6; extra == 'dev'
 Requires-Dist: black>=23.0.0; extra == 'dev'
 Requires-Dist: flake8>=6.0.0; extra == 'dev'
 Requires-Dist: isort>=5.0.0; extra == 'dev'
 Requires-Dist: mypy>=1.0.0; extra == 'dev'
 Requires-Dist: pytest-asyncio>=0.21.0; extra == 'dev'
+Requires-Dist: pytest-cov>=7.0.0; extra == 'dev'
 Requires-Dist: pytest-mock>=3.14.0; extra == 'dev'
 Requires-Dist: pytest>=7.0.0; extra == 'dev'
 Description-Content-Type: text/markdown
@@ -248,6 +250,7 @@ Description-Content-Type: text/markdown
 Convert text to lifelike speech using AI-powered voices
 
 [![PyPI version](https://img.shields.io/pypi/v/typecast-python.svg?style=flat-square)](https://pypi.org/project/typecast-python/)
+[![coverage](https://img.shields.io/badge/coverage-100%25-brightgreen.svg?style=flat-square)](../docs/coverage-policy.md)
 [![License](https://img.shields.io/badge/license-Apache--2.0-blue.svg?style=flat-square)](LICENSE)
 [![Python](https://img.shields.io/badge/Python-3.9+-3776ab.svg?style=flat-square&logo=python&logoColor=white)](https://www.python.org/)
 

{typecast_python-0.1.7.dist-info → typecast_python-0.1.9.dist-info}/RECORD

@@ -1,17 +1,17 @@
 typecast/__init__.py,sha256=8xdL3GnADTIsi2KuqPY938opQtN6GbHWnJI0XwjqHPc,871
-typecast/async_client.py,sha256=_v-YHussPMAG4az8XnWdXwb6uh5gcXAhWcpW1Scuf0o,9004
-typecast/client.py,sha256=Kj_IqZ_RgDGaPTylsUsYAQfRO_1PG7NZdEuc8nZ0a4A,7431
+typecast/async_client.py,sha256=gSsp8pGxX7twCfnDDohFxazMV0G63UcHqgMRFKv5V_U,9083
+typecast/client.py,sha256=B5EgmAJ6rWGfSsrWaiVoRlB98IW1lKrf2Un8yXE5uUA,7510
 typecast/conf.py,sha256=Fn_T4XW7BaHRnj0tP11BT5at3Y-db7oGcbBA_E1fmF0,479
 typecast/exceptions.py,sha256=Y0ZzYebe8zOSOSAHbXfKR0G_RJgdmZXxi15Z7ZxPLIk,1568
-typecast/sse.py,sha256=yYO2h5E_1-uiIID0TZM03eRZfvgkCStxu-0J6ej4Bpo,1109
+typecast/sse.py,sha256=3qpNaS7iPU97QIWRFRUoiQFinHcIwloEim8Z_LtD05c,1951
 typecast/utils.py,sha256=XuNuX7gW8_CGKqZ-cv_tKlPVMPBluAYJBw2clwmjIMI,708
-typecast/websocket.py,sha256=SwFmk2efGtMLY3UgEtZljZAhULl5HG6KaA-rqfJ0Jaw,1336
+typecast/websocket.py,sha256=3m5klCYykEOyC_j28rLR2zAt7LHWO4k3-2W-L2rlaGY,1450
 typecast/models/__init__.py,sha256=sF_0YSHXOPebNpNi_RiYAy-GnoG1D7ugHskszQYDsxk,754
 typecast/models/error.py,sha256=XomIjx7jvlCjItqzJuCAT4mXC9jwTjxR8lLDUk6P8KA,152
 typecast/models/tts.py,sha256=51TeFsiCZMzhMWdvP6Q6bKm4KCMjk0OyLPahOPig-yk,5358
 typecast/models/tts_wss.py,sha256=zYfP3oNs5VuOkxI7bu0uSCHDYfSbQWaenqg0lLLqaSc,101
 typecast/models/voices.py,sha256=VwmK_Ts17QccAaClGYqqstIGJ5RT9Qgj2kxqEoDr6z4,1659
-typecast_python-0.1.7.dist-info/METADATA,sha256=ZU-cAV8CicMjOdxmHiB4_XQQn7W-PwwcFbFEqE12QAA,22726
-typecast_python-0.1.7.dist-info/WHEEL,sha256=QccIxa26bgl1E6uMy58deGWi-0aeIkkangHcxk2kWfw,87
-typecast_python-0.1.7.dist-info/licenses/LICENSE,sha256=HvtJ-S89uUkuYmt-OvVk4MRxmzwtbn84__qJtSrGU2Q,11348
-typecast_python-0.1.7.dist-info/RECORD,,
+typecast_python-0.1.9.dist-info/METADATA,sha256=cYVtKWj-dNPOMqWS_9uBeP0hbWk-CMa2TUM016GAEgE,22948
+typecast_python-0.1.9.dist-info/WHEEL,sha256=QccIxa26bgl1E6uMy58deGWi-0aeIkkangHcxk2kWfw,87
+typecast_python-0.1.9.dist-info/licenses/LICENSE,sha256=HvtJ-S89uUkuYmt-OvVk4MRxmzwtbn84__qJtSrGU2Q,11348
+typecast_python-0.1.9.dist-info/RECORD,,