spitch 1.6.0__tar.gz → 1.8.0__tar.gz

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

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

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

@@ -1,5 +1,22 @@
 # Changelog
 
+## 1.8.0 (2024-10-17)
+
+Full Changelog: [v1.7.0...v1.8.0](https://github.com/spi-tch/spitch-python/compare/v1.7.0...v1.8.0)
+
+### Features
+
+* **api:** api update ([#37](https://github.com/spi-tch/spitch-python/issues/37)) ([34e4fba](https://github.com/spi-tch/spitch-python/commit/34e4fba09e3744cfb443a3a0de5bf6a59bac50bc))
+* **api:** api update ([#39](https://github.com/spi-tch/spitch-python/issues/39)) ([4cc3eb2](https://github.com/spi-tch/spitch-python/commit/4cc3eb24be8de66ae662de62c45818c0100bf894))
+
+## 1.7.0 (2024-10-14)
+
+Full Changelog: [v1.6.0...v1.7.0](https://github.com/spi-tch/spitch-python/compare/v1.6.0...v1.7.0)
+
+### Features
+
+* **api:** api update ([#34](https://github.com/spi-tch/spitch-python/issues/34)) ([1cfe384](https://github.com/spi-tch/spitch-python/commit/1cfe38416d8c82453609132080a167c0ab735f51))
+
 ## 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)

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

@@ -1,6 +1,6 @@
 Metadata-Version: 2.3
 Name: spitch
-Version: 1.6.0
+Version: 1.8.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,7 +69,6 @@ client = Spitch(
 response = client.speech.generate(
     language="yo",
     text="text",
-    voice="sade",
 )
 ```
 
@@ -97,7 +96,6 @@ async def main() -> None:
     response = await client.speech.generate(
         language="yo",
         text="text",
-        voice="sade",
     )
 
 
@@ -134,7 +132,6 @@ try:
     client.speech.generate(
         language="yo",
         text="text",
-        voice="sade",
     )
 except spitch.APIConnectionError as e:
     print("The server could not be reached")
@@ -181,7 +178,6 @@ client = Spitch(
 client.with_options(max_retries=5).speech.generate(
     language="yo",
     text="text",
-    voice="sade",
 )
 ```
 
@@ -208,7 +204,6 @@ client = Spitch(
 client.with_options(timeout=5.0).speech.generate(
     language="yo",
     text="text",
-    voice="sade",
 )
 ```
 
@@ -251,7 +246,6 @@ client = Spitch()
 response = client.speech.with_raw_response.generate(
     language="yo",
     text="text",
-    voice="sade",
 )
 print(response.headers.get('X-My-Header'))
 
@@ -273,7 +267,6 @@ 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.6.0 → spitch-1.8.0}/README.md

@@ -35,7 +35,6 @@ client = Spitch(
 response = client.speech.generate(
     language="yo",
     text="text",
-    voice="sade",
 )
 ```
 
@@ -63,7 +62,6 @@ async def main() -> None:
     response = await client.speech.generate(
         language="yo",
         text="text",
-        voice="sade",
     )
 
 
@@ -100,7 +98,6 @@ try:
     client.speech.generate(
         language="yo",
         text="text",
-        voice="sade",
     )
 except spitch.APIConnectionError as e:
     print("The server could not be reached")
@@ -147,7 +144,6 @@ client = Spitch(
 client.with_options(max_retries=5).speech.generate(
     language="yo",
     text="text",
-    voice="sade",
 )
 ```
 
@@ -174,7 +170,6 @@ client = Spitch(
 client.with_options(timeout=5.0).speech.generate(
     language="yo",
     text="text",
-    voice="sade",
 )
 ```
 
@@ -217,7 +212,6 @@ client = Spitch()
 response = client.speech.with_raw_response.generate(
     language="yo",
     text="text",
-    voice="sade",
 )
 print(response.headers.get('X-My-Header'))
 
@@ -239,7 +233,6 @@ 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.8.0/api.md

@@ -0,0 +1,25 @@
+# Speech
+
+Types:
+
+```python
+from spitch.types import SpeechGenerateResponse, SpeechTranscribeResponse
+```
+
+Methods:
+
+- <code title="post /v1/speech">client.speech.<a href="./src/spitch/resources/speech.py">generate</a>(\*\*<a href="src/spitch/types/speech_generate_params.py">params</a>) -> <a href="./src/spitch/types/speech_generate_response.py">object</a></code>
+- <code title="post /v1/transcriptions">client.speech.<a href="./src/spitch/resources/speech.py">transcribe</a>(\*\*<a href="src/spitch/types/speech_transcribe_params.py">params</a>) -> <a href="./src/spitch/types/speech_transcribe_response.py">object</a></code>
+
+# Text
+
+Types:
+
+```python
+from spitch.types import TextToneMarkResponse, TextTranslateResponse
+```
+
+Methods:
+
+- <code title="post /v1/diacritics">client.text.<a href="./src/spitch/resources/text.py">tone_mark</a>(\*\*<a href="src/spitch/types/text_tone_mark_params.py">params</a>) -> <a href="./src/spitch/types/text_tone_mark_response.py">object</a></code>
+- <code title="post /v1/translate">client.text.<a href="./src/spitch/resources/text.py">translate</a>(\*\*<a href="src/spitch/types/text_translate_params.py">params</a>) -> <a href="./src/spitch/types/text_translate_response.py">object</a></code>

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

@@ -1,6 +1,6 @@
 [project]
 name = "spitch"
-version = "1.6.0"
+version = "1.8.0"
 description = "The official Python library for the spitch API"
 dynamic = ["readme"]
 license = "Apache-2.0"
@@ -63,11 +63,12 @@ format = { chain = [
   "format:ruff",
   "format:docs",
   "fix:ruff",
+  # run formatting again to fix any inconsistencies when imports are stripped
+  "format:ruff",
 ]}
 "format:black" = "black ."
 "format:docs" = "python scripts/utils/ruffen-docs.py README.md api.md"
 "format:ruff" = "ruff format"
-"format:isort" = "isort ."
 
 "lint" = { chain = [
   "check:ruff",

{spitch-1.6.0 → spitch-1.8.0}/requirements-dev.lock

@@ -80,7 +80,7 @@ pytz==2023.3.post1
     # via dirty-equals
 respx==0.20.2
 rich==13.7.1
-ruff==0.6.5
+ruff==0.6.9
 setuptools==68.2.2
     # via nodeenv
 six==1.16.0

{spitch-1.6.0 → spitch-1.8.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.6.0"  # x-release-please-version
+__version__ = "1.8.0"  # x-release-please-version

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

@@ -7,7 +7,7 @@ from typing_extensions import Literal
 
 import httpx
 
-from ..types import speech_generate_params, speech_transcibe_params
+from ..types import speech_generate_params, speech_transcribe_params
 from .._types import NOT_GIVEN, Body, Query, Headers, NotGiven, FileTypes
 from .._utils import (
     extract_files,
@@ -18,18 +18,10 @@ from .._utils import (
 from .._compat import cached_property
 from .._resource import SyncAPIResource, AsyncAPIResource
 from .._response import (
-    BinaryAPIResponse,
-    AsyncBinaryAPIResponse,
-    StreamedBinaryAPIResponse,
-    AsyncStreamedBinaryAPIResponse,
     to_raw_response_wrapper,
     to_streamed_response_wrapper,
     async_to_raw_response_wrapper,
-    to_custom_raw_response_wrapper,
     async_to_streamed_response_wrapper,
-    to_custom_streamed_response_wrapper,
-    async_to_custom_raw_response_wrapper,
-    async_to_custom_streamed_response_wrapper,
 )
 from .._base_client import make_request_options
 
@@ -61,14 +53,15 @@ class SpeechResource(SyncAPIResource):
         *,
         language: Literal["yo", "en", "ha", "ig"],
         text: str,
-        voice: Literal["sade", "segun", "femi", "funmi"],
+        stream: bool | NotGiven = NOT_GIVEN,
+        voice: Literal["sade", "segun", "femi", "funmi"] | NotGiven = NOT_GIVEN,
         # 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,
         extra_query: Query | None = None,
         extra_body: Body | None = None,
         timeout: float | httpx.Timeout | None | NotGiven = NOT_GIVEN,
-    ) -> BinaryAPIResponse:
+    ) -> object:
         """
         Synthesize
 
@@ -81,7 +74,6 @@ class SpeechResource(SyncAPIResource):
 
           timeout: Override the client-level default timeout for this request, in seconds
         """
-        extra_headers = {"Accept": "audio/wav", **(extra_headers or {})}
         return self._post(
             "/v1/speech",
             body=maybe_transform(
@@ -93,16 +85,22 @@ class SpeechResource(SyncAPIResource):
                 speech_generate_params.SpeechGenerateParams,
             ),
             options=make_request_options(
-                extra_headers=extra_headers, extra_query=extra_query, extra_body=extra_body, timeout=timeout
+                extra_headers=extra_headers,
+                extra_query=extra_query,
+                extra_body=extra_body,
+                timeout=timeout,
+                query=maybe_transform({"stream": stream}, speech_generate_params.SpeechGenerateParams),
             ),
-            cast_to=BinaryAPIResponse,
+            cast_to=object,
         )
 
-    def transcibe(
+    def transcribe(
         self,
         *,
         language: Literal["yo", "en", "ha", "ig"],
         content: Optional[FileTypes] | NotGiven = NOT_GIVEN,
+        multispeaker: Optional[bool] | NotGiven = NOT_GIVEN,
+        timestamp: Optional[bool] | NotGiven = NOT_GIVEN,
         url: Optional[str] | NotGiven = NOT_GIVEN,
         # 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.
@@ -127,6 +125,8 @@ class SpeechResource(SyncAPIResource):
             {
                 "language": language,
                 "content": content,
+                "multispeaker": multispeaker,
+                "timestamp": timestamp,
                 "url": url,
             }
         )
@@ -137,7 +137,7 @@ class SpeechResource(SyncAPIResource):
         extra_headers = {"Content-Type": "multipart/form-data", **(extra_headers or {})}
         return self._post(
             "/v1/transcriptions",
-            body=maybe_transform(body, speech_transcibe_params.SpeechTranscibeParams),
+            body=maybe_transform(body, speech_transcribe_params.SpeechTranscribeParams),
             files=files,
             options=make_request_options(
                 extra_headers=extra_headers, extra_query=extra_query, extra_body=extra_body, timeout=timeout
@@ -171,14 +171,15 @@ class AsyncSpeechResource(AsyncAPIResource):
         *,
         language: Literal["yo", "en", "ha", "ig"],
         text: str,
-        voice: Literal["sade", "segun", "femi", "funmi"],
+        stream: bool | NotGiven = NOT_GIVEN,
+        voice: Literal["sade", "segun", "femi", "funmi"] | NotGiven = NOT_GIVEN,
         # 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,
         extra_query: Query | None = None,
         extra_body: Body | None = None,
         timeout: float | httpx.Timeout | None | NotGiven = NOT_GIVEN,
-    ) -> AsyncBinaryAPIResponse:
+    ) -> object:
         """
         Synthesize
 
@@ -191,7 +192,6 @@ class AsyncSpeechResource(AsyncAPIResource):
 
           timeout: Override the client-level default timeout for this request, in seconds
         """
-        extra_headers = {"Accept": "audio/wav", **(extra_headers or {})}
         return await self._post(
             "/v1/speech",
             body=await async_maybe_transform(
@@ -203,16 +203,22 @@ class AsyncSpeechResource(AsyncAPIResource):
                 speech_generate_params.SpeechGenerateParams,
             ),
             options=make_request_options(
-                extra_headers=extra_headers, extra_query=extra_query, extra_body=extra_body, timeout=timeout
+                extra_headers=extra_headers,
+                extra_query=extra_query,
+                extra_body=extra_body,
+                timeout=timeout,
+                query=await async_maybe_transform({"stream": stream}, speech_generate_params.SpeechGenerateParams),
             ),
-            cast_to=AsyncBinaryAPIResponse,
+            cast_to=object,
         )
 
-    async def transcibe(
+    async def transcribe(
         self,
         *,
         language: Literal["yo", "en", "ha", "ig"],
         content: Optional[FileTypes] | NotGiven = NOT_GIVEN,
+        multispeaker: Optional[bool] | NotGiven = NOT_GIVEN,
+        timestamp: Optional[bool] | NotGiven = NOT_GIVEN,
         url: Optional[str] | NotGiven = NOT_GIVEN,
         # 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.
@@ -237,6 +243,8 @@ class AsyncSpeechResource(AsyncAPIResource):
             {
                 "language": language,
                 "content": content,
+                "multispeaker": multispeaker,
+                "timestamp": timestamp,
                 "url": url,
             }
         )
@@ -247,7 +255,7 @@ class AsyncSpeechResource(AsyncAPIResource):
         extra_headers = {"Content-Type": "multipart/form-data", **(extra_headers or {})}
         return await self._post(
             "/v1/transcriptions",
-            body=await async_maybe_transform(body, speech_transcibe_params.SpeechTranscibeParams),
+            body=await async_maybe_transform(body, speech_transcribe_params.SpeechTranscribeParams),
             files=files,
             options=make_request_options(
                 extra_headers=extra_headers, extra_query=extra_query, extra_body=extra_body, timeout=timeout
@@ -260,12 +268,11 @@ class SpeechResourceWithRawResponse:
     def __init__(self, speech: SpeechResource) -> None:
         self._speech = speech
 
-        self.generate = to_custom_raw_response_wrapper(
+        self.generate = to_raw_response_wrapper(
             speech.generate,
-            BinaryAPIResponse,
         )
-        self.transcibe = to_raw_response_wrapper(
-            speech.transcibe,
+        self.transcribe = to_raw_response_wrapper(
+            speech.transcribe,
         )
 
 
@@ -273,12 +280,11 @@ class AsyncSpeechResourceWithRawResponse:
     def __init__(self, speech: AsyncSpeechResource) -> None:
         self._speech = speech
 
-        self.generate = async_to_custom_raw_response_wrapper(
+        self.generate = async_to_raw_response_wrapper(
             speech.generate,
-            AsyncBinaryAPIResponse,
         )
-        self.transcibe = async_to_raw_response_wrapper(
-            speech.transcibe,
+        self.transcribe = async_to_raw_response_wrapper(
+            speech.transcribe,
         )
 
 
@@ -286,12 +292,12 @@ class SpeechResourceWithStreamingResponse:
     def __init__(self, speech: SpeechResource) -> None:
         self._speech = speech
 
-        self.generate = to_custom_streamed_response_wrapper(
+        self.generate = to_streamed_response_wrapper(
             speech.generate,
             StreamedBinaryAPIResponse
         )
-        self.transcibe = to_streamed_response_wrapper(
-            speech.transcibe,
+        self.transcribe = to_streamed_response_wrapper(
+            speech.transcribe,
         )
 
 
@@ -299,10 +305,10 @@ class AsyncSpeechResourceWithStreamingResponse:
     def __init__(self, speech: AsyncSpeechResource) -> None:
         self._speech = speech
 
-        self.generate = async_to_custom_streamed_response_wrapper(
+        self.generate = async_to_streamed_response_wrapper(
             speech.generate,
             AsyncStreamedBinaryAPIResponse
         )
-        self.transcibe = async_to_streamed_response_wrapper(
-            speech.transcibe,
+        self.transcribe = async_to_streamed_response_wrapper(
+            speech.transcribe,
         )

{spitch-1.6.0 → spitch-1.8.0}/src/spitch/resources/text.py

@@ -6,7 +6,7 @@ from typing_extensions import Literal
 
 import httpx
 
-from ..types import text_tone_mark_params
+from ..types import text_tone_mark_params, text_translate_params
 from .._types import NOT_GIVEN, Body, Query, Headers, NotGiven
 from .._utils import (
     maybe_transform,
@@ -84,6 +84,47 @@ class TextResource(SyncAPIResource):
             cast_to=object,
         )
 
+    def translate(
+        self,
+        *,
+        source: Literal["yo", "en", "ha", "ig"],
+        target: Literal["yo", "en", "ha", "ig"],
+        text: str,
+        # 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,
+        extra_query: Query | None = None,
+        extra_body: Body | None = None,
+        timeout: float | httpx.Timeout | None | NotGiven = NOT_GIVEN,
+    ) -> object:
+        """
+        Translate
+
+        Args:
+          extra_headers: Send extra headers
+
+          extra_query: Add additional query parameters to the request
+
+          extra_body: Add additional JSON properties to the request
+
+          timeout: Override the client-level default timeout for this request, in seconds
+        """
+        return self._post(
+            "/v1/translate",
+            body=maybe_transform(
+                {
+                    "source": source,
+                    "target": target,
+                    "text": text,
+                },
+                text_translate_params.TextTranslateParams,
+            ),
+            options=make_request_options(
+                extra_headers=extra_headers, extra_query=extra_query, extra_body=extra_body, timeout=timeout
+            ),
+            cast_to=object,
+        )
+
 
 class AsyncTextResource(AsyncAPIResource):
     @cached_property
@@ -144,6 +185,47 @@ class AsyncTextResource(AsyncAPIResource):
             cast_to=object,
         )
 
+    async def translate(
+        self,
+        *,
+        source: Literal["yo", "en", "ha", "ig"],
+        target: Literal["yo", "en", "ha", "ig"],
+        text: str,
+        # 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,
+        extra_query: Query | None = None,
+        extra_body: Body | None = None,
+        timeout: float | httpx.Timeout | None | NotGiven = NOT_GIVEN,
+    ) -> object:
+        """
+        Translate
+
+        Args:
+          extra_headers: Send extra headers
+
+          extra_query: Add additional query parameters to the request
+
+          extra_body: Add additional JSON properties to the request
+
+          timeout: Override the client-level default timeout for this request, in seconds
+        """
+        return await self._post(
+            "/v1/translate",
+            body=await async_maybe_transform(
+                {
+                    "source": source,
+                    "target": target,
+                    "text": text,
+                },
+                text_translate_params.TextTranslateParams,
+            ),
+            options=make_request_options(
+                extra_headers=extra_headers, extra_query=extra_query, extra_body=extra_body, timeout=timeout
+            ),
+            cast_to=object,
+        )
+
 
 class TextResourceWithRawResponse:
     def __init__(self, text: TextResource) -> None:
@@ -152,6 +234,9 @@ class TextResourceWithRawResponse:
         self.tone_mark = to_raw_response_wrapper(
             text.tone_mark,
         )
+        self.translate = to_raw_response_wrapper(
+            text.translate,
+        )
 
 
 class AsyncTextResourceWithRawResponse:
@@ -161,6 +246,9 @@ class AsyncTextResourceWithRawResponse:
         self.tone_mark = async_to_raw_response_wrapper(
             text.tone_mark,
         )
+        self.translate = async_to_raw_response_wrapper(
+            text.translate,
+        )
 
 
 class TextResourceWithStreamingResponse:
@@ -170,6 +258,9 @@ class TextResourceWithStreamingResponse:
         self.tone_mark = to_streamed_response_wrapper(
             text.tone_mark,
         )
+        self.translate = to_streamed_response_wrapper(
+            text.translate,
+        )
 
 
 class AsyncTextResourceWithStreamingResponse:
@@ -179,3 +270,6 @@ class AsyncTextResourceWithStreamingResponse:
         self.tone_mark = async_to_streamed_response_wrapper(
             text.tone_mark,
         )
+        self.translate = async_to_streamed_response_wrapper(
+            text.translate,
+        )

{spitch-1.6.0 → spitch-1.8.0}/src/spitch/types/__init__.py

@@ -3,5 +3,6 @@
 from __future__ import annotations
 
 from .text_tone_mark_params import TextToneMarkParams as TextToneMarkParams
+from .text_translate_params import TextTranslateParams as TextTranslateParams
 from .speech_generate_params import SpeechGenerateParams as SpeechGenerateParams
-from .speech_transcibe_params import SpeechTranscibeParams as SpeechTranscibeParams
+from .speech_transcribe_params import SpeechTranscribeParams as SpeechTranscribeParams

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

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

spitch-1.8.0/src/spitch/types/speech_transcribe_params.py

@@ -0,0 +1,22 @@
+# File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+from __future__ import annotations
+
+from typing import Optional
+from typing_extensions import Literal, Required, TypedDict
+
+from .._types import FileTypes
+
+__all__ = ["SpeechTranscribeParams"]
+
+
+class SpeechTranscribeParams(TypedDict, total=False):
+    language: Required[Literal["yo", "en", "ha", "ig"]]
+
+    content: Optional[FileTypes]
+
+    multispeaker: Optional[bool]
+
+    timestamp: Optional[bool]
+
+    url: Optional[str]

spitch-1.8.0/src/spitch/types/text_translate_params.py

@@ -0,0 +1,15 @@
+# File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+from __future__ import annotations
+
+from typing_extensions import Literal, Required, TypedDict
+
+__all__ = ["TextTranslateParams"]
+
+
+class TextTranslateParams(TypedDict, total=False):
+    source: Required[Literal["yo", "en", "ha", "ig"]]
+
+    target: Required[Literal["yo", "en", "ha", "ig"]]
+
+    text: Required[str]