tapra 0.1.1__py3-none-any.whl

tapra/.fernignore

@@ -0,0 +1 @@
+realtime.py

tapra/__init__.py

@@ -0,0 +1,214 @@
+# This file was auto-generated by Fern from our API Definition.
+
+# isort: skip_file
+
+import typing
+from importlib import import_module
+
+if typing.TYPE_CHECKING:
+    from .types import (
+        Conversion,
+        ConversionDirection,
+        Diarization,
+        Error,
+        ErrorObject,
+        ErrorObjectType,
+        Model,
+        ModelList,
+        ModelListObject,
+        ModelObject,
+        ModelOwnedBy,
+        RealtimeClientMessage,
+        RealtimeClientMessageType,
+        RealtimeEvent,
+        RealtimeEventType,
+        Segment,
+        Speaker,
+        SpeakerTurn,
+        Speech,
+        SpeechAudioFormat,
+        Transcription,
+        Translation,
+        TranslationLanguage,
+        TranslationLanguageList,
+        TranslationLanguageListObject,
+        TranslationRequest,
+        TranslationRequestDirection,
+        TranslationStreamEvent,
+        TranslationStreamEventType,
+        Usage,
+        Word,
+    )
+    from .errors import (
+        BadRequestError,
+        ContentTooLargeError,
+        ForbiddenError,
+        InternalServerError,
+        PaymentRequiredError,
+        ServiceUnavailableError,
+        TooManyRequestsError,
+        UnauthorizedError,
+    )
+    from . import diarization, models, script, speech, transcriptions, translations
+    from ._default_clients import DefaultAioHttpClient, DefaultAsyncHttpxClient
+    from .client import AsyncTapra, Tapra
+    from .environment import TapraEnvironment
+    from .realtime import RealtimeError, RealtimeSession, connect_realtime
+    from .script import ConversionRequestDirection
+    from .speech import (
+        CreateSpeechRequestEngine,
+        CreateSpeechRequestPronunciationMode,
+        CreateSpeechRequestPronunciationStyle,
+        CreateSpeechRequestResponseFormat,
+    )
+    from .transcriptions import CreateTranscriptionsRequestTimestamps
+    from .translations import CreateTranslationsRequestDirection, CreateTranslationsStreamRequestDirection
+_dynamic_imports: typing.Dict[str, str] = {
+    "AsyncTapra": ".client",
+    "BadRequestError": ".errors",
+    "ContentTooLargeError": ".errors",
+    "Conversion": ".types",
+    "ConversionDirection": ".types",
+    "ConversionRequestDirection": ".script",
+    "CreateSpeechRequestEngine": ".speech",
+    "CreateSpeechRequestPronunciationMode": ".speech",
+    "CreateSpeechRequestPronunciationStyle": ".speech",
+    "CreateSpeechRequestResponseFormat": ".speech",
+    "CreateTranscriptionsRequestTimestamps": ".transcriptions",
+    "CreateTranslationsRequestDirection": ".translations",
+    "CreateTranslationsStreamRequestDirection": ".translations",
+    "DefaultAioHttpClient": "._default_clients",
+    "DefaultAsyncHttpxClient": "._default_clients",
+    "Diarization": ".types",
+    "Error": ".types",
+    "ErrorObject": ".types",
+    "ErrorObjectType": ".types",
+    "ForbiddenError": ".errors",
+    "InternalServerError": ".errors",
+    "Model": ".types",
+    "ModelList": ".types",
+    "ModelListObject": ".types",
+    "ModelObject": ".types",
+    "ModelOwnedBy": ".types",
+    "PaymentRequiredError": ".errors",
+    "RealtimeClientMessage": ".types",
+    "RealtimeClientMessageType": ".types",
+    "RealtimeError": ".realtime",
+    "RealtimeEvent": ".types",
+    "RealtimeEventType": ".types",
+    "RealtimeSession": ".realtime",
+    "Segment": ".types",
+    "ServiceUnavailableError": ".errors",
+    "Speaker": ".types",
+    "SpeakerTurn": ".types",
+    "Speech": ".types",
+    "SpeechAudioFormat": ".types",
+    "Tapra": ".client",
+    "TapraEnvironment": ".environment",
+    "TooManyRequestsError": ".errors",
+    "Transcription": ".types",
+    "Translation": ".types",
+    "TranslationLanguage": ".types",
+    "TranslationLanguageList": ".types",
+    "TranslationLanguageListObject": ".types",
+    "TranslationRequest": ".types",
+    "TranslationRequestDirection": ".types",
+    "TranslationStreamEvent": ".types",
+    "TranslationStreamEventType": ".types",
+    "UnauthorizedError": ".errors",
+    "Usage": ".types",
+    "Word": ".types",
+    "connect_realtime": ".realtime",
+    "diarization": ".diarization",
+    "models": ".models",
+    "script": ".script",
+    "speech": ".speech",
+    "transcriptions": ".transcriptions",
+    "translations": ".translations",
+}
+
+
+def __getattr__(attr_name: str) -> typing.Any:
+    module_name = _dynamic_imports.get(attr_name)
+    if module_name is None:
+        raise AttributeError(f"No {attr_name} found in _dynamic_imports for module name -> {__name__}")
+    try:
+        module = import_module(module_name, __package__)
+        if module_name == f".{attr_name}":
+            return module
+        else:
+            return getattr(module, attr_name)
+    except ImportError as e:
+        raise ImportError(f"Failed to import {attr_name} from {module_name}: {e}") from e
+    except AttributeError as e:
+        raise AttributeError(f"Failed to get {attr_name} from {module_name}: {e}") from e
+
+
+def __dir__():
+    lazy_attrs = list(_dynamic_imports.keys())
+    return sorted(lazy_attrs)
+
+
+__all__ = [
+    "AsyncTapra",
+    "BadRequestError",
+    "ContentTooLargeError",
+    "Conversion",
+    "ConversionDirection",
+    "ConversionRequestDirection",
+    "CreateSpeechRequestEngine",
+    "CreateSpeechRequestPronunciationMode",
+    "CreateSpeechRequestPronunciationStyle",
+    "CreateSpeechRequestResponseFormat",
+    "CreateTranscriptionsRequestTimestamps",
+    "CreateTranslationsRequestDirection",
+    "CreateTranslationsStreamRequestDirection",
+    "DefaultAioHttpClient",
+    "DefaultAsyncHttpxClient",
+    "Diarization",
+    "Error",
+    "ErrorObject",
+    "ErrorObjectType",
+    "ForbiddenError",
+    "InternalServerError",
+    "Model",
+    "ModelList",
+    "ModelListObject",
+    "ModelObject",
+    "ModelOwnedBy",
+    "PaymentRequiredError",
+    "RealtimeClientMessage",
+    "RealtimeClientMessageType",
+    "RealtimeError",
+    "RealtimeEvent",
+    "RealtimeEventType",
+    "RealtimeSession",
+    "Segment",
+    "ServiceUnavailableError",
+    "Speaker",
+    "SpeakerTurn",
+    "Speech",
+    "SpeechAudioFormat",
+    "Tapra",
+    "TapraEnvironment",
+    "TooManyRequestsError",
+    "Transcription",
+    "Translation",
+    "TranslationLanguage",
+    "TranslationLanguageList",
+    "TranslationLanguageListObject",
+    "TranslationRequest",
+    "TranslationRequestDirection",
+    "TranslationStreamEvent",
+    "TranslationStreamEventType",
+    "UnauthorizedError",
+    "Usage",
+    "Word",
+    "connect_realtime",
+    "diarization",
+    "models",
+    "script",
+    "speech",
+    "transcriptions",
+    "translations",
+]

