typecast-python 0.3.6__tar.gz → 0.3.7__tar.gz

{typecast_python-0.3.6 → typecast_python-0.3.7}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: typecast-python
-Version: 0.3.6
+Version: 0.3.7
 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

{typecast_python-0.3.6 → typecast_python-0.3.7}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "hatchling.build"
 
 [project]
 name = "typecast-python"
-version = "0.3.6"
+version = "0.3.7"
 description = "Official Typecast Python SDK - Convert text to lifelike speech using AI-powered voices"
 authors = [
     {name = "Neosapience", email = "help@typecast.ai"}

typecast_python-0.3.7/src/typecast/_user_agent.py

@@ -0,0 +1,70 @@
+import platform
+import sys
+from importlib import metadata
+
+import aiohttp
+import requests
+
+from . import conf
+
+
+def _package_version(package_name: str) -> str:
+    try:
+        return metadata.version(package_name)
+    except metadata.PackageNotFoundError:
+        return "dev"
+
+
+def _os_name() -> str:
+    system = platform.system().lower()
+    if system == "darwin":
+        return "macos"
+    if system.startswith("windows"):
+        return "windows"
+    return system or "unknown"
+
+
+def _arch_name() -> str:
+    machine = platform.machine().lower()
+    if machine in {"x86_64", "amd64"}:
+        return "x64"
+    if machine in {"aarch64", "arm64"}:
+        return "arm64"
+    return machine or "unknown"
+
+
+def build_user_agent(
+    *,
+    mode: str,
+    http_library: str,
+    host: str,
+    transport: str = "rest",
+) -> str:
+    sdk_version = _package_version("typecast-python")
+    base = "default" if conf.is_default_host(host) else "custom"
+    return (
+        f"typecast-python/{sdk_version} "
+        f"Python/{sys.version_info.major}.{sys.version_info.minor} "
+        f"{platform.python_implementation()}/{platform.python_version()} "
+        f"{http_library} "
+        f"(mode={mode}; base={base}; transport={transport}; "
+        f"os={_os_name()}; arch={_arch_name()}; sdk_env=python; platform=server)"
+    )
+
+
+def requests_user_agent(host: str, transport: str = "rest") -> str:
+    return build_user_agent(
+        mode="sync",
+        http_library=f"requests/{requests.__version__}",
+        host=host,
+        transport=transport,
+    )
+
+
+def aiohttp_user_agent(host: str, transport: str = "rest") -> str:
+    return build_user_agent(
+        mode="async",
+        http_library=f"aiohttp/{aiohttp.__version__}",
+        host=host,
+        transport=transport,
+    )

{typecast_python-0.3.6 → typecast_python-0.3.7}/src/typecast/async_client.py

@@ -11,6 +11,7 @@ from ._voice_clone import (
     validate_clone_inputs,
     validate_custom_voice_id,
 )
+from ._user_agent import aiohttp_user_agent
 from .client import _guess_audio_mime
 from .client import _output_with_inferred_format
 from .client import _validate_output_path
@@ -81,7 +82,7 @@ class AsyncTypecast:
     async def __aenter__(self):
         # Auth header at session scope; per-request Content-Type is set by aiohttp
         # (json= auto-sets application/json, data=FormData() auto-sets multipart).
-        headers = {}
+        headers = {"User-Agent": aiohttp_user_agent(self.host)}
         if self.api_key:
             headers["X-API-KEY"] = self.api_key
         self.session = aiohttp.ClientSession(headers=headers)
@@ -203,7 +204,11 @@ class AsyncTypecast:
             NotFoundError, UnprocessableEntityError, RateLimitError,
             InternalServerError, TypecastError: depending on response status.
         """
-        if not isinstance(chunk_size, int) or isinstance(chunk_size, bool) or chunk_size < 1:
+        if (
+            not isinstance(chunk_size, int)
+            or isinstance(chunk_size, bool)
+            or chunk_size < 1
+        ):
             raise ValueError("chunk_size must be a positive integer")
         if not self.session:
             raise TypecastError("Client session not initialized. Use async with.")

{typecast_python-0.3.6 → typecast_python-0.3.7}/src/typecast/client.py

@@ -10,6 +10,7 @@ from ._voice_clone import (
     validate_clone_inputs,
     validate_custom_voice_id,
 )
+from ._user_agent import requests_user_agent
 from .composer import SpeechComposer
 from .exceptions import (
     BadRequestError,
@@ -111,7 +112,10 @@ class Typecast:
         if not self.api_key and conf.is_default_host(self.host):
             raise ValueError("API key is required for the default Typecast API host")
         self.session = requests.Session()
-        headers = {"Content-Type": "application/json"}
+        headers = {
+            "Content-Type": "application/json",
+            "User-Agent": requests_user_agent(self.host),
+        }
         if self.api_key:
             headers["X-API-KEY"] = self.api_key
         self.session.headers.update(headers)
@@ -236,7 +240,11 @@ class Typecast:
             NotFoundError, UnprocessableEntityError, RateLimitError,
             InternalServerError, TypecastError: depending on response status.
         """
-        if not isinstance(chunk_size, int) or isinstance(chunk_size, bool) or chunk_size < 1:
+        if (
+            not isinstance(chunk_size, int)
+            or isinstance(chunk_size, bool)
+            or chunk_size < 1
+        ):
             raise ValueError("chunk_size must be a positive integer")
         endpoint = "/v1/text-to-speech/stream"
         response = self.session.post(