Release 1.1.9

Author: fern-api[bot]

.fern/metadata.json

@@ -0,0 +1,11 @@
+{
+  "cliVersion": "3.30.4",
+  "generatorName": "fernapi/fern-python-sdk",
+  "generatorVersion": "4.46.6",
+  "generatorConfig": {
+    "client_class_name": "Respeecher",
+    "use_typeddict_requests": true,
+    "should_generate_websocket_clients": true
+  },
+  "sdkVersion": "1.1.9"
+}

README.md

@@ -49,7 +49,7 @@ client.tts.bytes(
 
 ## Async Client
 
-The SDK also exports an `async` client so that you can make non-blocking calls to our API.
+The SDK also exports an `async` client so that you can make non-blocking calls to our API. Note that if you are constructing an Async httpx client class to pass into this client, use `httpx.AsyncClient()` instead of `httpx.Client()` (e.g. for the `httpx_client` parameter of this client).
 
 ```python
 import asyncio
@@ -234,7 +234,7 @@ from respeecher import Respeecher
 client = Respeecher(
     ...,
     httpx_client=httpx.Client(
-        proxies="http://my.test.proxy.example.com",
+        proxy="http://my.test.proxy.example.com",
         transport=httpx.HTTPTransport(local_address="0.0.0.0"),
     ),
 )

poetry.lock

@@ -1,9 +1,10 @@
 [project]
 name = "respeecher"
+dynamic = ["version"]
 
 [tool.poetry]
 name = "respeecher"
-version = "1.0.3"
+version = "1.1.9"
 description = "Respeecher API SDK"
 readme = "README.md"
 authors = []
@@ -30,7 +31,7 @@ packages = [
     { include = "respeecher", from = "src"}
 ]
 
-[project.urls]
+[tool.poetry.urls]
 Repository = 'https://github.com/respeecher/respeecher-python'
 
 [tool.poetry.dependencies]
@@ -45,6 +46,7 @@ websockets = ">=12.0"
 mypy = "==1.13.0"
 pytest = "^7.4.0"
 pytest-asyncio = "^0.23.5"
+pytest-xdist = "^3.6.1"
 python-dateutil = "^2.9.0"
 types-python-dateutil = "^2.9.0.20240316"
 ruff = "==0.11.5"

pyproject.toml

@@ -1,6 +1,6 @@
 # Reference
 ## Tts
-<details><summary><code>client.tts.<a href="src/respeecher/tts/client.py">bytes</a>(...)</code></summary>
+<details><summary><code>client.tts.<a href="src/respeecher/tts/client.py">bytes</a>(...) -> typing.AsyncIterator[AsyncHttpResponse[typing.AsyncIterator[bytes]]]</code></summary>
 <dl>
 <dd>
 
@@ -87,7 +87,7 @@ client.tts.bytes(
 </dl>
 </details>
 
-<details><summary><code>client.tts.<a href="src/respeecher/tts/client.py">sse</a>(...)</code></summary>
+<details><summary><code>client.tts.<a href="src/respeecher/tts/client.py">sse</a>(...) -> typing.AsyncIterator[AsyncHttpResponse[typing.AsyncIterator[ServerSentEvent]]]</code></summary>
 <dl>
 <dd>
 
@@ -177,7 +177,7 @@ for chunk in response.data:
 </details>
 
 ## Voices
-<details><summary><code>client.voices.<a href="src/respeecher/voices/client.py">list</a>()</code></summary>
+<details><summary><code>client.voices.<a href="src/respeecher/voices/client.py">list</a>() -> AsyncHttpResponse[typing.List[Voice]]</code></summary>
 <dl>
 <dd>
 

reference.md

@@ -2,11 +2,50 @@
 
 # isort: skip_file
 
-from . import tts, voices
-from .client import AsyncRespeecher, Respeecher
-from .environment import RespeecherEnvironment
-from .version import __version__
-from .voices import Gender, SamplingParams, SamplingParamsParams, Voice, VoiceParams
+import typing
+from importlib import import_module
+
+if typing.TYPE_CHECKING:
+    from . import tts, voices
+    from .client import AsyncRespeecher, Respeecher
+    from .environment import RespeecherEnvironment
+    from .version import __version__
+    from .voices import Gender, SamplingParams, SamplingParamsParams, Voice, VoiceParams
+_dynamic_imports: typing.Dict[str, str] = {
+    "AsyncRespeecher": ".client",
+    "Gender": ".voices",
+    "Respeecher": ".client",
+    "RespeecherEnvironment": ".environment",
+    "SamplingParams": ".voices",
+    "SamplingParamsParams": ".voices",
+    "Voice": ".voices",
+    "VoiceParams": ".voices",
+    "__version__": ".version",
+    "tts": ".tts",
+    "voices": ".voices",
+}
+
+
+def __getattr__(attr_name: str) -> typing.Any:
+    module_name = _dynamic_imports.get(attr_name)
+    if module_name is None:
+        raise AttributeError(f"No {attr_name} found in _dynamic_imports for module name -> {__name__}")
+    try:
+        module = import_module(module_name, __package__)
+        if module_name == f".{attr_name}":
+            return module
+        else:
+            return getattr(module, attr_name)
+    except ImportError as e:
+        raise ImportError(f"Failed to import {attr_name} from {module_name}: {e}") from e
+    except AttributeError as e:
+        raise AttributeError(f"Failed to get {attr_name} from {module_name}: {e}") from e
+
+
+def __dir__():
+    lazy_attrs = list(_dynamic_imports.keys())
+    return sorted(lazy_attrs)
+
 
 __all__ = [
     "AsyncRespeecher",

src/respeecher/__init__.py

@@ -1,14 +1,18 @@
 # This file was auto-generated by Fern from our API Definition.
 
+from __future__ import annotations
+
 import os
 import typing
 
 import httpx
 from .core.api_error import ApiError
 from .core.client_wrapper import AsyncClientWrapper, SyncClientWrapper
 from .environment import RespeecherEnvironment
-from .tts.client import AsyncTtsClient, TtsClient
-from .voices.client import AsyncVoicesClient, VoicesClient
+
+if typing.TYPE_CHECKING:
+    from .tts.client import AsyncTtsClient, TtsClient
+    from .voices.client import AsyncVoicesClient, VoicesClient
 
 
 class Respeecher:
@@ -76,8 +80,24 @@ def __init__(
             else httpx.Client(timeout=_defaulted_timeout),
             timeout=_defaulted_timeout,
         )
-        self.tts = TtsClient(client_wrapper=self._client_wrapper)
-        self.voices = VoicesClient(client_wrapper=self._client_wrapper)
+        self._tts: typing.Optional[TtsClient] = None
+        self._voices: typing.Optional[VoicesClient] = None
+
+    @property
+    def tts(self):
+        if self._tts is None:
+            from .tts.client import TtsClient  # noqa: E402
+
+            self._tts = TtsClient(client_wrapper=self._client_wrapper)
+        return self._tts
+
+    @property
+    def voices(self):
+        if self._voices is None:
+            from .voices.client import VoicesClient  # noqa: E402
+
+            self._voices = VoicesClient(client_wrapper=self._client_wrapper)
+        return self._voices
 
 
 class AsyncRespeecher:
@@ -145,5 +165,21 @@ def __init__(
             else httpx.AsyncClient(timeout=_defaulted_timeout),
             timeout=_defaulted_timeout,
         )
-        self.tts = AsyncTtsClient(client_wrapper=self._client_wrapper)
-        self.voices = AsyncVoicesClient(client_wrapper=self._client_wrapper)
+        self._tts: typing.Optional[AsyncTtsClient] = None
+        self._voices: typing.Optional[AsyncVoicesClient] = None
+
+    @property
+    def tts(self):
+        if self._tts is None:
+            from .tts.client import AsyncTtsClient  # noqa: E402
+
+            self._tts = AsyncTtsClient(client_wrapper=self._client_wrapper)
+        return self._tts
+
+    @property
+    def voices(self):
+        if self._voices is None:
+            from .voices.client import AsyncVoicesClient  # noqa: E402
+
+            self._voices = AsyncVoicesClient(client_wrapper=self._client_wrapper)
+        return self._voices

src/respeecher/client.py

@@ -2,27 +2,82 @@
 
 # isort: skip_file
 
-from .api_error import ApiError
-from .client_wrapper import AsyncClientWrapper, BaseClientWrapper, SyncClientWrapper
-from .datetime_utils import serialize_datetime
-from .events import EventEmitterMixin, EventType
-from .file import File, convert_file_dict_to_httpx_tuples, with_content_type
-from .http_client import AsyncHttpClient, HttpClient
-from .http_response import AsyncHttpResponse, HttpResponse
-from .jsonable_encoder import jsonable_encoder
-from .pydantic_utilities import (
-    IS_PYDANTIC_V2,
-    UniversalBaseModel,
-    UniversalRootModel,
-    parse_obj_as,
-    universal_field_validator,
-    universal_root_validator,
-    update_forward_refs,
-)
-from .query_encoder import encode_query
-from .remove_none_from_dict import remove_none_from_dict
-from .request_options import RequestOptions
-from .serialization import FieldMetadata, convert_and_respect_annotation_metadata
+import typing
+from importlib import import_module
+
+if typing.TYPE_CHECKING:
+    from .api_error import ApiError
+    from .client_wrapper import AsyncClientWrapper, BaseClientWrapper, SyncClientWrapper
+    from .datetime_utils import serialize_datetime
+    from .events import EventEmitterMixin, EventType
+    from .file import File, convert_file_dict_to_httpx_tuples, with_content_type
+    from .http_client import AsyncHttpClient, HttpClient
+    from .http_response import AsyncHttpResponse, HttpResponse
+    from .jsonable_encoder import jsonable_encoder
+    from .pydantic_utilities import (
+        IS_PYDANTIC_V2,
+        UniversalBaseModel,
+        UniversalRootModel,
+        parse_obj_as,
+        universal_field_validator,
+        universal_root_validator,
+        update_forward_refs,
+    )
+    from .query_encoder import encode_query
+    from .remove_none_from_dict import remove_none_from_dict
+    from .request_options import RequestOptions
+    from .serialization import FieldMetadata, convert_and_respect_annotation_metadata
+_dynamic_imports: typing.Dict[str, str] = {
+    "ApiError": ".api_error",
+    "AsyncClientWrapper": ".client_wrapper",
+    "AsyncHttpClient": ".http_client",
+    "AsyncHttpResponse": ".http_response",
+    "BaseClientWrapper": ".client_wrapper",
+    "EventEmitterMixin": ".events",
+    "EventType": ".events",
+    "FieldMetadata": ".serialization",
+    "File": ".file",
+    "HttpClient": ".http_client",
+    "HttpResponse": ".http_response",
+    "IS_PYDANTIC_V2": ".pydantic_utilities",
+    "RequestOptions": ".request_options",
+    "SyncClientWrapper": ".client_wrapper",
+    "UniversalBaseModel": ".pydantic_utilities",
+    "UniversalRootModel": ".pydantic_utilities",
+    "convert_and_respect_annotation_metadata": ".serialization",
+    "convert_file_dict_to_httpx_tuples": ".file",
+    "encode_query": ".query_encoder",
+    "jsonable_encoder": ".jsonable_encoder",
+    "parse_obj_as": ".pydantic_utilities",
+    "remove_none_from_dict": ".remove_none_from_dict",
+    "serialize_datetime": ".datetime_utils",
+    "universal_field_validator": ".pydantic_utilities",
+    "universal_root_validator": ".pydantic_utilities",
+    "update_forward_refs": ".pydantic_utilities",
+    "with_content_type": ".file",
+}
+
+
+def __getattr__(attr_name: str) -> typing.Any:
+    module_name = _dynamic_imports.get(attr_name)
+    if module_name is None:
+        raise AttributeError(f"No {attr_name} found in _dynamic_imports for module name -> {__name__}")
+    try:
+        module = import_module(module_name, __package__)
+        if module_name == f".{attr_name}":
+            return module
+        else:
+            return getattr(module, attr_name)
+    except ImportError as e:
+        raise ImportError(f"Failed to import {attr_name} from {module_name}: {e}") from e
+    except AttributeError as e:
+        raise AttributeError(f"Failed to get {attr_name} from {module_name}: {e}") from e
+
+
+def __dir__():
+    lazy_attrs = list(_dynamic_imports.keys())
+    return sorted(lazy_attrs)
+
 
 __all__ = [
     "ApiError",