typecast-python 0.3.6__py3-none-any.whl → 0.3.7__py3-none-any.whl

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/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/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(

{typecast_python-0.3.6.dist-info → typecast_python-0.3.7.dist-info}/METADATA

@@ -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.dist-info → typecast_python-0.3.7.dist-info}/RECORD

@@ -1,7 +1,8 @@
 typecast/__init__.py,sha256=3pdJqNkXCZ7svzqab4sBR_qwyoM5E2sPjfuci1g1Ub8,1047
+typecast/_user_agent.py,sha256=R_0eSKpuP9jLp_wDJcJGFvFtUh9BZwEgsT1buVeHRAA,1786
 typecast/_voice_clone.py,sha256=TN2tbB3b5lC5uFCBnbERhz37bNJlbv6VZ-vj70EfTs4,3464
-typecast/async_client.py,sha256=OwCqOUa82xvcSTbMYkRHsw_QK828gshrOV7IZotV8Ig,18611
-typecast/client.py,sha256=befvVQUzZXJ0E_almTW9aKyi2HvcjrdDirucbdd2E6U,17800
+typecast/async_client.py,sha256=65dx24vxiZGpNAGMzxr_7CsG51qZMNAraCuzKjW0e-E,18746
+typecast/client.py,sha256=jFts3z0vmtGb32rGJ8_Wcswu6mo6oXVNzdW9MD3GqGE,17974
 typecast/composer.py,sha256=r1kpRGlSJ1s4C1PkE7yIpGwnKtxYfIdFSLWaf8v1RAQ,9422
 typecast/conf.py,sha256=yfOHYZDvIshWWMriN5wE0GFPR8AX3zv4Rg2655OvA9Q,724
 typecast/exceptions.py,sha256=Y0ZzYebe8zOSOSAHbXfKR0G_RJgdmZXxi15Z7ZxPLIk,1568
@@ -11,7 +12,7 @@ typecast/models/error.py,sha256=XomIjx7jvlCjItqzJuCAT4mXC9jwTjxR8lLDUk6P8KA,152
 typecast/models/subscription.py,sha256=EIaAAo3cCRw8LYT_O6D9AVwxqIHrWCijzl4UTx7FZB8,894
 typecast/models/tts.py,sha256=W2Bp9M-xPJPODlk89P9CnLA2fwb__4SR4yoMkG_O8kA,16453
 typecast/models/voices.py,sha256=-EXP35jDy7_G30k5bDnVrFJHp6svEDTA5jJ8oHAgXNQ,2310
-typecast_python-0.3.6.dist-info/METADATA,sha256=lK8mTT7BBgfvCThmHehW0tCutsi8_yIPF6U6QoHmUX4,25530
-typecast_python-0.3.6.dist-info/WHEEL,sha256=mffPy8wBnZQn2VnJUU5jE99KsxaSfiyMHV9Yt0aLVxs,87
-typecast_python-0.3.6.dist-info/licenses/LICENSE,sha256=HvtJ-S89uUkuYmt-OvVk4MRxmzwtbn84__qJtSrGU2Q,11348
-typecast_python-0.3.6.dist-info/RECORD,,
+typecast_python-0.3.7.dist-info/METADATA,sha256=louuBNIHV_BGlSbchFiyXEaxSW4B-NxyH4AThzJqSAc,25530
+typecast_python-0.3.7.dist-info/WHEEL,sha256=mffPy8wBnZQn2VnJUU5jE99KsxaSfiyMHV9Yt0aLVxs,87
+typecast_python-0.3.7.dist-info/licenses/LICENSE,sha256=HvtJ-S89uUkuYmt-OvVk4MRxmzwtbn84__qJtSrGU2Q,11348
+typecast_python-0.3.7.dist-info/RECORD,,