typecast-python 0.1.7__tar.gz → 0.1.9__tar.gz

{typecast_python-0.1.7 → typecast_python-0.1.9}/PKG-INFO

@@ -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 → typecast_python-0.1.9}/README.md

@@ -7,6 +7,7 @@
 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 → typecast_python-0.1.9}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "hatchling.build"
 
 [project]
 name = "typecast-python"
-version = "0.1.7"
+version = "0.1.9"
 description = "Official Typecast Python SDK - Convert text to lifelike speech using AI-powered voices"
 authors = [
     {name = "Neosapience", email = "help@typecast.ai"}
@@ -40,12 +40,14 @@ dependencies = [
 [project.optional-dependencies]
 dev = [
     "pytest>=7.0.0",
+    "pytest-cov>=7.0.0",
+    "pytest-mock>=3.14.0",
+    "pytest-asyncio>=0.21.0",
+    "aioresponses>=0.7.6",
     "black>=23.0.0",
     "flake8>=6.0.0",
     "mypy>=1.0.0",
     "isort>=5.0.0",
-    "pytest-mock>=3.14.0",
-    "pytest-asyncio>=0.21.0",
 ]
 
 [project.urls]
@@ -90,6 +92,34 @@ dev = [
     "pytest-cov>=7.0.0",
     "pytest-mock>=3.14.0",
     "pytest-asyncio>=0.21.0",
+    "aioresponses>=0.7.6",
     "python-dotenv>=1.1.1",
     "ruff>=0.14.0",
 ]
+
+[tool.pytest.ini_options]
+asyncio_mode = "auto"
+testpaths = ["tests"]
+filterwarnings = [
+    "ignore::DeprecationWarning",
+]
+
+[tool.coverage.run]
+branch = true
+source = ["src/typecast"]
+omit = [
+    "*/tests/*",
+    "*/examples/*",
+    "*/__pycache__/*",
+]
+
+[tool.coverage.report]
+show_missing = true
+skip_covered = false
+fail_under = 100
+exclude_lines = [
+    "pragma: no cover",
+    "raise NotImplementedError",
+    "if TYPE_CHECKING:",
+    "\\.\\.\\.",
+]

{typecast_python-0.1.7 → typecast_python-0.1.9}/src/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_python-0.1.7 → typecast_python-0.1.9}/src/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_python-0.1.9/src/typecast/sse.py

@@ -0,0 +1,58 @@
+from typing import AsyncIterator, Optional
+
+import aiohttp
+
+from . import conf
+from .exceptions import TypecastError
+
+
+class TypecastSSE:
+    """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()
+
+        self.session = aiohttp.ClientSession(
+            headers={"X-API-KEY": self.api_key, "Accept": "text/event-stream"}
+        )
+
+        async with self.session.get(f"{self.sse_url}/{endpoint}") as response:
+            if response.status != 200:
+                raise TypecastError(f"SSE connection failed: {response.status}")
+
+            async for line in response.content:
+                decoded_line = line.decode("utf-8").strip()
+                if decoded_line.startswith("data: "):
+                    yield decoded_line[6:]
+
+    async def close(self):
+        if self.session:
+            await self.session.close()

{typecast_python-0.1.7 → typecast_python-0.1.9}/src/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/src/typecast/sse.py

@@ -1,35 +0,0 @@
-from typing import AsyncIterator, Optional
-
-import aiohttp
-
-from . import conf
-from .exceptions import TypecastError
-
-
-class TypecastSSE:
-    SSE_URL = f"{conf.get_host()}/v1/text-to-speech/sse"
-
-    def __init__(self, api_key: str):
-        self.api_key = conf.get_api_key(api_key)
-        self.session: Optional[aiohttp.ClientSession] = None
-
-    async def connect(self, endpoint: str) -> AsyncIterator[str]:
-        if self.session:
-            await self.session.close()
-
-        self.session = aiohttp.ClientSession(
-            headers={"X-API-KEY": self.api_key, "Accept": "text/event-stream"}
-        )
-
-        async with self.session.get(f"{self.SSE_URL}/{endpoint}") as response:
-            if response.status != 200:
-                raise TypecastError(f"SSE connection failed: {response.status}")
-
-            async for line in response.content:
-                decoded_line = line.decode("utf-8").strip()
-                if decoded_line.startswith("data: "):
-                    yield decoded_line[6:]
-
-    async def close(self):
-        if self.session:
-            await self.session.close()