tapra/_default_clients.py

@@ -0,0 +1,30 @@
+# This file was auto-generated by Fern from our API Definition.
+
+import typing
+
+import httpx
+
+SDK_DEFAULT_TIMEOUT = 60
+
+try:
+    import httpx_aiohttp  # type: ignore[import-not-found]
+except ImportError:
+
+    class DefaultAioHttpClient(httpx.AsyncClient):  # type: ignore
+        def __init__(self, **kwargs: typing.Any) -> None:
+            raise RuntimeError("To use the aiohttp client, install the aiohttp extra: pip install tapra[aiohttp]")
+
+else:
+
+    class DefaultAioHttpClient(httpx_aiohttp.HttpxAiohttpClient):  # type: ignore
+        def __init__(self, **kwargs: typing.Any) -> None:
+            kwargs.setdefault("timeout", SDK_DEFAULT_TIMEOUT)
+            kwargs.setdefault("follow_redirects", True)
+            super().__init__(**kwargs)
+
+
+class DefaultAsyncHttpxClient(httpx.AsyncClient):
+    def __init__(self, **kwargs: typing.Any) -> None:
+        kwargs.setdefault("timeout", SDK_DEFAULT_TIMEOUT)
+        kwargs.setdefault("follow_redirects", True)
+        super().__init__(**kwargs)

