yutipy 1.5.0__tar.gz → 1.5.2__tar.gz

{yutipy-1.5.0 → yutipy-1.5.2}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: yutipy
-Version: 1.5.0
+Version: 1.5.2
 Summary: A simple package for retrieving music information from various music platforms APIs.
 Author: Cheap Nightbot
 Author-email: Cheap Nightbot <hi@cheapnightbot.slmail.me>

{yutipy-1.5.0 → yutipy-1.5.2}/yutipy/__init__.py

@@ -3,8 +3,8 @@ from .itunes import Itunes
 from .kkbox import KKBox
 from .musicyt import MusicYT
 from .spotify import Spotify
+from .utils import disable_logging, enable_logging
 from .yutipy_music import YutipyMusic
-from . import exceptions
 
 __all__ = [
     "Deezer",
@@ -13,5 +13,6 @@ __all__ = [
     "MusicYT",
     "Spotify",
     "YutipyMusic",
-    "exceptions"
+    "enable_logging",
+    "disable_logging",
 ]

{yutipy-1.5.0 → yutipy-1.5.2}/yutipy/deezer.py

@@ -1,3 +1,5 @@
+__all__ = ["Deezer", "DeezerException"]
+
 from pprint import pprint
 from typing import Dict, List, Optional
 

{yutipy-1.5.0 → yutipy-1.5.2}/yutipy/exceptions.py

@@ -1,15 +1,20 @@
-class YutipyException(Exception):
-    """Base class for exceptions in the Yutipy package."""
-
-    pass
+__all__ = [
+    "AuthenticationException",
+    "InvalidResponseException",
+    "InvalidValueException",
+    "NetworkException",
+    "YutipyException",
+]
 
 
-class InvalidValueException(YutipyException):
-    """Exception raised for invalid values."""
+# Base Exception
+class YutipyException(Exception):
+    """Base class for exceptions in the Yutipy package."""
 
     pass
 
 
+# Service Exceptions
 class DeezerException(YutipyException):
     """Exception raised for errors related to the Deezer API."""
 
@@ -22,8 +27,8 @@ class ItunesException(YutipyException):
     pass
 
 
-class SpotifyException(YutipyException):
-    """Exception raised for errors related to the Spotify API."""
+class KKBoxException(YutipyException):
+    """Exception raised for erros related to the KKBOX Open API."""
 
     pass
 
@@ -34,14 +39,15 @@ class MusicYTException(YutipyException):
     pass
 
 
-class AuthenticationException(YutipyException):
-    """Exception raised for authentication errors."""
+class SpotifyException(YutipyException):
+    """Exception raised for errors related to the Spotify API."""
 
     pass
 
 
-class NetworkException(YutipyException):
-    """Exception raised for network-related errors."""
+# Generic Exceptions
+class AuthenticationException(YutipyException):
+    """Exception raised for authentication errors."""
 
     pass
 
@@ -52,5 +58,13 @@ class InvalidResponseException(YutipyException):
     pass
 
 
-class KKBoxException(YutipyException):
-    """Exception raised for erros related to the KKBOX Open API."""
+class InvalidValueException(YutipyException):
+    """Exception raised for invalid values."""
+
+    pass
+
+
+class NetworkException(YutipyException):
+    """Exception raised for network-related errors."""
+
+    pass

{yutipy-1.5.0 → yutipy-1.5.2}/yutipy/itunes.py

@@ -1,3 +1,5 @@
+__all__ = ["Itunes", "ItunesException"]
+
 from datetime import datetime
 from pprint import pprint
 from typing import Dict, Optional

{yutipy-1.5.0 → yutipy-1.5.2}/yutipy/kkbox.py

@@ -1,3 +1,5 @@
+__all__ = ["KKBox", "KKBoxException"]
+
 import base64
 import os
 import time

{yutipy-1.5.0 → yutipy-1.5.2}/yutipy/musicyt.py

@@ -1,4 +1,5 @@
-import os
+__all__ = ["MusicYT", "MusicYTException"]
+
 from pprint import pprint
 from typing import Optional
 
@@ -8,7 +9,7 @@ from ytmusicapi import YTMusic, exceptions
 from yutipy.exceptions import (
     InvalidResponseException,
     InvalidValueException,
-    NetworkException,
+    MusicYTException,
 )
 from yutipy.models import MusicInfo
 from yutipy.utils.helpers import are_strings_similar, is_valid_string
@@ -86,8 +87,8 @@ class MusicYT:
         try:
             results = self.ytmusic.search(query=query, limit=limit)
         except exceptions.YTMusicServerError as e:
-            logger.error(f"Network error while searching YouTube Music: {e}")
-            raise NetworkException(f"Network error occurred: {e}")
+            logger.error(f"Something went wrong while searching YTMusic: {e}")
+            raise MusicYTException(f"Something went wrong while searching YTMusic: {e}")
 
         for result in results:
             if self._is_relevant_result(artist, song, result):
@@ -294,6 +295,7 @@ class MusicYT:
 
 if __name__ == "__main__":
     import logging
+
     from yutipy.utils.logger import enable_logging
 
     enable_logging(level=logging.DEBUG)

{yutipy-1.5.0 → yutipy-1.5.2}/yutipy/spotify.py

@@ -1,3 +1,5 @@
+__all__ = ["Spotify", "SpotifyException"]
+
 import base64
 import os
 import time
@@ -31,7 +33,7 @@ SPOTIFY_CLIENT_SECRET = os.getenv("SPOTIFY_CLIENT_SECRET")
 
 class Spotify:
     """
-    A class to interact with the Spotify API.
+    A class to interact with the Spotify API. It uses "Client Credentials" grant type (or flow).
 
     This class reads the ``SPOTIFY_CLIENT_ID`` and ``SPOTIFY_CLIENT_SECRET`` from environment variables or the ``.env`` file by default.
     Alternatively, you can manually provide these values when creating an object.
@@ -43,14 +45,14 @@ class Spotify:
         client_secret: str = SPOTIFY_CLIENT_SECRET,
     ) -> None:
         """
-        Initializes the Spotify class and sets up the session.
+        Initializes the Spotify class (using Client Credentials grant type/flow) and sets up the session.
 
         Parameters
         ----------
         client_id : str, optional
-            The Client ID for the Spotify API. Defaults to ``SPOTIFY_CLIENT_ID`` from .env file.
+            The Client ID for the Spotify API. Defaults to ``SPOTIFY_CLIENT_ID`` from environment variable or the ``.env`` file.
         client_secret : str, optional
-            The Client secret for the Spotify API. Defaults to ``SPOTIFY_CLIENT_SECRET`` from .env file.
+            The Client secret for the Spotify API. Defaults to ``SPOTIFY_CLIENT_SECRET`` from environment variable or the ``.env`` file.
         """
         if not client_id or not client_secret:
             raise SpotifyException(
@@ -490,6 +492,7 @@ class Spotify:
 
 if __name__ == "__main__":
     import logging
+
     from yutipy.utils.logger import enable_logging
 
     enable_logging(level=logging.DEBUG)

{yutipy-1.5.0 → yutipy-1.5.2}/yutipy/utils/__init__.py

@@ -1,13 +1,16 @@
 from .helpers import (
-    guess_album_type,
     are_strings_similar,
+    guess_album_type,
     is_valid_string,
     separate_artists,
 )
+from .logger import disable_logging, enable_logging
 
 __all__ = [
     "guess_album_type",
     "are_strings_similar",
     "is_valid_string",
     "separate_artists",
+    "enable_logging",
+    "disable_logging"
 ]

{yutipy-1.5.0 → yutipy-1.5.2}/yutipy/yutipy_music.py

@@ -33,7 +33,7 @@ class YutipyMusic:
 
         try:
             self.services["kkbox"] = KKBox()
-        except (KKBoxException, Exception) as e:
+        except (KKBoxException) as e:
             logger.warning(
                 f"{self.__class__.__name__}: Skipping KKBox due to KKBoxException: {e}"
             )
@@ -43,7 +43,7 @@ class YutipyMusic:
 
         try:
             self.services["spotify"] = Spotify()
-        except (SpotifyException, Exception) as e:
+        except (SpotifyException) as e:
             logger.warning(
                 f"{self.__class__.__name__}: Skipping Spotify due to SpotifyException: {e}"
             )

{yutipy-1.5.0 → yutipy-1.5.2}/yutipy.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: yutipy
-Version: 1.5.0
+Version: 1.5.2
 Summary: A simple package for retrieving music information from various music platforms APIs.
 Author: Cheap Nightbot
 Author-email: Cheap Nightbot <hi@cheapnightbot.slmail.me>

{yutipy-1.5.0 → yutipy-1.5.2}/yutipy.egg-info/SOURCES.txt

@@ -39,7 +39,6 @@ yutipy/deezer.py
 yutipy/exceptions.py
 yutipy/itunes.py
 yutipy/kkbox.py
-yutipy/logging.py
 yutipy/models.py
 yutipy/musicyt.py
 yutipy/spotify.py

yutipy-1.5.0/yutipy/logging.py

@@ -1,3 +0,0 @@
-from .utils.logger import enable_logging, disable_logging
-
-__all__ = ["enable_logging", "disable_logging"]