spitch 1.4.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.4.0 → spitch-1.6.0}/CHANGELOG.md

@@ -1,5 +1,31 @@
 # 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)
+
+### Features
+
+* **api:** update via SDK Studio ([#26](https://github.com/spi-tch/spitch-python/issues/26)) ([1fb1268](https://github.com/spi-tch/spitch-python/commit/1fb12681c9bbdadd7dd4cb41f06ee03d38be235f))
+
 ## 1.4.0 (2024-10-07)
 
 Full Changelog: [v1.3.0...v1.4.0](https://github.com/spi-tch/spitch-python/compare/v1.3.0...v1.4.0)

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

@@ -1,6 +1,6 @@
 Metadata-Version: 2.3
 Name: spitch
-Version: 1.4.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
@@ -66,8 +66,10 @@ client = Spitch(
     api_key=os.environ.get("SPITCH_API_KEY"),
 )
 
-response = client.speech.transcibe(
+response = client.speech.generate(
     language="yo",
+    text="text",
+    voice="sade",
 )
 ```
 
@@ -92,8 +94,10 @@ client = AsyncSpitch(
 
 
 async def main() -> None:
-    response = await client.speech.transcibe(
+    response = await client.speech.generate(
         language="yo",
+        text="text",
+        voice="sade",
     )
 
 
@@ -127,8 +131,10 @@ from spitch import Spitch
 client = Spitch()
 
 try:
-    client.speech.transcibe(
+    client.speech.generate(
         language="yo",
+        text="text",
+        voice="sade",
     )
 except spitch.APIConnectionError as e:
     print("The server could not be reached")
@@ -172,8 +178,10 @@ client = Spitch(
 )
 
 # Or, configure per-request:
-client.with_options(max_retries=5).speech.transcibe(
+client.with_options(max_retries=5).speech.generate(
     language="yo",
+    text="text",
+    voice="sade",
 )
 ```
 
@@ -197,8 +205,10 @@ client = Spitch(
 )
 
 # Override per-request:
-client.with_options(timeout=5.0).speech.transcibe(
+client.with_options(timeout=5.0).speech.generate(
     language="yo",
+    text="text",
+    voice="sade",
 )
 ```
 
@@ -238,12 +248,14 @@ The "raw" Response object can be accessed by prefixing `.with_raw_response.` to
 from spitch import Spitch
 
 client = Spitch()
-response = client.speech.with_raw_response.transcibe(
+response = client.speech.with_raw_response.generate(
     language="yo",
+    text="text",
+    voice="sade",
 )
 print(response.headers.get('X-My-Header'))
 
-speech = response.parse()  # get the object that `speech.transcibe()` would have returned
+speech = response.parse()  # get the object that `speech.generate()` would have returned
 print(speech)
 ```
 
@@ -258,8 +270,10 @@ The above interface eagerly reads the full response body when you make the reque
 To stream the response body, use `.with_streaming_response` instead, which requires a context manager and only reads the response body once you call `.read()`, `.text()`, `.json()`, `.iter_bytes()`, `.iter_text()`, `.iter_lines()` or `.parse()`. In the async client, these are async methods.
 
 ```python
-with client.speech.with_streaming_response.transcibe(
+with client.speech.with_streaming_response.generate(
     language="yo",
+    text="text",
+    voice="sade",
 ) as response:
     print(response.headers.get("X-My-Header"))
 

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

@@ -32,8 +32,10 @@ client = Spitch(
     api_key=os.environ.get("SPITCH_API_KEY"),
 )
 
-response = client.speech.transcibe(
+response = client.speech.generate(
     language="yo",
+    text="text",
+    voice="sade",
 )
 ```
 
@@ -58,8 +60,10 @@ client = AsyncSpitch(
 
 
 async def main() -> None:
-    response = await client.speech.transcibe(
+    response = await client.speech.generate(
         language="yo",
+        text="text",
+        voice="sade",
     )
 
 
@@ -93,8 +97,10 @@ from spitch import Spitch
 client = Spitch()
 
 try:
-    client.speech.transcibe(
+    client.speech.generate(
         language="yo",
+        text="text",
+        voice="sade",
     )
 except spitch.APIConnectionError as e:
     print("The server could not be reached")
@@ -138,8 +144,10 @@ client = Spitch(
 )
 
 # Or, configure per-request:
-client.with_options(max_retries=5).speech.transcibe(
+client.with_options(max_retries=5).speech.generate(
     language="yo",
+    text="text",
+    voice="sade",
 )
 ```
 
@@ -163,8 +171,10 @@ client = Spitch(
 )
 
 # Override per-request:
-client.with_options(timeout=5.0).speech.transcibe(
+client.with_options(timeout=5.0).speech.generate(
     language="yo",
+    text="text",
+    voice="sade",
 )
 ```
 
@@ -204,12 +214,14 @@ The "raw" Response object can be accessed by prefixing `.with_raw_response.` to
 from spitch import Spitch
 
 client = Spitch()
-response = client.speech.with_raw_response.transcibe(
+response = client.speech.with_raw_response.generate(
     language="yo",
+    text="text",
+    voice="sade",
 )
 print(response.headers.get('X-My-Header'))
 
-speech = response.parse()  # get the object that `speech.transcibe()` would have returned
+speech = response.parse()  # get the object that `speech.generate()` would have returned
 print(speech)
 ```
 
@@ -224,8 +236,10 @@ The above interface eagerly reads the full response body when you make the reque
 To stream the response body, use `.with_streaming_response` instead, which requires a context manager and only reads the response body once you call `.read()`, `.text()`, `.json()`, `.iter_bytes()`, `.iter_text()`, `.iter_lines()` or `.parse()`. In the async client, these are async methods.
 
 ```python
-with client.speech.with_streaming_response.transcibe(
+with client.speech.with_streaming_response.generate(
     language="yo",
+    text="text",
+    voice="sade",
 ) as response:
     print(response.headers.get("X-My-Header"))
 

{spitch-1.4.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.4.0 → spitch-1.6.0}/pyproject.toml

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

{spitch-1.4.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.4.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.4.0"  # x-release-please-version
+__version__ = "1.6.0"  # x-release-please-version

{spitch-1.4.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.4.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.4.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.4.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))
@@ -699,12 +700,12 @@ class TestSpitch:
     @mock.patch("spitch._base_client.BaseClient._calculate_retry_timeout", _low_retry_timeout)
     @pytest.mark.respx(base_url=base_url)
     def test_retrying_timeout_errors_doesnt_leak(self, respx_mock: MockRouter) -> None:
-        respx_mock.post("/v1/transcriptions").mock(side_effect=httpx.TimeoutException("Test timeout error"))
+        respx_mock.post("/v1/speech").mock(side_effect=httpx.TimeoutException("Test timeout error"))
 
         with pytest.raises(APITimeoutError):
             self.client.post(
-                "/v1/transcriptions",
-                body=cast(object, dict(language="yo")),
+                "/v1/speech",
+                body=cast(object, dict(language="yo", text="text", voice="sade")),
                 cast_to=httpx.Response,
                 options={"headers": {RAW_RESPONSE_HEADER: "stream"}},
             )
@@ -714,12 +715,12 @@ class TestSpitch:
     @mock.patch("spitch._base_client.BaseClient._calculate_retry_timeout", _low_retry_timeout)
     @pytest.mark.respx(base_url=base_url)
     def test_retrying_status_errors_doesnt_leak(self, respx_mock: MockRouter) -> None:
-        respx_mock.post("/v1/transcriptions").mock(return_value=httpx.Response(500))
+        respx_mock.post("/v1/speech").mock(return_value=httpx.Response(500))
 
         with pytest.raises(APIStatusError):
             self.client.post(
-                "/v1/transcriptions",
-                body=cast(object, dict(language="yo")),
+                "/v1/speech",
+                body=cast(object, dict(language="yo", text="text", voice="sade")),
                 cast_to=httpx.Response,
                 options={"headers": {RAW_RESPONSE_HEADER: "stream"}},
             )
@@ -741,9 +742,9 @@ class TestSpitch:
                 return httpx.Response(500)
             return httpx.Response(200)
 
-        respx_mock.post("/v1/transcriptions").mock(side_effect=retry_handler)
+        respx_mock.post("/v1/speech").mock(side_effect=retry_handler)
 
-        response = client.speech.with_raw_response.transcibe(language="yo")
+        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
@@ -765,10 +766,10 @@ class TestSpitch:
                 return httpx.Response(500)
             return httpx.Response(200)
 
-        respx_mock.post("/v1/transcriptions").mock(side_effect=retry_handler)
+        respx_mock.post("/v1/speech").mock(side_effect=retry_handler)
 
-        response = client.speech.with_raw_response.transcibe(
-            language="yo", extra_headers={"x-stainless-retry-count": Omit()}
+        response = client.speech.with_raw_response.generate(
+            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
@@ -790,10 +791,10 @@ class TestSpitch:
                 return httpx.Response(500)
             return httpx.Response(200)
 
-        respx_mock.post("/v1/transcriptions").mock(side_effect=retry_handler)
+        respx_mock.post("/v1/speech").mock(side_effect=retry_handler)
 
-        response = client.speech.with_raw_response.transcibe(
-            language="yo", extra_headers={"x-stainless-retry-count": "42"}
+        response = client.speech.with_raw_response.generate(
+            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))
@@ -1469,12 +1471,12 @@ class TestAsyncSpitch:
     @mock.patch("spitch._base_client.BaseClient._calculate_retry_timeout", _low_retry_timeout)
     @pytest.mark.respx(base_url=base_url)
     async def test_retrying_timeout_errors_doesnt_leak(self, respx_mock: MockRouter) -> None:
-        respx_mock.post("/v1/transcriptions").mock(side_effect=httpx.TimeoutException("Test timeout error"))
+        respx_mock.post("/v1/speech").mock(side_effect=httpx.TimeoutException("Test timeout error"))
 
         with pytest.raises(APITimeoutError):
             await self.client.post(
-                "/v1/transcriptions",
-                body=cast(object, dict(language="yo")),
+                "/v1/speech",
+                body=cast(object, dict(language="yo", text="text", voice="sade")),
                 cast_to=httpx.Response,
                 options={"headers": {RAW_RESPONSE_HEADER: "stream"}},
             )
@@ -1484,12 +1486,12 @@ class TestAsyncSpitch:
     @mock.patch("spitch._base_client.BaseClient._calculate_retry_timeout", _low_retry_timeout)
     @pytest.mark.respx(base_url=base_url)
     async def test_retrying_status_errors_doesnt_leak(self, respx_mock: MockRouter) -> None:
-        respx_mock.post("/v1/transcriptions").mock(return_value=httpx.Response(500))
+        respx_mock.post("/v1/speech").mock(return_value=httpx.Response(500))
 
         with pytest.raises(APIStatusError):
             await self.client.post(
-                "/v1/transcriptions",
-                body=cast(object, dict(language="yo")),
+                "/v1/speech",
+                body=cast(object, dict(language="yo", text="text", voice="sade")),
                 cast_to=httpx.Response,
                 options={"headers": {RAW_RESPONSE_HEADER: "stream"}},
             )
@@ -1514,9 +1516,9 @@ class TestAsyncSpitch:
                 return httpx.Response(500)
             return httpx.Response(200)
 
-        respx_mock.post("/v1/transcriptions").mock(side_effect=retry_handler)
+        respx_mock.post("/v1/speech").mock(side_effect=retry_handler)
 
-        response = await client.speech.with_raw_response.transcibe(language="yo")
+        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
@@ -1539,10 +1541,10 @@ class TestAsyncSpitch:
                 return httpx.Response(500)
             return httpx.Response(200)
 
-        respx_mock.post("/v1/transcriptions").mock(side_effect=retry_handler)
+        respx_mock.post("/v1/speech").mock(side_effect=retry_handler)
 
-        response = await client.speech.with_raw_response.transcibe(
-            language="yo", extra_headers={"x-stainless-retry-count": Omit()}
+        response = await client.speech.with_raw_response.generate(
+            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
@@ -1565,10 +1567,10 @@ class TestAsyncSpitch:
                 return httpx.Response(500)
             return httpx.Response(200)
 
-        respx_mock.post("/v1/transcriptions").mock(side_effect=retry_handler)
+        respx_mock.post("/v1/speech").mock(side_effect=retry_handler)
 
-        response = await client.speech.with_raw_response.transcibe(
-            language="yo", extra_headers={"x-stainless-retry-count": "42"}
+        response = await client.speech.with_raw_response.generate(
+            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.4.0/.release-please-manifest.json

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