cartesia 1.0.1__py2.py3-none-any.whl → 1.0.3__py2.py3-none-any.whl

cartesia/utils/deprecated.py

@@ -0,0 +1,53 @@
+import os
+import warnings
+from typing import Any, Callable, TypeVar
+
+TCallable = TypeVar("TCallable", bound=Callable[..., Any])
+
+# List of statistics of deprecated functions.
+# This should only be used by the test suite to find any deprecated functions
+# that should be removed for this version.
+_TRACK_DEPRECATED_FUNCTION_STATS = os.environ.get("CARTESIA_TEST_DEPRECATED", "").lower() == "true"
+_DEPRECATED_FUNCTION_STATS = []
+
+
+def deprecated(
+    reason=None, vdeprecated=None, vremove=None, replacement=None
+) -> Callable[[TCallable], TCallable]:
+    local_vars = locals()
+
+    def fn(func: TCallable) -> TCallable:
+        msg = _get_deprecated_msg(func, reason, vdeprecated, vremove, replacement)
+        warnings.warn(msg, DeprecationWarning)
+        return func
+
+    if _TRACK_DEPRECATED_FUNCTION_STATS:  # pragma: no cover
+        _DEPRECATED_FUNCTION_STATS.append(local_vars)
+
+    return fn
+
+
+def _get_deprecated_msg(wrapped, reason, vdeprecated, vremoved, replacement=None):
+    fmt = "{name} is deprecated"
+    if vdeprecated:
+        fmt += " since v{vdeprecated}"
+    if vremoved:
+        fmt += " and will be removed in v{vremoved}"
+    fmt += "."
+
+    if reason:
+        fmt += " ({reason})"
+    if replacement:
+        fmt += " -- Use {replacement} instead."
+
+    return fmt.format(
+        name=wrapped.__name__,
+        reason=reason or "",
+        vdeprecated=vdeprecated or "",
+        vremoved=vremoved or "",
+        replacement=replacement or "",
+    )
+
+
+# This method is taken from the following source:
+# https://github.com/ad12/meddlr/blob/main/meddlr/utils/deprecated.py

cartesia/utils/retry.py

@@ -0,0 +1,87 @@
+import time
+
+from aiohttp.client_exceptions import ServerDisconnectedError
+import asyncio
+from functools import wraps
+from http.client import RemoteDisconnected
+from httpx import TimeoutException
+from requests.exceptions import ConnectionError
+
+
+def retry_on_connection_error(max_retries=3, backoff_factor=1, logger=None):
+    """Retry a function if a ConnectionError, RemoteDisconnected, ServerDisconnectedError, or TimeoutException occurs.
+
+    Args:
+        max_retries (int): The maximum number of retries.
+        backoff_factor (int): The factor to increase the delay between retries.
+        logger (logging.Logger): The logger to use for logging.
+    """
+
+    def decorator(func):
+        @wraps(func)
+        def wrapper(*args, **kwargs):
+            retry_count = 0
+            while retry_count < max_retries:
+                try:
+                    return func(*args, **kwargs)
+                except (
+                    ConnectionError,
+                    RemoteDisconnected,
+                    ServerDisconnectedError,
+                    TimeoutException,
+                ) as e:
+                    logger.info(f"Retrying after exception: {e}")
+                    retry_count += 1
+                    if retry_count < max_retries:
+                        delay = backoff_factor * (2 ** (retry_count - 1))
+                        logger.warn(
+                            f"Attempt {retry_count + 1}/{max_retries} in {delay} seconds..."
+                        )
+                        time.sleep(delay)
+                    else:
+                        raise Exception(f"Exception occurred after {max_retries} tries.") from e
+
+        return wrapper
+
+    return decorator
+
+
+def retry_on_connection_error_async(max_retries=3, backoff_factor=1, logger=None):
+    """Retry an asynchronous function if a ConnectionError, RemoteDisconnected, ServerDisconnectedError, or TimeoutException occurs.
+
+    Args:
+        max_retries (int): The maximum number of retries.
+        backoff_factor (int): The factor to increase the delay between retries.
+        logger (logging.Logger): The logger to use for logging.
+    """
+
+    def decorator(func):
+        @wraps(func)
+        async def wrapper(*args, **kwargs):
+            retry_count = 0
+            while retry_count < max_retries:
+                try:
+                    async for chunk in func(*args, **kwargs):
+                        yield chunk
+                    # If the function completes without raising an exception return
+                    return
+                except (
+                    ConnectionError,
+                    RemoteDisconnected,
+                    ServerDisconnectedError,
+                    TimeoutException,
+                ) as e:
+                    logger.info(f"Retrying after exception: {e}")
+                    retry_count += 1
+                    if retry_count < max_retries:
+                        delay = backoff_factor * (2 ** (retry_count - 1))
+                        logger.warn(
+                            f"Attempt {retry_count + 1}/{max_retries} in {delay} seconds..."
+                        )
+                        await asyncio.sleep(delay)
+                    else:
+                        raise Exception(f"Exception occurred after {max_retries} tries.") from e
+
+        return wrapper
+
+    return decorator

