murf 1.0.2__tar.gz → 1.2.0__tar.gz

{murf-1.0.2 → murf-1.2.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: murf
-Version: 1.0.2
+Version: 1.2.0
 Summary: 
 Requires-Python: >=3.8,<4.0
 Classifier: Intended Audience :: Developers
@@ -24,26 +24,49 @@ Requires-Dist: pydantic-core (>=2.18.2,<3.0.0)
 Requires-Dist: typing_extensions (>=4.0.0)
 Description-Content-Type: text/markdown
 
-# Murf Python Library
+# Murf Python SDK
+
+![Murf AI Logo](https://murf.ai/public-assets/home/Murf_Logo.png)
 
 [![fern shield](https://img.shields.io/badge/%F0%9F%8C%BF-Built%20with%20Fern-brightgreen)](https://buildwithfern.com?utm_source=github&utm_medium=github&utm_campaign=readme&utm_source=https%3A%2F%2Fgithub.com%2Fmurf-ai%2Fmurf-python-sdk)
 [![pypi](https://img.shields.io/pypi/v/murf)](https://pypi.python.org/pypi/murf)
+[![Open In Colab](https://colab.research.google.com/assets/colab-badge.svg)](https://colab.research.google.com/gist/devgeetech-murf/bbe2c7eb01433f4a151f0fd2be23b1c8/murf-python-sdk.ipynb)
+
+## Table of Contents
+
+- [Overview](#overview)
+- [Installation](#installation)
+- [Getting Started](#getting-started)
+- [Features](#features)
+- [Asynchronous Usage](#async-client)
+- [Exception Handling](#exception-handling)
+- [Advanced Configuration](#advanced)
+- [Contributing](#contributing)
+- [License](#license)
+
+---
+
+## Overview
+
+The Murf Python SDK offers seamless integration with the [Murf AI](https://murf.ai/) [text-to-speech software](https://murf.ai/text-to-speech), enabling developers and creators to convert text into lifelike speech effortlessly. With over 130 natural-sounding voices across 13+ languages and 20+ speaking styles, Murf provides unparalleled speech customization for a wide range of applications. The SDK is designed for both synchronous and asynchronous workflows, featuring robust error handling, advanced configuration options, and support for real-time applications.
 
-The Murf Python library provides convenient access to the Murf API from Python.
+---
 
 ## Installation
 
-```sh
+Check out the [HTTP API documentation](https://murf.ai/api/docs/introduction/quickstart).
+
+Install the SDK using pip:
+
+```bash
 pip install murf
 ```
 
-## Reference
-
-A full reference for this library is available [here](./reference.md).
+---
 
-## Usage
+## Getting Started
 
-Instantiate and use the client with the following:
+Here's a quick example to get you started with the Murf SDK:
 
 ```python
 from murf import Murf
@@ -59,6 +82,25 @@ client.text_to_speech.generate(
 )
 ```
 
+For more detailed information, refer to the [official documentation](https://murf.ai/api/docs/introduction/quickstart).
+
+---
+
+## Features
+
+- **Text-to-Speech Conversion:** Transform text into natural-sounding speech.
+- **Multilingual Support:** Access voices in over 13 languages, including English, French, German, Spanish, Italian, Hindi, Portuguese, Dutch, Korean, Chinese (Mandarin), Bengali, Tamil, and Polish.
+
+![Murf AI Languages](https://murf.ai/public-assets/home/Murf_Lang.png)
+
+- **Multiple Voice Styles:** Choose from 20+ speaking styles to suit your application's needs.
+- **Advanced Voice Customization:** Adjust parameters like pitch, speed, pauses, and pronunciation for optimal output. Fine-grained controls let you tailor the voice output to match your specific requirements.
+- **Multiple Audio Formats:** Generate audio in various formats (e.g., MP3, WAV) with configurable sample rates for optimal quality.
+- **Real-Time Processing:** Benefit from asynchronous API calls that support non-blocking, real-time audio generation and streaming scenarios.
+
+
+---
+
 ## Async Client
 
 The SDK also exports an `async` client so that you can make non-blocking calls to our API.
@@ -85,6 +127,8 @@ async def main() -> None:
 asyncio.run(main())
 ```
 
+---
+
 ## Exception Handling
 
 When the API returns a non-success status code (4xx or 5xx response), a subclass of the following error
@@ -100,6 +144,8 @@ except ApiError as e:
     print(e.body)
 ```
 
+---
+
 ## Advanced
 
 ### Retries
@@ -159,13 +205,17 @@ client = Murf(
 )
 ```
 
+---
+
 ## Contributing
 
-While we value open-source contributions to this SDK, this library is generated programmatically.
-Additions made directly to this library would have to be moved over to our generation code,
-otherwise they would be overwritten upon the next generated release. Feel free to open a PR as
-a proof of concept, but know that we will not be able to merge it as-is. We suggest opening
-an issue first to discuss with us!
+We welcome contributions to enhance the Murf Python SDK. Please note that this library is generated programmatically, so direct modifications may be overwritten. We suggest opening an issue first to discuss your ideas or improvements. Contributions to the documentation are especially appreciated! For any support queries email to support@murf.ai 
+
+---
+
+## License
+
+Murf Python SDK is released under the [MIT License](LICENSE).
 
-On the other hand, contributions to the README are always very welcome!
+---
 

murf-1.2.0/README.md

@@ -0,0 +1,194 @@
+# Murf Python SDK
+
+![Murf AI Logo](https://murf.ai/public-assets/home/Murf_Logo.png)
+
+[![fern shield](https://img.shields.io/badge/%F0%9F%8C%BF-Built%20with%20Fern-brightgreen)](https://buildwithfern.com?utm_source=github&utm_medium=github&utm_campaign=readme&utm_source=https%3A%2F%2Fgithub.com%2Fmurf-ai%2Fmurf-python-sdk)
+[![pypi](https://img.shields.io/pypi/v/murf)](https://pypi.python.org/pypi/murf)
+[![Open In Colab](https://colab.research.google.com/assets/colab-badge.svg)](https://colab.research.google.com/gist/devgeetech-murf/bbe2c7eb01433f4a151f0fd2be23b1c8/murf-python-sdk.ipynb)
+
+## Table of Contents
+
+- [Overview](#overview)
+- [Installation](#installation)
+- [Getting Started](#getting-started)
+- [Features](#features)
+- [Asynchronous Usage](#async-client)
+- [Exception Handling](#exception-handling)
+- [Advanced Configuration](#advanced)
+- [Contributing](#contributing)
+- [License](#license)
+
+---
+
+## Overview
+
+The Murf Python SDK offers seamless integration with the [Murf AI](https://murf.ai/) [text-to-speech software](https://murf.ai/text-to-speech), enabling developers and creators to convert text into lifelike speech effortlessly. With over 130 natural-sounding voices across 13+ languages and 20+ speaking styles, Murf provides unparalleled speech customization for a wide range of applications. The SDK is designed for both synchronous and asynchronous workflows, featuring robust error handling, advanced configuration options, and support for real-time applications.
+
+---
+
+## Installation
+
+Check out the [HTTP API documentation](https://murf.ai/api/docs/introduction/quickstart).
+
+Install the SDK using pip:
+
+```bash
+pip install murf
+```
+
+---
+
+## Getting Started
+
+Here's a quick example to get you started with the Murf SDK:
+
+```python
+from murf import Murf
+
+client = Murf(
+    api_key="YOUR_API_KEY",
+)
+client.text_to_speech.generate(
+    format="MP3",
+    sample_rate=44100.0,
+    text="Hello, world!",
+    voice_id="en-US-natalie",
+)
+```
+
+For more detailed information, refer to the [official documentation](https://murf.ai/api/docs/introduction/quickstart).
+
+---
+
+## Features
+
+- **Text-to-Speech Conversion:** Transform text into natural-sounding speech.
+- **Multilingual Support:** Access voices in over 13 languages, including English, French, German, Spanish, Italian, Hindi, Portuguese, Dutch, Korean, Chinese (Mandarin), Bengali, Tamil, and Polish.
+
+![Murf AI Languages](https://murf.ai/public-assets/home/Murf_Lang.png)
+
+- **Multiple Voice Styles:** Choose from 20+ speaking styles to suit your application's needs.
+- **Advanced Voice Customization:** Adjust parameters like pitch, speed, pauses, and pronunciation for optimal output. Fine-grained controls let you tailor the voice output to match your specific requirements.
+- **Multiple Audio Formats:** Generate audio in various formats (e.g., MP3, WAV) with configurable sample rates for optimal quality.
+- **Real-Time Processing:** Benefit from asynchronous API calls that support non-blocking, real-time audio generation and streaming scenarios.
+
+
+---
+
+## Async Client
+
+The SDK also exports an `async` client so that you can make non-blocking calls to our API.
+
+```python
+import asyncio
+
+from murf import AsyncMurf
+
+client = AsyncMurf(
+    api_key="YOUR_API_KEY",
+)
+
+
+async def main() -> None:
+    await client.text_to_speech.generate(
+        format="MP3",
+        sample_rate=44100.0,
+        text="Hello, world!",
+        voice_id="en-US-natalie",
+    )
+
+
+asyncio.run(main())
+```
+
+---
+
+## Exception Handling
+
+When the API returns a non-success status code (4xx or 5xx response), a subclass of the following error
+will be thrown.
+
+```python
+from murf.core.api_error import ApiError
+
+try:
+    client.text_to_speech.generate(...)
+except ApiError as e:
+    print(e.status_code)
+    print(e.body)
+```
+
+---
+
+## Advanced
+
+### Retries
+
+The SDK is instrumented with automatic retries with exponential backoff. A request will be retried as long
+as the request is deemed retriable and the number of retry attempts has not grown larger than the configured
+retry limit (default: 2).
+
+A request is deemed retriable when any of the following HTTP status codes is returned:
+
+- [408](https://developer.mozilla.org/en-US/docs/Web/HTTP/Status/408) (Timeout)
+- [429](https://developer.mozilla.org/en-US/docs/Web/HTTP/Status/429) (Too Many Requests)
+- [5XX](https://developer.mozilla.org/en-US/docs/Web/HTTP/Status/500) (Internal Server Errors)
+
+Use the `max_retries` request option to configure this behavior.
+
+```python
+client.text_to_speech.generate(..., request_options={
+    "max_retries": 1
+})
+```
+
+### Timeouts
+
+The SDK defaults to a 60 second timeout. You can configure this with a timeout option at the client or request level.
+
+```python
+
+from murf import Murf
+
+client = Murf(
+    ...,
+    timeout=20.0,
+)
+
+
+# Override timeout for a specific method
+client.text_to_speech.generate(..., request_options={
+    "timeout_in_seconds": 1
+})
+```
+
+### Custom Client
+
+You can override the `httpx` client to customize it for your use-case. Some common use-cases include support for proxies
+and transports.
+```python
+import httpx
+from murf import Murf
+
+client = Murf(
+    ...,
+    httpx_client=httpx.Client(
+        proxies="http://my.test.proxy.example.com",
+        transport=httpx.HTTPTransport(local_address="0.0.0.0"),
+    ),
+)
+```
+
+---
+
+## Contributing
+
+We welcome contributions to enhance the Murf Python SDK. Please note that this library is generated programmatically, so direct modifications may be overwritten. We suggest opening an issue first to discuss your ideas or improvements. Contributions to the documentation are especially appreciated! For any support queries email to support@murf.ai 
+
+---
+
+## License
+
+Murf Python SDK is released under the [MIT License](LICENSE).
+
+---

{murf-1.0.2 → murf-1.2.0}/pyproject.toml

@@ -3,7 +3,7 @@ name = "murf"
 
 [tool.poetry]
 name = "murf"
-version = "1.0.2"
+version = "1.2.0"
 description = ""
 readme = "README.md"
 authors = []

{murf-1.0.2 → murf-1.2.0}/src/murf/__init__.py

@@ -1,12 +1,24 @@
 # This file was auto-generated by Fern from our API Definition.
 
 from .types import (
+    ApiJobResponse,
+    ApiJobResponseDubbingType,
+    ApiJobResponsePriority,
+    ApiProjectResponse,
+    ApiProjectResponseDubbingType,
     ApiVoice,
     ApiVoiceGender,
     AuthTokenResponse,
+    DubApiDetailResponse,
+    DubJobStatusResponse,
+    FormDataContentDisposition,
     GenerateSpeechResponse,
+    GroupApiProjectResponse,
+    LocaleResponse,
+    LocaleResponseSupportsItem,
     PronunciationDetail,
     PronunciationDetailType,
+    SourceLocaleResponse,
     StyleDetails,
     WordDuration,
 )
@@ -18,32 +30,47 @@ from .errors import (
     ServiceUnavailableError,
     UnauthorizedError,
 )
-from . import auth, text_to_speech
+from . import auth, dubbing, text_to_speech
 from .client import AsyncMurf, Murf
+from .dubbing_client import MurfDub
 from .environment import MurfEnvironment
 from .text_to_speech import GenerateSpeechRequestModelVersion
 from .version import __version__
 
 __all__ = [
+    "ApiJobResponse",
+    "ApiJobResponseDubbingType",
+    "ApiJobResponsePriority",
+    "ApiProjectResponse",
+    "ApiProjectResponseDubbingType",
     "ApiVoice",
     "ApiVoiceGender",
     "AsyncMurf",
     "AuthTokenResponse",
     "BadRequestError",
+    "DubApiDetailResponse",
+    "DubJobStatusResponse",
     "ForbiddenError",
+    "FormDataContentDisposition",
     "GenerateSpeechRequestModelVersion",
     "GenerateSpeechResponse",
+    "GroupApiProjectResponse",
     "InternalServerError",
+    "LocaleResponse",
+    "LocaleResponseSupportsItem",
     "Murf",
+    "MurfDub",
     "MurfEnvironment",
     "PaymentRequiredError",
     "PronunciationDetail",
     "PronunciationDetailType",
     "ServiceUnavailableError",
+    "SourceLocaleResponse",
     "StyleDetails",
     "UnauthorizedError",
     "WordDuration",
     "__version__",
     "auth",
+    "dubbing",
     "text_to_speech",
 ]

{murf-1.0.2 → murf-1.2.0}/src/murf/base_client.py

@@ -6,9 +6,11 @@ import httpx
 from .core.client_wrapper import SyncClientWrapper
 from .auth.client import AuthClient
 from .text_to_speech.client import TextToSpeechClient
+from .dubbing.client import DubbingClient
 from .core.client_wrapper import AsyncClientWrapper
 from .auth.client import AsyncAuthClient
 from .text_to_speech.client import AsyncTextToSpeechClient
+from .dubbing.client import AsyncDubbingClient
 
 
 class BaseClient:
@@ -71,6 +73,7 @@ class BaseClient:
         )
         self.auth = AuthClient(client_wrapper=self._client_wrapper)
         self.text_to_speech = TextToSpeechClient(client_wrapper=self._client_wrapper)
+        self.dubbing = DubbingClient(client_wrapper=self._client_wrapper)
 
 
 class AsyncBaseClient:
@@ -133,6 +136,7 @@ class AsyncBaseClient:
         )
         self.auth = AsyncAuthClient(client_wrapper=self._client_wrapper)
         self.text_to_speech = AsyncTextToSpeechClient(client_wrapper=self._client_wrapper)
+        self.dubbing = AsyncDubbingClient(client_wrapper=self._client_wrapper)
 
 
 def _get_base_url(*, base_url: typing.Optional[str] = None, environment: MurfEnvironment) -> str:

{murf-1.0.2 → murf-1.2.0}/src/murf/client.py

@@ -59,6 +59,7 @@ class Murf(BaseClient):
             follow_redirects=follow_redirects,
             httpx_client=httpx_client
         )
+        self.dubbing = None # type: ignore
 
 
 class AsyncMurf(AsyncBaseClient):
@@ -115,4 +116,5 @@ class AsyncMurf(AsyncBaseClient):
             timeout=timeout,
             follow_redirects=follow_redirects,
             httpx_client=httpx_client
-        )
+        )
+        self.dubbing = None # type: ignore

{murf-1.0.2 → murf-1.2.0}/src/murf/core/client_wrapper.py

@@ -16,7 +16,7 @@ class BaseClientWrapper:
         headers: typing.Dict[str, str] = {
             "X-Fern-Language": "Python",
             "X-Fern-SDK-Name": "murf",
-            "X-Fern-SDK-Version": "1.0.2",
+            "X-Fern-SDK-Version": "1.2.0",
         }
         if self._api_key is not None:
             headers["api-key"] = self._api_key

murf-1.2.0/src/murf/dubbing/__init__.py

@@ -0,0 +1,14 @@
+# This file was auto-generated by Fern from our API Definition.
+
+from . import jobs, languages, projects
+from .jobs import JobsCreateRequestPriority, JobsCreateWithProjectIdRequestPriority
+from .projects import ApiCreateProjectRequestDubbingType
+
+__all__ = [
+    "ApiCreateProjectRequestDubbingType",
+    "JobsCreateRequestPriority",
+    "JobsCreateWithProjectIdRequestPriority",
+    "jobs",
+    "languages",
+    "projects",
+]

murf-1.2.0/src/murf/dubbing/client.py

@@ -0,0 +1,26 @@
+# This file was auto-generated by Fern from our API Definition.
+
+from ..core.client_wrapper import SyncClientWrapper
+from .languages.client import LanguagesClient
+from .jobs.client import JobsClient
+from .projects.client import ProjectsClient
+from ..core.client_wrapper import AsyncClientWrapper
+from .languages.client import AsyncLanguagesClient
+from .jobs.client import AsyncJobsClient
+from .projects.client import AsyncProjectsClient
+
+
+class DubbingClient:
+    def __init__(self, *, client_wrapper: SyncClientWrapper):
+        self._client_wrapper = client_wrapper
+        self.languages = LanguagesClient(client_wrapper=self._client_wrapper)
+        self.jobs = JobsClient(client_wrapper=self._client_wrapper)
+        self.projects = ProjectsClient(client_wrapper=self._client_wrapper)
+
+
+class AsyncDubbingClient:
+    def __init__(self, *, client_wrapper: AsyncClientWrapper):
+        self._client_wrapper = client_wrapper
+        self.languages = AsyncLanguagesClient(client_wrapper=self._client_wrapper)
+        self.jobs = AsyncJobsClient(client_wrapper=self._client_wrapper)
+        self.projects = AsyncProjectsClient(client_wrapper=self._client_wrapper)

murf-1.2.0/src/murf/dubbing/jobs/__init__.py

@@ -0,0 +1,5 @@
+# This file was auto-generated by Fern from our API Definition.
+
+from .types import JobsCreateRequestPriority, JobsCreateWithProjectIdRequestPriority
+
+__all__ = ["JobsCreateRequestPriority", "JobsCreateWithProjectIdRequestPriority"]