spitch 1.5.0__tar.gz → 1.6.0__tar.gz

spitch-1.6.0/.release-please-manifest.json

@@ -0,0 +1,3 @@
+{
+  ".": "1.6.0"
+}

{spitch-1.5.0 → spitch-1.6.0}/CHANGELOG.md

@@ -1,5 +1,23 @@
 # Changelog
 
+## 1.6.0 (2024-10-07)
+
+Full Changelog: [v1.5.0...v1.6.0](https://github.com/spi-tch/spitch-python/compare/v1.5.0...v1.6.0)
+
+### Features
+
+* **api:** update via SDK Studio ([#29](https://github.com/spi-tch/spitch-python/issues/29)) ([1dae398](https://github.com/spi-tch/spitch-python/commit/1dae398c9f7ba96bc45d59f4faa2934b2cad59e4))
+
+
+### Bug Fixes
+
+* **client:** avoid OverflowError with very large retry counts ([#30](https://github.com/spi-tch/spitch-python/issues/30)) ([1e63664](https://github.com/spi-tch/spitch-python/commit/1e63664f64fa1f38f2294df8e06bd60a17885d2f))
+
+
+### Chores
+
+* add repr to PageInfo class ([#32](https://github.com/spi-tch/spitch-python/issues/32)) ([ea3c95d](https://github.com/spi-tch/spitch-python/commit/ea3c95d2ce4a9fdd1e558931f8a92904a9394321))
+
 ## 1.5.0 (2024-10-07)
 
 Full Changelog: [v1.4.0...v1.5.0](https://github.com/spi-tch/spitch-python/compare/v1.4.0...v1.5.0)

{spitch-1.5.0 → spitch-1.6.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.3
 Name: spitch
-Version: 1.5.0
+Version: 1.6.0
 Summary: The official Python library for the spitch API
 Project-URL: Homepage, https://github.com/spi-tch/spitch-python
 Project-URL: Repository, https://github.com/spi-tch/spitch-python
@@ -69,6 +69,7 @@ client = Spitch(
 response = client.speech.generate(
     language="yo",
     text="text",
+    voice="sade",
 )
 ```
 
@@ -96,6 +97,7 @@ async def main() -> None:
     response = await client.speech.generate(
         language="yo",
         text="text",
+        voice="sade",
     )
 
 
@@ -132,6 +134,7 @@ try:
     client.speech.generate(
         language="yo",
         text="text",
+        voice="sade",
     )
 except spitch.APIConnectionError as e:
     print("The server could not be reached")
@@ -178,6 +181,7 @@ client = Spitch(
 client.with_options(max_retries=5).speech.generate(
     language="yo",
     text="text",
+    voice="sade",
 )
 ```
 
@@ -204,6 +208,7 @@ client = Spitch(
 client.with_options(timeout=5.0).speech.generate(
     language="yo",
     text="text",
+    voice="sade",
 )
 ```
 
@@ -246,6 +251,7 @@ client = Spitch()
 response = client.speech.with_raw_response.generate(
     language="yo",
     text="text",
+    voice="sade",
 )
 print(response.headers.get('X-My-Header'))
 
@@ -267,6 +273,7 @@ To stream the response body, use `.with_streaming_response` instead, which requi
 with client.speech.with_streaming_response.generate(
     language="yo",
     text="text",
+    voice="sade",
 ) as response:
     print(response.headers.get("X-My-Header"))
 

{spitch-1.5.0 → spitch-1.6.0}/README.md

@@ -35,6 +35,7 @@ client = Spitch(
 response = client.speech.generate(
     language="yo",
     text="text",
+    voice="sade",
 )
 ```
 
@@ -62,6 +63,7 @@ async def main() -> None:
     response = await client.speech.generate(
         language="yo",
         text="text",
+        voice="sade",
     )
 
 
@@ -98,6 +100,7 @@ try:
     client.speech.generate(
         language="yo",
         text="text",
+        voice="sade",
     )
 except spitch.APIConnectionError as e:
     print("The server could not be reached")
@@ -144,6 +147,7 @@ client = Spitch(
 client.with_options(max_retries=5).speech.generate(
     language="yo",
     text="text",
+    voice="sade",
 )
 ```
 
@@ -170,6 +174,7 @@ client = Spitch(
 client.with_options(timeout=5.0).speech.generate(
     language="yo",
     text="text",
+    voice="sade",
 )
 ```
 
@@ -212,6 +217,7 @@ client = Spitch()
 response = client.speech.with_raw_response.generate(
     language="yo",
     text="text",
+    voice="sade",
 )
 print(response.headers.get('X-My-Header'))
 
@@ -233,6 +239,7 @@ To stream the response body, use `.with_streaming_response` instead, which requi
 with client.speech.with_streaming_response.generate(
     language="yo",
     text="text",
+    voice="sade",
 ) as response:
     print(response.headers.get("X-My-Header"))
 

{spitch-1.5.0 → spitch-1.6.0}/examples/example.py

@@ -13,7 +13,8 @@ def main() -> None:
     start_time = time.time()
     with client.speech.with_streaming_response.generate(
         language="yo",
-        text="Bawo ni ololufe?"
+        text="Bawo ni ololufe?",
+        voice="funmi"
     ) as speech:
         print(f"Time to first byte: {int((time.time() - start_time) * 1000)}ms")
         speech.stream_to_file(speech_file_path)

{spitch-1.5.0 → spitch-1.6.0}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "spitch"
-version = "1.5.0"
+version = "1.6.0"
 description = "The official Python library for the spitch API"
 dynamic = ["readme"]
 license = "Apache-2.0"

{spitch-1.5.0 → spitch-1.6.0}/src/spitch/_base_client.py

@@ -143,6 +143,12 @@ class PageInfo:
         self.url = url
         self.params = params
 
+    @override
+    def __repr__(self) -> str:
+        if self.url:
+            return f"{self.__class__.__name__}(url={self.url})"
+        return f"{self.__class__.__name__}(params={self.params})"
+
 
 class BasePage(GenericModel, Generic[_T]):
     """
@@ -689,7 +695,8 @@ class BaseClient(Generic[_HttpxClientT, _DefaultStreamT]):
         if retry_after is not None and 0 < retry_after <= 60:
             return retry_after
 
-        nb_retries = max_retries - remaining_retries
+        # Also cap retry count to 1000 to avoid any potential overflows with `pow`
+        nb_retries = min(max_retries - remaining_retries, 1000)
 
         # Apply exponential backoff, but not more than the max.
         sleep_seconds = min(INITIAL_RETRY_DELAY * pow(2.0, nb_retries), MAX_RETRY_DELAY)

{spitch-1.5.0 → spitch-1.6.0}/src/spitch/_version.py

@@ -1,4 +1,4 @@
 # File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
 
 __title__ = "spitch"
-__version__ = "1.5.0"  # x-release-please-version
+__version__ = "1.6.0"  # x-release-please-version

{spitch-1.5.0 → spitch-1.6.0}/src/spitch/resources/speech.py

@@ -61,7 +61,7 @@ class SpeechResource(SyncAPIResource):
         *,
         language: Literal["yo", "en", "ha", "ig"],
         text: str,
-        voice: Literal["sade", "segun", "femi", "funmi"] | NotGiven = NOT_GIVEN,
+        voice: Literal["sade", "segun", "femi", "funmi"],
         # Use the following arguments if you need to pass additional parameters to the API that aren't available via kwargs.
         # The extra values given here take precedence over values defined on the client or passed to this method.
         extra_headers: Headers | None = None,
@@ -171,7 +171,7 @@ class AsyncSpeechResource(AsyncAPIResource):
         *,
         language: Literal["yo", "en", "ha", "ig"],
         text: str,
-        voice: Literal["sade", "segun", "femi", "funmi"] | NotGiven = NOT_GIVEN,
+        voice: Literal["sade", "segun", "femi", "funmi"],
         # Use the following arguments if you need to pass additional parameters to the API that aren't available via kwargs.
         # The extra values given here take precedence over values defined on the client or passed to this method.
         extra_headers: Headers | None = None,

{spitch-1.5.0 → spitch-1.6.0}/src/spitch/types/speech_generate_params.py

@@ -12,4 +12,4 @@ class SpeechGenerateParams(TypedDict, total=False):
 
     text: Required[str]
 
-    voice: Literal["sade", "segun", "femi", "funmi"]
+    voice: Required[Literal["sade", "segun", "femi", "funmi"]]

{spitch-1.5.0 → spitch-1.6.0}/tests/api_resources/test_speech.py

@@ -27,19 +27,6 @@ class TestSpeech:
     @parametrize
     @pytest.mark.respx(base_url=base_url)
     def test_method_generate(self, client: Spitch, respx_mock: MockRouter) -> None:
-        respx_mock.post("/v1/speech").mock(return_value=httpx.Response(200, json={"foo": "bar"}))
-        speech = client.speech.generate(
-            language="yo",
-            text="text",
-        )
-        assert speech.is_closed
-        assert speech.json() == {"foo": "bar"}
-        assert cast(Any, speech.is_closed) is True
-        assert isinstance(speech, BinaryAPIResponse)
-
-    @parametrize
-    @pytest.mark.respx(base_url=base_url)
-    def test_method_generate_with_all_params(self, client: Spitch, respx_mock: MockRouter) -> None:
         respx_mock.post("/v1/speech").mock(return_value=httpx.Response(200, json={"foo": "bar"}))
         speech = client.speech.generate(
             language="yo",
@@ -59,6 +46,7 @@ class TestSpeech:
         speech = client.speech.with_raw_response.generate(
             language="yo",
             text="text",
+            voice="sade",
         )
 
         assert speech.is_closed is True
@@ -73,6 +61,7 @@ class TestSpeech:
         with client.speech.with_streaming_response.generate(
             language="yo",
             text="text",
+            voice="sade",
         ) as speech:
             assert not speech.is_closed
             assert speech.http_request.headers.get("X-Stainless-Lang") == "python"
@@ -130,19 +119,6 @@ class TestAsyncSpeech:
     @parametrize
     @pytest.mark.respx(base_url=base_url)
     async def test_method_generate(self, async_client: AsyncSpitch, respx_mock: MockRouter) -> None:
-        respx_mock.post("/v1/speech").mock(return_value=httpx.Response(200, json={"foo": "bar"}))
-        speech = await async_client.speech.generate(
-            language="yo",
-            text="text",
-        )
-        assert speech.is_closed
-        assert await speech.json() == {"foo": "bar"}
-        assert cast(Any, speech.is_closed) is True
-        assert isinstance(speech, AsyncBinaryAPIResponse)
-
-    @parametrize
-    @pytest.mark.respx(base_url=base_url)
-    async def test_method_generate_with_all_params(self, async_client: AsyncSpitch, respx_mock: MockRouter) -> None:
         respx_mock.post("/v1/speech").mock(return_value=httpx.Response(200, json={"foo": "bar"}))
         speech = await async_client.speech.generate(
             language="yo",
@@ -162,6 +138,7 @@ class TestAsyncSpeech:
         speech = await async_client.speech.with_raw_response.generate(
             language="yo",
             text="text",
+            voice="sade",
         )
 
         assert speech.is_closed is True
@@ -176,6 +153,7 @@ class TestAsyncSpeech:
         async with async_client.speech.with_streaming_response.generate(
             language="yo",
             text="text",
+            voice="sade",
         ) as speech:
             assert not speech.is_closed
             assert speech.http_request.headers.get("X-Stainless-Lang") == "python"

{spitch-1.5.0 → spitch-1.6.0}/tests/test_client.py

@@ -685,6 +685,7 @@ class TestSpitch:
             [3, "", 0.5],
             [2, "", 0.5 * 2.0],
             [1, "", 0.5 * 4.0],
+            [-1100, "", 7.8],  # test large number potentially overflowing
         ],
     )
     @mock.patch("time.time", mock.MagicMock(return_value=1696004797))
@@ -704,7 +705,7 @@ class TestSpitch:
         with pytest.raises(APITimeoutError):
             self.client.post(
                 "/v1/speech",
-                body=cast(object, dict(language="yo", text="text")),
+                body=cast(object, dict(language="yo", text="text", voice="sade")),
                 cast_to=httpx.Response,
                 options={"headers": {RAW_RESPONSE_HEADER: "stream"}},
             )
@@ -719,7 +720,7 @@ class TestSpitch:
         with pytest.raises(APIStatusError):
             self.client.post(
                 "/v1/speech",
-                body=cast(object, dict(language="yo", text="text")),
+                body=cast(object, dict(language="yo", text="text", voice="sade")),
                 cast_to=httpx.Response,
                 options={"headers": {RAW_RESPONSE_HEADER: "stream"}},
             )
@@ -743,7 +744,7 @@ class TestSpitch:
 
         respx_mock.post("/v1/speech").mock(side_effect=retry_handler)
 
-        response = client.speech.with_raw_response.generate(language="yo", text="text")
+        response = client.speech.with_raw_response.generate(language="yo", text="text", voice="sade")
 
         assert response.retries_taken == failures_before_success
         assert int(response.http_request.headers.get("x-stainless-retry-count")) == failures_before_success
@@ -768,7 +769,7 @@ class TestSpitch:
         respx_mock.post("/v1/speech").mock(side_effect=retry_handler)
 
         response = client.speech.with_raw_response.generate(
-            language="yo", text="text", extra_headers={"x-stainless-retry-count": Omit()}
+            language="yo", text="text", voice="sade", extra_headers={"x-stainless-retry-count": Omit()}
         )
 
         assert len(response.http_request.headers.get_list("x-stainless-retry-count")) == 0
@@ -793,7 +794,7 @@ class TestSpitch:
         respx_mock.post("/v1/speech").mock(side_effect=retry_handler)
 
         response = client.speech.with_raw_response.generate(
-            language="yo", text="text", extra_headers={"x-stainless-retry-count": "42"}
+            language="yo", text="text", voice="sade", extra_headers={"x-stainless-retry-count": "42"}
         )
 
         assert response.http_request.headers.get("x-stainless-retry-count") == "42"
@@ -1454,6 +1455,7 @@ class TestAsyncSpitch:
             [3, "", 0.5],
             [2, "", 0.5 * 2.0],
             [1, "", 0.5 * 4.0],
+            [-1100, "", 7.8],  # test large number potentially overflowing
         ],
     )
     @mock.patch("time.time", mock.MagicMock(return_value=1696004797))
@@ -1474,7 +1476,7 @@ class TestAsyncSpitch:
         with pytest.raises(APITimeoutError):
             await self.client.post(
                 "/v1/speech",
-                body=cast(object, dict(language="yo", text="text")),
+                body=cast(object, dict(language="yo", text="text", voice="sade")),
                 cast_to=httpx.Response,
                 options={"headers": {RAW_RESPONSE_HEADER: "stream"}},
             )
@@ -1489,7 +1491,7 @@ class TestAsyncSpitch:
         with pytest.raises(APIStatusError):
             await self.client.post(
                 "/v1/speech",
-                body=cast(object, dict(language="yo", text="text")),
+                body=cast(object, dict(language="yo", text="text", voice="sade")),
                 cast_to=httpx.Response,
                 options={"headers": {RAW_RESPONSE_HEADER: "stream"}},
             )
@@ -1516,7 +1518,7 @@ class TestAsyncSpitch:
 
         respx_mock.post("/v1/speech").mock(side_effect=retry_handler)
 
-        response = await client.speech.with_raw_response.generate(language="yo", text="text")
+        response = await client.speech.with_raw_response.generate(language="yo", text="text", voice="sade")
 
         assert response.retries_taken == failures_before_success
         assert int(response.http_request.headers.get("x-stainless-retry-count")) == failures_before_success
@@ -1542,7 +1544,7 @@ class TestAsyncSpitch:
         respx_mock.post("/v1/speech").mock(side_effect=retry_handler)
 
         response = await client.speech.with_raw_response.generate(
-            language="yo", text="text", extra_headers={"x-stainless-retry-count": Omit()}
+            language="yo", text="text", voice="sade", extra_headers={"x-stainless-retry-count": Omit()}
         )
 
         assert len(response.http_request.headers.get_list("x-stainless-retry-count")) == 0
@@ -1568,7 +1570,7 @@ class TestAsyncSpitch:
         respx_mock.post("/v1/speech").mock(side_effect=retry_handler)
 
         response = await client.speech.with_raw_response.generate(
-            language="yo", text="text", extra_headers={"x-stainless-retry-count": "42"}
+            language="yo", text="text", voice="sade", extra_headers={"x-stainless-retry-count": "42"}
         )
 
         assert response.http_request.headers.get("x-stainless-retry-count") == "42"

spitch-1.5.0/.release-please-manifest.json

@@ -1,3 +0,0 @@
-{
-  ".": "1.5.0"
-}