Update All Files Using Black Formatter

deepgram/__init__.py

@@ -3,7 +3,7 @@
 # SPDX-License-Identifier: MIT
 
 # version
-__version__ = '3.0.0'
+__version__ = "3.0.0"
 
 # entry point for the deepgram python sdk
 from .client import DeepgramClient, DeepgramApiKeyError
@@ -14,10 +14,25 @@
 from .clients.live.client import LiveClient, LegacyLiveClient, LiveOptions
 
 # prerecorded
-from .clients.prerecorded.client import PreRecordedClient, PrerecordedOptions, PrerecordedSource, FileSource, UrlSource
+from .clients.prerecorded.client import (
+    PreRecordedClient,
+    PrerecordedOptions,
+    PrerecordedSource,
+    FileSource,
+    UrlSource,
+)
 
 # manage
-from .clients.manage.client import ManageClient, ProjectOptions, KeyOptions, ScopeOptions, InviteOptions, UsageRequestOptions, UsageSummaryOptions, UsageFieldsOptions
+from .clients.manage.client import (
+    ManageClient,
+    ProjectOptions,
+    KeyOptions,
+    ScopeOptions,
+    InviteOptions,
+    UsageRequestOptions,
+    UsageSummaryOptions,
+    UsageFieldsOptions,
+)
 
 # utilities
 from .audio.microphone.microphone import Microphone

deepgram/audio/microphone/errors.py

@@ -2,6 +2,7 @@
 # Use of this source code is governed by a MIT license that can be found in the LICENSE file.
 # SPDX-License-Identifier: MIT
 
+
 class DeepgramMicrophoneError(Exception):
     """
     Exception raised for known errors related to Microphone library.
@@ -11,10 +12,11 @@ class DeepgramMicrophoneError(Exception):
         status (str): The HTTP status associated with the API error.
         original_error (str - json): The original error that was raised.
     """
+
     def __init__(self, message: str):
         super().__init__(message)
         self.name = "DeepgramMicrophoneError"
         self.message = message
-        
+
     def __str__(self):
-        return f"{self.name}: {self.message}"
+        return f"{self.name}: {self.message}"

deepgram/audio/microphone/microphone.py

@@ -16,11 +16,15 @@
 RATE = 16000
 CHUNK = 8000
 
+
 class Microphone:
     """
-        TODO
+    TODO
     """
-    def __init__(self, push_callback, format=FORMAT, rate=RATE, chunk=CHUNK, channels=CHANNELS):
+
+    def __init__(
+        self, push_callback, format=FORMAT, rate=RATE, chunk=CHUNK, channels=CHANNELS
+    ):
         self.audio = pyaudio.PyAudio()
         self.chunk = chunk
         self.rate = rate
@@ -37,7 +41,7 @@ def is_active(self):
     def start(self):
         if self.stream is not None:
             raise DeepgramMicrophoneError("Microphone already started")
