fcaai 0.4.0__py3-none-any.whl

fcaai/__init__.py

@@ -0,0 +1,10 @@
+"""Official Python client for the fcaai API (https://api.fcaai.ai). Standard library only."""
+from ._errors import FcaaiError, FcaaiTimeoutError
+from .client import (CHUNK_SIZE, DEFAULT_BASE_URL, SIMPLE_UPLOAD_MAX, Fcaai, Generation, Output, Template, TemplateInput, Transport, Voice,
+                     VoiceSample,
+                     __version__, urllib_transport)
+from .webhooks import construct_event, parse_signature_header, sign_webhook_payload, verify_webhook_signature
+
+__all__ = ["Fcaai", "Generation", "Output", "Voice", "Template", "TemplateInput", "FcaaiError", "FcaaiTimeoutError", "verify_webhook_signature", "sign_webhook_payload",
+           "parse_signature_header", "construct_event", "Transport", "VoiceSample", "urllib_transport", "DEFAULT_BASE_URL",
+           "SIMPLE_UPLOAD_MAX", "CHUNK_SIZE", "__version__"]

fcaai/_errors.py

@@ -0,0 +1,31 @@
+from typing import Any, Optional
+
+
+class FcaaiError(Exception):
+    """Raised for every non-2xx response (and network failures, status 0)."""
+
+    def __init__(self, message: str, *, status: int = 0, type: str = "api_error", code: str = "error",
+                 request_id: Optional[str] = None, doc_url: Optional[str] = None,
+                 retry_after: Optional[float] = None, body: Any = None) -> None:
+        super().__init__(message)
+        self.message = message
+        self.status = status
+        self.type = type
+        self.code = code
+        self.request_id = request_id
+        self.doc_url = doc_url
+        self.retry_after = retry_after
+        self.body = body
+
+    @property
+    def retryable(self) -> bool:
+        return self.status in (0, 408, 429) or self.status >= 500
+
+    def __repr__(self) -> str:
+        return f"FcaaiError(status={self.status}, code={self.code!r}, message={self.message!r}, request_id={self.request_id!r})"
+
+
+class FcaaiTimeoutError(FcaaiError):
+    def __init__(self, message: str, generation_id: Optional[str] = None) -> None:
+        super().__init__(message, status=0, type="timeout", code="wait_timeout")
+        self.generation_id = generation_id