tapra/client.py

@@ -0,0 +1,331 @@
+# This file was auto-generated by Fern from our API Definition.
+
+from __future__ import annotations
+
+import os
+import typing
+
+import httpx
+from .core.client_wrapper import AsyncClientWrapper, SyncClientWrapper
+from .core.logging import LogConfig, Logger
+from .environment import TapraEnvironment
+
+if typing.TYPE_CHECKING:
+    from .diarization.client import AsyncDiarizationClient, DiarizationClient
+    from .models.client import AsyncModelsClient, ModelsClient
+    from .script.client import AsyncScriptClient, ScriptClient
+    from .speech.client import AsyncSpeechClient, SpeechClient
+    from .transcriptions.client import AsyncTranscriptionsClient, TranscriptionsClient
+    from .translations.client import AsyncTranslationsClient, TranslationsClient
+
+
+class Tapra:
+    """
+    Use this class to access the different functions within the SDK. You can instantiate any number of clients with different configuration that will propagate to these functions.
+
+    Parameters
+    ----------
+    base_url : typing.Optional[str]
+        The base url to use for requests from the client.
+
+    environment : TapraEnvironment
+        The environment to use for requests from the client. from .environment import TapraEnvironment
+
+
+
+        Defaults to TapraEnvironment.DEFAULT
+
+
+
+    api_key : typing.Optional[typing.Union[str, typing.Callable[[], str]]]
+    headers : typing.Optional[typing.Dict[str, str]]
+        Additional headers to send with every request.
+
+    timeout : typing.Optional[float]
+        The timeout to be used, in seconds, for requests. By default the timeout is 60 seconds, unless a custom httpx client is used, in which case this default is not enforced.
+
+    max_retries : typing.Optional[int]
+        The default maximum number of retries for failed requests. Defaults to 2. Per-request `max_retries` in `request_options` takes precedence over this value.
+
+    stream_reconnection_enabled : typing.Optional[bool]
+        Whether to automatically reconnect on stream disconnection for resumable streaming endpoints. Defaults to True. Per-request `stream_reconnection_enabled` in `request_options` takes precedence over this value.
+
+    max_stream_reconnection_attempts : typing.Optional[int]
+        The maximum number of reconnection attempts for resumable streaming endpoints. Defaults to no limit. Per-request `max_stream_reconnection_attempts` in `request_options` takes precedence over this value.
+
+    follow_redirects : typing.Optional[bool]
+        Whether the default httpx client follows redirects or not, this is irrelevant if a custom httpx client is passed in.
+
+    httpx_client : typing.Optional[httpx.Client]
+        The httpx client to use for making requests, a preconfigured client is used by default, however this is useful should you want to pass in any custom httpx configuration.
+
+    logging : typing.Optional[typing.Union[LogConfig, Logger]]
+        Configure logging for the SDK. Accepts a LogConfig dict with 'level' (debug/info/warn/error), 'logger' (custom logger implementation), and 'silent' (boolean, defaults to True) fields. You can also pass a pre-configured Logger instance.
+
+    Examples
+    --------
+    from tapra import Tapra
+
+    client = Tapra(
+        api_key="YOUR_API_KEY",
+    )
+    """
+
+    def __init__(
+        self,
+        *,
+        base_url: typing.Optional[str] = None,
+        environment: TapraEnvironment = TapraEnvironment.DEFAULT,
+        api_key: typing.Optional[typing.Union[str, typing.Callable[[], str]]] = None,
+        headers: typing.Optional[typing.Dict[str, str]] = None,
+        timeout: typing.Optional[float] = None,
+        max_retries: typing.Optional[int] = None,
+        stream_reconnection_enabled: typing.Optional[bool] = None,
+        max_stream_reconnection_attempts: typing.Optional[int] = None,
+        follow_redirects: typing.Optional[bool] = True,
+        httpx_client: typing.Optional[httpx.Client] = None,
+        logging: typing.Optional[typing.Union[LogConfig, Logger]] = None,
+    ):
+        _defaulted_timeout = timeout if timeout is not None else 60 if httpx_client is None else None
+        _defaulted_max_retries = max_retries if max_retries is not None else 2
+        api_key = api_key if api_key is not None else os.getenv("TAPRA_API_KEY")
+        self._client_wrapper = SyncClientWrapper(
+            base_url=_get_base_url(base_url=base_url, environment=environment),
+            api_key=api_key,
+            headers=headers,
+            httpx_client=httpx_client
+            if httpx_client is not None
+            else httpx.Client(timeout=_defaulted_timeout, follow_redirects=follow_redirects)
+            if follow_redirects is not None
+            else httpx.Client(timeout=_defaulted_timeout),
+            timeout=_defaulted_timeout,
+            max_retries=_defaulted_max_retries,
+            stream_reconnection_enabled=stream_reconnection_enabled,
+            max_stream_reconnection_attempts=max_stream_reconnection_attempts,
+            logging=logging,
+        )
+        self._models: typing.Optional[ModelsClient] = None
+        self._transcriptions: typing.Optional[TranscriptionsClient] = None
+        self._diarization: typing.Optional[DiarizationClient] = None
+        self._speech: typing.Optional[SpeechClient] = None
+        self._translations: typing.Optional[TranslationsClient] = None
+        self._script: typing.Optional[ScriptClient] = None
+
+    @property
+    def models(self):
+        if self._models is None:
+            from .models.client import ModelsClient  # noqa: E402
+
+            self._models = ModelsClient(client_wrapper=self._client_wrapper)
+        return self._models
+
+    @property
+    def transcriptions(self):
+        if self._transcriptions is None:
+            from .transcriptions.client import TranscriptionsClient  # noqa: E402
+
+            self._transcriptions = TranscriptionsClient(client_wrapper=self._client_wrapper)
+        return self._transcriptions
+
+    @property
+    def diarization(self):
+        if self._diarization is None:
+            from .diarization.client import DiarizationClient  # noqa: E402
+
+            self._diarization = DiarizationClient(client_wrapper=self._client_wrapper)
+        return self._diarization
+
+    @property
+    def speech(self):
+        if self._speech is None:
+            from .speech.client import SpeechClient  # noqa: E402
+
+            self._speech = SpeechClient(client_wrapper=self._client_wrapper)
+        return self._speech
+
+    @property
+    def translations(self):
+        if self._translations is None:
+            from .translations.client import TranslationsClient  # noqa: E402
+
+            self._translations = TranslationsClient(client_wrapper=self._client_wrapper)
+        return self._translations
+
+    @property
+    def script(self):
+        if self._script is None:
+            from .script.client import ScriptClient  # noqa: E402
+
+            self._script = ScriptClient(client_wrapper=self._client_wrapper)
+        return self._script
+
+
+def _make_default_async_client(
+    timeout: typing.Optional[float],
+    follow_redirects: typing.Optional[bool],
+) -> httpx.AsyncClient:
+    try:
+        import httpx_aiohttp  # type: ignore[import-not-found]
+    except ImportError:
+        pass
+    else:
+        if follow_redirects is not None:
+            return httpx_aiohttp.HttpxAiohttpClient(timeout=timeout, follow_redirects=follow_redirects)
+        return httpx_aiohttp.HttpxAiohttpClient(timeout=timeout)
+
+    if follow_redirects is not None:
+        return httpx.AsyncClient(timeout=timeout, follow_redirects=follow_redirects)
+    return httpx.AsyncClient(timeout=timeout)
+
+
+class AsyncTapra:
+    """
+    Use this class to access the different functions within the SDK. You can instantiate any number of clients with different configuration that will propagate to these functions.
+
+    Parameters
+    ----------
+    base_url : typing.Optional[str]
+        The base url to use for requests from the client.
+
+    environment : TapraEnvironment
+        The environment to use for requests from the client. from .environment import TapraEnvironment
+
+
+
+        Defaults to TapraEnvironment.DEFAULT
+
+
+
+    api_key : typing.Optional[typing.Union[str, typing.Callable[[], str]]]
+    headers : typing.Optional[typing.Dict[str, str]]
+        Additional headers to send with every request.
+
+    async_token : typing.Optional[typing.Callable[[], typing.Awaitable[str]]]
+        An async callable that returns a bearer token. Use this when token acquisition involves async I/O (e.g., refreshing tokens via an async HTTP client). When provided, this is used instead of the synchronous token for async requests.
+
+    timeout : typing.Optional[float]
+        The timeout to be used, in seconds, for requests. By default the timeout is 60 seconds, unless a custom httpx client is used, in which case this default is not enforced.
+
+    max_retries : typing.Optional[int]
+        The default maximum number of retries for failed requests. Defaults to 2. Per-request `max_retries` in `request_options` takes precedence over this value.
+
+    stream_reconnection_enabled : typing.Optional[bool]
+        Whether to automatically reconnect on stream disconnection for resumable streaming endpoints. Defaults to True. Per-request `stream_reconnection_enabled` in `request_options` takes precedence over this value.
+
+    max_stream_reconnection_attempts : typing.Optional[int]
+        The maximum number of reconnection attempts for resumable streaming endpoints. Defaults to no limit. Per-request `max_stream_reconnection_attempts` in `request_options` takes precedence over this value.
+
+    follow_redirects : typing.Optional[bool]
+        Whether the default httpx client follows redirects or not, this is irrelevant if a custom httpx client is passed in.
+
+    httpx_client : typing.Optional[httpx.AsyncClient]
+        The httpx client to use for making requests, a preconfigured client is used by default, however this is useful should you want to pass in any custom httpx configuration.
+
+    logging : typing.Optional[typing.Union[LogConfig, Logger]]
+        Configure logging for the SDK. Accepts a LogConfig dict with 'level' (debug/info/warn/error), 'logger' (custom logger implementation), and 'silent' (boolean, defaults to True) fields. You can also pass a pre-configured Logger instance.
+
+    Examples
+    --------
+    from tapra import AsyncTapra
+
+    client = AsyncTapra(
+        api_key="YOUR_API_KEY",
+    )
+    """
+
+    def __init__(
+        self,
+        *,
+        base_url: typing.Optional[str] = None,
+        environment: TapraEnvironment = TapraEnvironment.DEFAULT,
+        api_key: typing.Optional[typing.Union[str, typing.Callable[[], str]]] = None,
+        headers: typing.Optional[typing.Dict[str, str]] = None,
+        async_token: typing.Optional[typing.Callable[[], typing.Awaitable[str]]] = None,
+        timeout: typing.Optional[float] = None,
+        max_retries: typing.Optional[int] = None,
+        stream_reconnection_enabled: typing.Optional[bool] = None,
+        max_stream_reconnection_attempts: typing.Optional[int] = None,
+        follow_redirects: typing.Optional[bool] = True,
+        httpx_client: typing.Optional[httpx.AsyncClient] = None,
+        logging: typing.Optional[typing.Union[LogConfig, Logger]] = None,
+    ):
+        _defaulted_timeout = timeout if timeout is not None else 60 if httpx_client is None else None
+        _defaulted_max_retries = max_retries if max_retries is not None else 2
+        api_key = api_key if api_key is not None else os.getenv("TAPRA_API_KEY")
+        self._client_wrapper = AsyncClientWrapper(
+            base_url=_get_base_url(base_url=base_url, environment=environment),
+            api_key=api_key,
+            headers=headers,
+            async_token=async_token,
+            httpx_client=httpx_client
+            if httpx_client is not None
+            else _make_default_async_client(timeout=_defaulted_timeout, follow_redirects=follow_redirects),
+            timeout=_defaulted_timeout,
+            max_retries=_defaulted_max_retries,
+            stream_reconnection_enabled=stream_reconnection_enabled,
+            max_stream_reconnection_attempts=max_stream_reconnection_attempts,
+            logging=logging,
+        )
+        self._models: typing.Optional[AsyncModelsClient] = None
+        self._transcriptions: typing.Optional[AsyncTranscriptionsClient] = None
+        self._diarization: typing.Optional[AsyncDiarizationClient] = None
+        self._speech: typing.Optional[AsyncSpeechClient] = None
+        self._translations: typing.Optional[AsyncTranslationsClient] = None
+        self._script: typing.Optional[AsyncScriptClient] = None
+
+    @property
+    def models(self):
+        if self._models is None:
+            from .models.client import AsyncModelsClient  # noqa: E402
+
+            self._models = AsyncModelsClient(client_wrapper=self._client_wrapper)
+        return self._models
+
+    @property
+    def transcriptions(self):
+        if self._transcriptions is None:
+            from .transcriptions.client import AsyncTranscriptionsClient  # noqa: E402
+
+            self._transcriptions = AsyncTranscriptionsClient(client_wrapper=self._client_wrapper)
+        return self._transcriptions
+
+    @property
+    def diarization(self):
+        if self._diarization is None:
+            from .diarization.client import AsyncDiarizationClient  # noqa: E402
+
+            self._diarization = AsyncDiarizationClient(client_wrapper=self._client_wrapper)
+        return self._diarization
+
+    @property
+    def speech(self):
+        if self._speech is None:
+            from .speech.client import AsyncSpeechClient  # noqa: E402
+
+            self._speech = AsyncSpeechClient(client_wrapper=self._client_wrapper)
+        return self._speech
+
+    @property
+    def translations(self):
+        if self._translations is None:
+            from .translations.client import AsyncTranslationsClient  # noqa: E402
+
+            self._translations = AsyncTranslationsClient(client_wrapper=self._client_wrapper)
+        return self._translations
+
+    @property
+    def script(self):
+        if self._script is None:
+            from .script.client import AsyncScriptClient  # noqa: E402
+
+            self._script = AsyncScriptClient(client_wrapper=self._client_wrapper)
+        return self._script
+
+
+def _get_base_url(*, base_url: typing.Optional[str] = None, environment: TapraEnvironment) -> str:
+    if base_url is not None:
+        return base_url
+    elif environment is not None:
+        return environment.value
+    else:
+        raise Exception("Please pass in either base_url or environment to construct the client")