-        
+
         self.stream = self.audio.open(
             format=self.format,
             channels=self.channels,
@@ -86,4 +90,3 @@ def finish(self):
         self.stream.stop_stream()
         self.stream.close()
         self.stream = None
-

deepgram/client.py

@@ -12,6 +12,7 @@
 from .options import DeepgramClientOptions
 from .errors import DeepgramApiKeyError, DeepgramModuleError
 
+
 class DeepgramClient:
     """
     Represents a client for interacting with the Deepgram API.
@@ -31,32 +32,33 @@ class DeepgramClient:
         onprem: Returns an OnPremClient instance for interacting with Deepgram's on-premises API.
 
     """
+
     def __init__(self, api_key: str, config: Optional[DeepgramClientOptions] = None):
         if not api_key:
             raise DeepgramApiKeyError("Deepgram API key is required")
 
         self.api_key = api_key
-        if config is None: # Use default configuration
+        if config is None:  # Use default configuration
             self.config = DeepgramClientOptions(self.api_key)
         else:
             config.set_apikey(self.api_key)
             self.config = config
-    
+
     @property
     def listen(self):
         return ListenClient(self.config)
-    
+
     @property
     def manage(self):
         return self.Version(self.config, "manage")
-    
+
     @property
     def onprem(self):
         return self.Version(self.config, "onprem")
 
     # INTERNAL CLASSES
     class Version:
-        def __init__(self, config, parent : str):
+        def __init__(self, config, parent: str):
             self.config = config
             self.parent = parent
 

deepgram/clients/abstract_client.py

@@ -8,6 +8,7 @@
 from ..options import DeepgramClientOptions
 from .errors import DeepgramError, DeepgramApiError, DeepgramUnknownApiError
 
+
 class AbstractRestfulClient:
     """
     An abstract base class for a RESTful HTTP client.
@@ -28,6 +29,7 @@ class AbstractRestfulClient:
         DeepgramApiError: Raised for known API errors.
         DeepgramUnknownApiError: Raised for unknown API errors.
     """
+
     def __init__(self, config: DeepgramClientOptions):
         if config is None:
             raise DeepgramError("Config are required")
@@ -36,19 +38,27 @@ def __init__(self, config: DeepgramClientOptions):
         self.client = httpx.AsyncClient()
 
     async def get(self, url: str, options=None):
-        return await self._handle_request('GET', url, params=options, headers=self.config.headers)
+        return await self._handle_request(
+            "GET", url, params=options, headers=self.config.headers
+        )
 
     async def post(self, url: str, options=None, **kwargs):
-        return await self._handle_request('POST', url, params=options, headers=self.config.headers, **kwargs)
+        return await self._handle_request(
+            "POST", url, params=options, headers=self.config.headers, **kwargs
+        )
 
     async def put(self, url: str, options=None, **kwargs):
-        return await self._handle_request('PUT', url, params=options, headers=self.config.headers, **kwargs)
+        return await self._handle_request(
+            "PUT", url, params=options, headers=self.config.headers, **kwargs
+        )
 
     async def patch(self, url: str, options=None, **kwargs):
-        return await self._handle_request('PATCH', url, params=options, headers=self.config.headers, **kwargs)
+        return await self._handle_request(
+            "PATCH", url, params=options, headers=self.config.headers, **kwargs
+        )
 
     async def delete(self, url: str):
-        return await self._handle_request('DELETE', url, headers=self.config.headers)
+        return await self._handle_request("DELETE", url, headers=self.config.headers)
 
     async def _handle_request(self, method, url, **kwargs):
         try:
@@ -61,7 +71,9 @@ async def _handle_request(self, method, url, **kwargs):
                 status_code = e.response.status_code or 500
                 try:
                     json_object = json.loads(e.response.text)
-                    raise DeepgramApiError(json_object.get('message'), status_code, json.dumps(json_object)) from e
+                    raise DeepgramApiError(
+                        json_object.get("message"), status_code, json.dumps(json_object)
+                    ) from e
                 except json.decoder.JSONDecodeError:
                     raise DeepgramUnknownApiError(e.response.text, status_code) from e
                 except ValueError as e:

deepgram/clients/errors.py

@@ -2,6 +2,7 @@
 # Use of this source code is governed by a MIT license that can be found in the LICENSE file.
 # SPDX-License-Identifier: MIT
 
+
 class DeepgramError(Exception):
     """
     Exception raised for unknown errors related to the Deepgram API.
@@ -10,6 +11,7 @@ class DeepgramError(Exception):
         message (str): The error message describing the exception.
         status (str): The HTTP status associated with the API error.
     """
+
     def __init__(self, message: str):
         super().__init__(message)
         self.name = "DeepgramError"
@@ -18,17 +20,20 @@ def __init__(self, message: str):
     def __str__(self):
         return f"{self.name}: {self.message}"
 
+
 class DeepgramModuleError(Exception):
     """
     Base class for exceptions raised for a missing Deepgram module.
 
     Attributes:
         message (str): The error message describing the exception.
     """
+
     def __init__(self, message: str):
         super().__init__(message)
         self.name = "DeepgramModuleError"
 
+
 class DeepgramApiError(Exception):
     """
     Exception raised for known errors (in json response format) related to the Deepgram API.
@@ -38,16 +43,18 @@ class DeepgramApiError(Exception):
         status (str): The HTTP status associated with the API error.
         original_error (str - json): The original error that was raised.
     """
-    def __init__(self, message: str, status: str, original_error = None):
+
+    def __init__(self, message: str, status: str, original_error=None):
         super().__init__(message)
         self.name = "DeepgramApiError"
         self.status = status
         self.message = message
         self.original_error = original_error
-        
+
     def __str__(self):
         return f"{self.name}: {self.message} (Status: {self.status})"
 
+
 class DeepgramUnknownApiError(Exception):
     """
     Exception raised for unknown errors related to the Deepgram API.
@@ -56,6 +63,7 @@ class DeepgramUnknownApiError(Exception):
         message (str): The error message describing the exception.
         status (str): The HTTP status associated with the API error.
     """
+
     def __init__(self, message: str, status: str):
         super().__init__(message, status)
         self.name = "DeepgramUnknownApiError"

deepgram/clients/listen.py

@@ -10,25 +10,26 @@
 from .live.client import LiveClient, LegacyLiveClient
 from .errors import DeepgramModuleError
 
+
 class ListenClient:
     def __init__(self, config: DeepgramClientOptions):
         self.config = config
-        
+
     @property
     def prerecorded(self):
         return self.Version(self.config, "prerecorded")
-    
+
     @property
     def live(self):
         return self.Version(self.config, "live")
-    
+
     @property
     def legacylive(self):
         return LegacyLiveClient(self.config)
 
     # INTERNAL CLASSES
     class Version:
-        def __init__(self, config, parent : str):
+        def __init__(self, config, parent: str):
             self.config = config
             self.parent = parent
 

deepgram/clients/live/client.py

@@ -6,24 +6,29 @@
 from .v1.legacy_client import LegacyLiveClient as LegacyLiveClientLatest
 from .v1.options import LiveOptions as LiveOptionsLatest
 
-'''
+"""
 The client.py points to the current supported version in the SDK.
 Older versions are supported in the SDK for backwards compatibility.
-'''
+"""
+
+
 class LiveOptions(LiveOptionsLatest):
-  pass
+    pass
+
 
 class LiveClient(LiveClientLatest):
-  """
+    """
     Please see LiveClientLatest for details
     """
-  def __init__(self, config):
-      super().__init__(config)
+
+    def __init__(self, config):
+        super().__init__(config)
+
 
 class LegacyLiveClient(LegacyLiveClientLatest):
-  """
+    """
     Please see LiveClientLatest for details
     """
-  def __init__(self, config):
-      super().__init__(config)
-
+
+    def __init__(self, config):
+        super().__init__(config)

deepgram/clients/live/enums.py

@@ -4,6 +4,7 @@
 
 from enum import Enum
 
+
 class LiveTranscriptionEvents(Enum):
     Open = "open"
     Close = "close"

deepgram/clients/live/errors.py

@@ -2,6 +2,7 @@
 # Use of this source code is governed by a MIT license that can be found in the LICENSE file.
 # SPDX-License-Identifier: MIT
 
+
 class DeepgramError(Exception):
     """
     Exception raised for unknown errors related to the Deepgram API.
@@ -10,6 +11,7 @@ class DeepgramError(Exception):
         message (str): The error message describing the exception.
         status (str): The HTTP status associated with the API error.
     """
+
     def __init__(self, message: str):
         super().__init__(message)
         self.name = "DeepgramError"
@@ -18,6 +20,7 @@ def __init__(self, message: str):
     def __str__(self):
         return f"{self.name}: {self.message}"
 
+
 class DeepgramWebsocketError(Exception):
     """
     Exception raised for known errors related to Websocket library.
@@ -27,10 +30,11 @@ class DeepgramWebsocketError(Exception):
         status (str): The HTTP status associated with the API error.
         original_error (str - json): The original error that was raised.
     """
+
     def __init__(self, message: str):
         super().__init__(message)
         self.name = "DeepgramWebsocketError"
         self.message = message
-        
+
     def __str__(self):
         return f"{self.name}: {self.message}"