cartesia/version.py

@@ -1 +1 @@
-__version__ = "1.0.1"
+__version__ = "1.0.3"

{cartesia-1.0.1.dist-info → cartesia-1.0.3.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: cartesia
-Version: 1.0.1
+Version: 1.0.3
 Summary: The official Python library for the Cartesia API.
 Home-page: 
 Author: Cartesia, Inc.

cartesia-1.0.3.dist-info/RECORD

@@ -0,0 +1,11 @@
+cartesia/__init__.py,sha256=jMIf2O7dTGxvTA5AfXtmh1H_EGfMtQseR5wXrjNRbLs,93
+cartesia/_types.py,sha256=msXRqNwVx_mbcLIQgRJYEl8U-hO9LRPWmscnX89cBCY,3747
+cartesia/client.py,sha256=jMlFDPRtKVDelqevHlv7YZJgOES3ws9BFN_6uUyN0W8,32720
+cartesia/version.py,sha256=2plzdEEb24FLjE2I2XyBBcJEPYWHccNL4SgtLC_6erg,22
+cartesia/utils/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+cartesia/utils/deprecated.py,sha256=QSM-ld_g1r-JlT571SSt6-w650jVm9mJmmI2MSScLPw,1599
+cartesia/utils/retry.py,sha256=nuwWRfu3MOVTxIQMLjYf6WLaxSlnu_GdE3QjTV0zisQ,3339
+cartesia-1.0.3.dist-info/METADATA,sha256=y5_HREGB417qL69qMFYtKrIRQAQJ1WDxqObaAg6-V6U,12394
+cartesia-1.0.3.dist-info/WHEEL,sha256=DZajD4pwLWue70CAfc7YaxT1wLUciNBvN_TTcvXpltE,110
+cartesia-1.0.3.dist-info/top_level.txt,sha256=rTX4HnnCegMxl1FK9czpVC7GAvf3SwDzPG65qP-BS4w,9
+cartesia-1.0.3.dist-info/RECORD,,

cartesia-1.0.1.dist-info/RECORD

@@ -1,8 +0,0 @@
-cartesia/__init__.py,sha256=jMIf2O7dTGxvTA5AfXtmh1H_EGfMtQseR5wXrjNRbLs,93
-cartesia/_types.py,sha256=msXRqNwVx_mbcLIQgRJYEl8U-hO9LRPWmscnX89cBCY,3747
-cartesia/client.py,sha256=jMlFDPRtKVDelqevHlv7YZJgOES3ws9BFN_6uUyN0W8,32720
-cartesia/version.py,sha256=d4QHYmS_30j0hPN8NmNPnQ_Z0TphDRbu4MtQj9cT9e8,22
-cartesia-1.0.1.dist-info/METADATA,sha256=rwqWm86ez9EzEovMQGPqClXh7U7cTsMGgDwl6DVO42o,12394
-cartesia-1.0.1.dist-info/WHEEL,sha256=DZajD4pwLWue70CAfc7YaxT1wLUciNBvN_TTcvXpltE,110
-cartesia-1.0.1.dist-info/top_level.txt,sha256=rTX4HnnCegMxl1FK9czpVC7GAvf3SwDzPG65qP-BS4w,9
-cartesia-1.0.1.dist-info/RECORD,,