typecast-python 0.3.14__tar.gz → 0.4.0__tar.gz

{typecast_python-0.3.14 → typecast_python-0.4.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.5
 Name: typecast-python
-Version: 0.3.14
+Version: 0.4.0
 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
@@ -217,8 +217,6 @@ Classifier: Intended Audience :: Developers
 Classifier: License :: OSI Approved :: Apache Software License
 Classifier: Operating System :: OS Independent
 Classifier: Programming Language :: Python :: 3
-Classifier: Programming Language :: Python :: 3.8
-Classifier: Programming Language :: Python :: 3.9
 Classifier: Programming Language :: Python :: 3.10
 Classifier: Programming Language :: Python :: 3.11
 Classifier: Programming Language :: Python :: 3.12
@@ -226,11 +224,10 @@ Classifier: Programming Language :: Python :: 3.13
 Classifier: Programming Language :: Python :: 3.14
 Classifier: Topic :: Multimedia :: Sound/Audio :: Speech
 Classifier: Topic :: Software Development :: Libraries :: Python Modules
-Requires-Python: <3.15,>=3.8
-Requires-Dist: aiohttp>=3.14.1; python_version >= '3.10'
-Requires-Dist: httpx<1,>=0.28.1; python_version < '3.10'
+Requires-Python: <3.15,>=3.10
+Requires-Dist: aiohttp>=3.14.1
 Requires-Dist: pydantic>=2.0.0
-Requires-Dist: requests>=2.33.0; python_version >= '3.10'
+Requires-Dist: requests>=2.33.0
 Requires-Dist: typing-extensions>=4.0.0
 Provides-Extra: dev
 Requires-Dist: aioresponses>=0.7.6; extra == 'dev'
@@ -256,7 +253,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.8--3.14-3776ab.svg?style=flat-square&logo=python&logoColor=white)](https://www.python.org/)
+[![Python](https://img.shields.io/badge/Python-3.10--3.14-3776ab.svg?style=flat-square&logo=python&logoColor=white)](https://www.python.org/)
 
 [Documentation](https://typecast.ai/docs) | [API Reference](https://typecast.ai/docs/api-reference) | [Get API Key](https://typecast.ai/developers/api/api-key)
 
@@ -284,6 +281,8 @@ Convert text to lifelike speech using AI-powered voices
 
 ## Installation
 
+Python 3.10 through 3.14 is required. Python 3.8 and 3.9 are no longer supported because they are end-of-life. Version 0.3.15 is the last compatible published release. Upgrade Python and recreate your virtual environment before installing 0.4.0. A temporary `typecast-python==0.3.15` pin does not restore security support for an EOL runtime.
+
 ```bash
 pip install typecast-python
 ```
@@ -383,11 +382,11 @@ response = client.text_to_speech(TTSRequest(
 ```python
 from typecast.models import VoicesV2Filter, TTSModel, GenderEnum, AgeEnum
 
-# Get all voices (V2 API - recommended)
-voices = client.voices_v2()
+# Get all voices (V3 API)
+voices = client.voices_v3()
 
 # Filter by criteria
-filtered = client.voices_v2(VoicesV2Filter(
+filtered = client.voices_v3(VoicesV2Filter(
     model=TTSModel.SSFM_V30,
     gender=GenderEnum.FEMALE,
     age=AgeEnum.YOUNG_ADULT

{typecast_python-0.3.14 → typecast_python-0.4.0}/README.md

@@ -9,7 +9,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.8--3.14-3776ab.svg?style=flat-square&logo=python&logoColor=white)](https://www.python.org/)
+[![Python](https://img.shields.io/badge/Python-3.10--3.14-3776ab.svg?style=flat-square&logo=python&logoColor=white)](https://www.python.org/)
 
 [Documentation](https://typecast.ai/docs) | [API Reference](https://typecast.ai/docs/api-reference) | [Get API Key](https://typecast.ai/developers/api/api-key)
 
@@ -37,6 +37,8 @@ Convert text to lifelike speech using AI-powered voices
 
 ## Installation
 
+Python 3.10 through 3.14 is required. Python 3.8 and 3.9 are no longer supported because they are end-of-life. Version 0.3.15 is the last compatible published release. Upgrade Python and recreate your virtual environment before installing 0.4.0. A temporary `typecast-python==0.3.15` pin does not restore security support for an EOL runtime.
+
 ```bash
 pip install typecast-python
 ```
@@ -136,11 +138,11 @@ response = client.text_to_speech(TTSRequest(
 ```python
 from typecast.models import VoicesV2Filter, TTSModel, GenderEnum, AgeEnum
 
-# Get all voices (V2 API - recommended)
-voices = client.voices_v2()
+# Get all voices (V3 API)
+voices = client.voices_v3()
 
 # Filter by criteria
-filtered = client.voices_v2(VoicesV2Filter(
+filtered = client.voices_v3(VoicesV2Filter(
     model=TTSModel.SSFM_V30,
     gender=GenderEnum.FEMALE,
     age=AgeEnum.YOUNG_ADULT

{typecast_python-0.3.14 → typecast_python-0.4.0}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "hatchling.build"
 
 [project]
 name = "typecast-python"
-version = "0.3.14"
+version = "0.4.0"
 description = "Official Typecast Python SDK - Convert text to lifelike speech using AI-powered voices"
 authors = [
     {name = "Neosapience", email = "help@typecast.ai"}
@@ -14,15 +14,13 @@ maintainers = [
 ]
 license = {file = "LICENSE"}
 readme = "README.md"
-requires-python = ">=3.8,<3.15"
+requires-python = ">=3.10,<3.15"
 keywords = ["typecast", "tts", "text-to-speech", "ai", "voice", "audio", "speech-synthesis", "voice-generation"]
 classifiers = [
     "Development Status :: 3 - Alpha",
     "Intended Audience :: Developers",
     "License :: OSI Approved :: Apache Software License",
     "Programming Language :: Python :: 3",
-    "Programming Language :: Python :: 3.8",
-    "Programming Language :: Python :: 3.9",
     "Programming Language :: Python :: 3.10",
     "Programming Language :: Python :: 3.11",
     "Programming Language :: Python :: 3.12",
@@ -33,9 +31,8 @@ classifiers = [
     "Operating System :: OS Independent",
 ]
 dependencies = [
-    "aiohttp>=3.14.1; python_version >= '3.10'",
-    "requests>=2.33.0; python_version >= '3.10'",
-    "httpx>=0.28.1,<1; python_version < '3.10'",
+    "aiohttp>=3.14.1",
+    "requests>=2.33.0",
     "pydantic>=2.0.0",
     "typing-extensions>=4.0.0",
 ]
@@ -83,7 +80,7 @@ exclude = [
 
 [tool.black]
 line-length = 88
-target-version = ['py38']
+target-version = ['py310']
 include = '\.pyi?$'
 
 [tool.isort]

{typecast_python-0.3.14 → typecast_python-0.4.0}/src/typecast/_user_agent.py

@@ -108,19 +108,3 @@ def aiohttp_user_agent(
         generated_by=generated_by,
     )
 
-
-def httpx_user_agent(
-    host: str,
-    mode: str,
-    transport: str = "rest",
-    source: Optional[str] = None,
-    generated_by: Optional[str] = None,
-) -> str:
-    return build_user_agent(
-        mode=mode,
-        http_library=f"httpx/{_package_version('httpx')}",
-        host=host,
-        transport=transport,
-        source=source,
-        generated_by=generated_by,
-    )

{typecast_python-0.3.14 → typecast_python-0.4.0}/src/typecast/async_client.py

@@ -1,18 +1,14 @@
 from __future__ import annotations
 
 import asyncio
-import sys
 from pathlib import Path
-from typing import TYPE_CHECKING, Any, AsyncIterator, BinaryIO, Optional, Union
+from typing import Any, AsyncIterator, BinaryIO, Optional, Union
 from urllib.parse import quote
 
-if sys.version_info >= (3, 10):  # pragma: no cover - version-specific import
-    import aiohttp
-else:  # pragma: no cover
-    aiohttp = None  # type: ignore[assignment]
+import aiohttp
 
 from . import conf
-from ._user_agent import aiohttp_user_agent, attribution_suffix, httpx_user_agent
+from ._user_agent import aiohttp_user_agent, attribution_suffix
 from ._voice_clone import (
     normalize_clone_model,
     validate_clone_inputs,
@@ -20,8 +16,6 @@ from ._voice_clone import (
     validate_voice_id,
 )
 
-if TYPE_CHECKING or sys.version_info < (3, 10):  # pragma: no cover
-    from ._httpx_compat import AiohttpCompatSession, ClientTimeout, FormData
 from .client import (
     _guess_audio_mime,
     _output_with_inferred_format,
@@ -120,21 +114,12 @@ class AsyncTypecast:
                     aiohttp_user_agent(
                         self.host, source=self.source, generated_by=self.generated_by
                     )
-                    if aiohttp
-                    else httpx_user_agent(
-                        self.host,
-                        "async",
-                        source=self.source,
-                        generated_by=self.generated_by,
-                    )
                 )
             }
             if self.api_key:
                 headers["X-API-KEY"] = self.api_key
             self.session = (
                 aiohttp.ClientSession(headers=headers)
-                if aiohttp
-                else AiohttpCompatSession(headers=headers)
             )
         return self
 
@@ -288,8 +273,6 @@ class AsyncTypecast:
         endpoint = "/v1/text-to-speech/stream"
         stream_timeout = (
             aiohttp.ClientTimeout(sock_connect=10, sock_read=300)
-            if aiohttp
-            else ClientTimeout(sock_connect=10, sock_read=300)
         )
         async with self.session.post(
             f"{self.host}{endpoint}",
@@ -377,7 +360,7 @@ class AsyncTypecast:
         audio_bytes, filename = validate_clone_inputs(audio, name)
         model_str = normalize_clone_model(model)
 
-        form: Any = aiohttp.FormData() if aiohttp else FormData()
+        form: Any = aiohttp.FormData()
         form.add_field("name", name)
         form.add_field("model", model_str)
         form.add_field(
@@ -388,8 +371,6 @@ class AsyncTypecast:
         )
         timeout = (
             aiohttp.ClientTimeout(total=300, connect=10)
-            if aiohttp
-            else ClientTimeout(total=300, connect=10)
         )
         async with self.session.post(
             f"{self.host}/v1/custom-voices/instant-clone",
@@ -418,8 +399,6 @@ class AsyncTypecast:
         validate_custom_voice_id(voice_id)
         timeout = (
             aiohttp.ClientTimeout(total=60, connect=10)
-            if aiohttp
-            else ClientTimeout(total=60, connect=10)
         )
         async with self.session.delete(
             f"{self.host}/v1/custom-voices/{quote(voice_id, safe='')}",
@@ -441,12 +420,12 @@ class AsyncTypecast:
         if self.session is None:
             raise TypecastError("Client session not initialized; use 'async with'.")
         audio_bytes, filename = validate_clone_inputs(audio, name)
-        form: Any = aiohttp.FormData() if aiohttp else FormData()
+        form: Any = aiohttp.FormData()
         form.add_field("name", name)
         form.add_field("language", str(language.value if hasattr(language, "value") else language))
         form.add_field("model", normalize_clone_model(model))
         form.add_field("files", audio_bytes, filename=filename, content_type=_guess_audio_mime(filename))
-        timeout = aiohttp.ClientTimeout(total=300, connect=10) if aiohttp else ClientTimeout(total=300, connect=10)
+        timeout = aiohttp.ClientTimeout(total=300, connect=10)
         async with self.session.post(
             f"{self.host}/v1/custom-voices/professional-clone",
             data=form, timeout=timeout, headers=self._request_headers(),

{typecast_python-0.3.14 → typecast_python-0.4.0}/src/typecast/client.py

@@ -1,17 +1,13 @@
 from __future__ import annotations
 
-import sys
 from pathlib import Path
-from typing import TYPE_CHECKING, Any, BinaryIO, Iterator, Optional, Union
+from typing import Any, BinaryIO, Iterator, Optional, Union
 from urllib.parse import quote
 
-if sys.version_info >= (3, 10):  # pragma: no cover - version-specific import
-    import requests
-else:  # pragma: no cover
-    requests = None  # type: ignore[assignment]
+import requests
 
 from . import conf
-from ._user_agent import attribution_suffix, httpx_user_agent, requests_user_agent
+from ._user_agent import attribution_suffix, requests_user_agent
 from ._voice_clone import (
     normalize_clone_model,
     validate_clone_inputs,
@@ -19,8 +15,6 @@ from ._voice_clone import (
     validate_voice_id,
 )
 
-if TYPE_CHECKING or sys.version_info < (3, 10):  # pragma: no cover
-    from ._httpx_compat import RequestsCompatSession
 from .composer import SpeechComposer
 from .exceptions import (
     BadRequestError,
@@ -144,13 +138,11 @@ class Typecast:
         if session is not None:
             self.session = session
         else:
-            self.session = requests.Session() if requests else RequestsCompatSession()
+            self.session = requests.Session()
             headers = {
                 "Content-Type": "application/json",
                 "User-Agent": (
                     requests_user_agent(self.host, source=source, generated_by=generated_by)
-                    if requests
-                    else httpx_user_agent(self.host, "sync", source=source, generated_by=generated_by)
                 ),
             }
             if self.api_key:

{typecast_python-0.3.14 → typecast_python-0.4.0}/src/typecast/models/tts.py

@@ -124,6 +124,13 @@ TTSPrompt = Union[Prompt, PresetPrompt, SmartPrompt]
 
 
 class Output(BaseModel):
+    remove_silence_ms: Optional[int] = Field(
+        default=None,
+        strict=True,
+        ge=0,
+        le=1000,
+        description="Remaining detected silence in milliseconds. 0 removes silence; None disables this processing.",
+    )
     volume: Optional[int] = Field(
         default=100,
         ge=0,
@@ -191,6 +198,14 @@ class OutputStream(BaseModel):
 
     model_config = ConfigDict(extra="forbid")
 
+    remove_silence_ms: Optional[int] = Field(
+        default=None,
+        strict=True,
+        ge=0,
+        le=1000,
+        description="Remaining detected silence in milliseconds. 0 removes silence; None disables this processing.",
+    )
+
     audio_pitch: Optional[int] = Field(default=0, ge=-12, le=12)
     audio_tempo: Optional[float] = Field(default=1.0, ge=0.5, le=2.0)
     audio_format: Optional[str] = Field(
@@ -419,6 +434,7 @@ class TTSWithTimestampsResponse(BaseModel):
     def audio_bytes(self) -> bytes:
         """Return decoded audio bytes from the base64 `audio` field."""
         import base64
+
         return base64.b64decode(self.audio, validate=True)
 
     def save_audio(self, path: str) -> None:
@@ -436,7 +452,9 @@ class TTSWithTimestampsResponse(BaseModel):
         subtitle guidelines (7.0s / 42 chars).
         """
         segments, word_mode = _segments_for_captioning(self.words, self.characters)
-        cues = _group_into_cues(segments, word_mode=word_mode, max_seconds=max_seconds, max_chars=max_chars)
+        cues = _group_into_cues(
+            segments, word_mode=word_mode, max_seconds=max_seconds, max_chars=max_chars
+        )
         if not cues:
             raise ValueError("no alignment segments to caption from")
         lines = []
@@ -457,7 +475,9 @@ class TTSWithTimestampsResponse(BaseModel):
         subtitle guidelines (7.0s / 42 chars).
         """
         segments, word_mode = _segments_for_captioning(self.words, self.characters)
-        cues = _group_into_cues(segments, word_mode=word_mode, max_seconds=max_seconds, max_chars=max_chars)
+        cues = _group_into_cues(
+            segments, word_mode=word_mode, max_seconds=max_seconds, max_chars=max_chars
+        )
         if not cues:
             raise ValueError("no alignment segments to caption from")
         lines = ["WEBVTT", ""]

typecast_python-0.3.14/src/typecast/_httpx_compat.py

@@ -1,191 +0,0 @@
-from __future__ import annotations
-
-from typing import Any, AsyncIterator, Dict, Iterator, List, Optional, Tuple
-
-import httpx
-
-
-def _timeout(value: Any) -> Any:
-    if isinstance(value, ClientTimeout):
-        total = value.total or value.sock_read or 5.0
-        return httpx.Timeout(
-            total, connect=value.connect or value.sock_connect or total
-        )
-    if isinstance(value, tuple):
-        return httpx.Timeout(value[1], connect=value[0])
-    return value
-
-
-def _headers(defaults: Dict[str, str], supplied: Optional[dict]) -> Dict[str, str]:
-    headers = dict(defaults)
-    for key, value in (supplied or {}).items():
-        if value is None:
-            headers.pop(key, None)
-        else:
-            headers[key] = value
-    return headers
-
-
-class RequestsCompatResponse:
-    def __init__(self, response: httpx.Response):
-        self._response = response
-
-    def __getattr__(self, name: str) -> Any:
-        return getattr(self._response, name)
-
-    def iter_content(self, chunk_size: int) -> Iterator[bytes]:
-        return self._response.iter_bytes(chunk_size)
-
-    def close(self) -> None:
-        self._response.close()
-
-
-class RequestsCompatSession:
-    def __init__(self, client: Optional[httpx.Client] = None):
-        self._client = client or httpx.Client(timeout=None)
-        self.headers: Dict[str, str] = {}
-
-    def _request(self, method: str, url: str, **kwargs: Any) -> RequestsCompatResponse:
-        stream = kwargs.pop("stream", False)
-        kwargs["headers"] = _headers(self.headers, kwargs.get("headers"))
-        if "timeout" in kwargs:
-            kwargs["timeout"] = _timeout(kwargs["timeout"])
-        if stream:
-            request = self._client.build_request(method, url, **kwargs)
-            response = self._client.send(request, stream=True)
-        else:
-            response = self._client.request(method, url, **kwargs)
-        return RequestsCompatResponse(response)
-
-    def get(self, url: str, **kwargs: Any) -> RequestsCompatResponse:
-        return self._request("GET", url, **kwargs)
-
-    def post(self, url: str, **kwargs: Any) -> RequestsCompatResponse:
-        return self._request("POST", url, **kwargs)
-
-    def delete(self, url: str, **kwargs: Any) -> RequestsCompatResponse:
-        return self._request("DELETE", url, **kwargs)
-
-    def close(self) -> None:
-        self._client.close()
-
-
-class ClientTimeout:
-    def __init__(
-        self,
-        *,
-        total: Optional[float] = None,
-        connect: Optional[float] = None,
-        sock_connect: Optional[float] = None,
-        sock_read: Optional[float] = None,
-    ):
-        self.total = total
-        self.connect = connect
-        self.sock_connect = sock_connect
-        self.sock_read = sock_read
-
-
-class FormData:
-    def __init__(self):
-        self.fields: List[Tuple[str, Any, Optional[str], Optional[str]]] = []
-
-    def add_field(
-        self,
-        name: str,
-        value: Any,
-        *,
-        filename: Optional[str] = None,
-        content_type: Optional[str] = None,
-    ) -> None:
-        self.fields.append((name, value, filename, content_type))
-
-
-class _AsyncContent:
-    def __init__(self, response: httpx.Response):
-        self._response = response
-
-    async def iter_chunked(self, chunk_size: int) -> AsyncIterator[bytes]:
-        async for chunk in self._response.aiter_bytes(chunk_size):
-            yield chunk
-
-
-class AiohttpCompatResponse:
-    def __init__(self, response: httpx.Response):
-        self._response = response
-        self.status = response.status_code
-        self.headers = response.headers
-        self.content = _AsyncContent(response)
-
-    async def read(self) -> bytes:
-        return await self._response.aread()
-
-    async def text(self) -> str:
-        await self._response.aread()
-        return self._response.text
-
-    async def json(self) -> Any:
-        await self._response.aread()
-        return self._response.json()
-
-    async def close(self) -> None:
-        await self._response.aclose()
-
-
-class _AsyncRequestContext:
-    def __init__(self, request: Any):
-        self._request = request
-        self._response: Optional[AiohttpCompatResponse] = None
-
-    async def __aenter__(self) -> AiohttpCompatResponse:
-        response = await self._request
-        self._response = response
-        return response
-
-    async def __aexit__(self, exc_type: Any, exc: Any, tb: Any) -> None:
-        if self._response:
-            await self._response.close()
-
-
-class AiohttpCompatSession:
-    def __init__(
-        self,
-        headers: Optional[dict] = None,
-        client: Optional[httpx.AsyncClient] = None,
-    ):
-        self._client = client or httpx.AsyncClient(timeout=300)
-        self.headers = dict(headers or {})
-
-    async def _request(
-        self, method: str, url: str, **kwargs: Any
-    ) -> AiohttpCompatResponse:
-        kwargs["headers"] = _headers(self.headers, kwargs.get("headers"))
-        if "timeout" in kwargs:
-            kwargs["timeout"] = _timeout(kwargs["timeout"])
-        form = kwargs.get("data")
-        if isinstance(form, FormData):
-            kwargs.pop("data")
-            kwargs["data"] = {
-                name: value
-                for name, value, filename, _ in form.fields
-                if filename is None
-            }
-            kwargs["files"] = [
-                (name, (filename, value, content_type))
-                for name, value, filename, content_type in form.fields
-                if filename is not None
-            ]
-        request = self._client.build_request(method, url, **kwargs)
-        response = await self._client.send(request, stream=True)
-        return AiohttpCompatResponse(response)
-
-    def get(self, url: str, **kwargs: Any) -> _AsyncRequestContext:
-        return _AsyncRequestContext(self._request("GET", url, **kwargs))
-
-    def post(self, url: str, **kwargs: Any) -> _AsyncRequestContext:
-        return _AsyncRequestContext(self._request("POST", url, **kwargs))
-
-    def delete(self, url: str, **kwargs: Any) -> _AsyncRequestContext:
-        return _AsyncRequestContext(self._request("DELETE", url, **kwargs))
-
-    async def close(self) -> None:
-        await self._client.aclose()