yutipy 0.1.1__py3-none-any.whl → 1.1.0__py3-none-any.whl

yutipy/exceptions.py

@@ -50,3 +50,7 @@ class InvalidResponseException(YutipyException):
     """Exception raised for invalid responses from APIs."""
 
     pass
+
+
+class KKBoxException(YutipyException):
+    """Exception raised for erros related to the KKBOX Open API."""

yutipy/kkbox.py

@@ -0,0 +1,320 @@
+import base64
+import os
+import time
+from pprint import pprint
+from typing import Optional, Union
+
+import requests
+from dotenv import load_dotenv
+
+from yutipy.exceptions import (
+    AuthenticationException,
+    InvalidResponseException,
+    InvalidValueException,
+    KKBoxException,
+    NetworkException,
+)
+from yutipy.models import MusicInfo
+from yutipy.utils.cheap_utils import are_strings_similar, is_valid_string
+
+load_dotenv()
+
+KKBOX_CLIENT_ID = os.getenv("KKBOX_CLIENT_ID")
+KKBOX_CLIENT_SECRET = os.getenv("KKBOX_CLIENT_SECRET")
+
+
+class KKBox:
+    """
+    A class to interact with KKBOX Open API.
+
+    This class reads the ``KKBOX_CLIENT_ID`` and ``KKBOX_CLIENT_SECRET`` from environment variables or the ``.env`` file by default.
+    Alternatively, you can manually provide these values when creating an object.
+    """
+
+    def __init__(
+        self, client_id: str = KKBOX_CLIENT_ID, client_secret: str = KKBOX_CLIENT_SECRET
+    ) -> None:
+        """
+        Initializes the KKBox class and sets up the session.
+
+        Parameters
+        ----------
+        client_id : str, optional
+            The Client ID for the KKBOX Open API. Defaults to ``KKBOX_CLIENT_ID`` from .env file.
+        client_secret : str, optional
+            The Client secret for the KKBOX Open API. Defaults to ``KKBOX_CLIENT_SECRET`` from .env file.
+        """
+        if not client_id or not client_secret:
+            raise KKBoxException(
+                "Failed to read `KKBOX_CLIENT_ID` and/or `KKBOX_CLIENT_SECRET` from environment variables. Client ID and Client Secret must be provided."
+            )
+
+        self.client_id = client_id
+        self.client_secret = client_secret
+        self._session = requests.Session()
+        self.api_url = "https://api.kkbox.com/v1.1"
+        self.__header, self.__expires_in = self.__authenticate()
+        self.__start_time = time.time()
+        self._is_session_closed = False
+
+    def __enter__(self):
+        """Enters the runtime context related to this object."""
+        return self
+
+    def __exit__(self, exc_type, exc_value, exc_traceback):
+        """Exits the runtime context related to this object."""
+        self._close_session()
+
+    def close_session(self) -> None:
+        """Closes the current session."""
+        if not self.is_session_closed:
+            self._session.close()
+            self._is_session_closed = True
+
+    @property
+    def is_session_closed(self) -> bool:
+        """Checks if the session is closed."""
+        return self._is_session_closed
+
+    def __authenticate(self) -> tuple:
+        """
+        Authenticates with the KKBOX Open API and returns the authorization header.
+
+        Returns
+        -------
+        dict
+            The authorization header.
+        """
+        try:
+            token, expires_in = self.__get_access_token()
+            return {"Authorization": f"Bearer {token}"}, expires_in
+        except Exception as e:
+            raise AuthenticationException(
+                "Failed to authenticate with KKBOX Open API"
+            ) from e
+
+    def __get_access_token(self) -> tuple:
+        """
+        Gets the KKBOX Open API token.
+
+        Returns
+        -------
+        str
+            The KKBOX Open API token.
+        """
+        auth_string = f"{self.client_id}:{self.client_secret}"
+        auth_base64 = base64.b64encode(auth_string.encode("utf-8")).decode("utf-8")
+
+        url = " https://account.kkbox.com/oauth2/token"
+        headers = {
+            "Authorization": f"Basic {auth_base64}",
+            "Content-Type": "application/x-www-form-urlencoded",
+        }
+        data = {"grant_type": "client_credentials"}
+
+        try:
+            response = self._session.post(
+                url=url, headers=headers, data=data, timeout=30
+            )
+            response.raise_for_status()
+        except requests.RequestException as e:
+            raise NetworkException(f"Network error occurred: {e}")
+
+        try:
+            response_json = response.json()
+            return response_json.get("access_token"), response_json.get("expires_in")
+        except (KeyError, ValueError) as e:
+            raise InvalidResponseException(f"Invalid response received: {e}")
+
+    def __refresh_token_if_expired(self):
+        """Refreshes the token if it has expired."""
+        if time.time() - self.__start_time >= self.__expires_in:
+            self.__header, self.__expires_in = self.__authenticate()
+            self.__start_time = time.time()
+
+    def search(
+        self, artist: str, song: str, territory: str = "TW"
+    ) -> Optional[MusicInfo]:
+        """
+        Searches for a song by artist and title.
+
+        Parameters
+        ----------
+        artist : str
+            The name of the artist.
+        song : str
+            The title of the song.
+        territory : str
+            Two-letter country codes from ISO 3166-1 alpha-2.
+            Allowed values: ``HK``, ``JP``, ``MY``, ``SG``, ``TW``.
+
+        Returns
+        -------
+        Optional[MusicInfo_]
+            The music information if found, otherwise None.
+        """
+        if not is_valid_string(artist) or not is_valid_string(song):
+            raise InvalidValueException(
+                "Artist and song names must be valid strings and can't be empty."
+            )
+
+        self.__refresh_token_if_expired()
+
+        query = f"?q={artist} - {song}&type=track,album&territory={territory}&limit=10"
+        query_url = f"{self.api_url}/search{query}"
+
+        try:
+            response = self._session.get(query_url, headers=self.__header, timeout=30)
+            response.raise_for_status()
+        except requests.RequestException as e:
+            raise NetworkException(f"Network error occurred: {e}")
+
+        if response.status_code != 200:
+            raise KKBoxException(f"Failed to search for music: {response.json()}")
+
+        return self._find_music_info(artist, song, response.json())
+
+    def _find_music_info(
+        self, artist: str, song: str, response_json: dict
+    ) -> Optional[MusicInfo]:
+        """
+        Finds the music information from the search results.
+
+        Parameters
+        ----------
+        artist : str
+            The name of the artist.
+        song : str
+            The title of the song.
+        response_json : dict
+            The JSON response from the API.
+
+        Returns
+        -------
+        Optional[MusicInfo]
+            The music information if found, otherwise None.
+        """
+        try:
+            for track in response_json["tracks"]["data"]:
+                music_info = self._find_track(song, artist, track)
+                if music_info:
+                    return music_info
+        except KeyError:
+            pass
+
+        try:
+            for album in response_json["albums"]["data"]:
+                music_info = self._find_album(song, artist, album)
+                if music_info:
+                    return music_info
+        except KeyError:
+            pass
+
+        return None
+
+    def _find_track(self, song: str, artist: str, track: dict) -> Optional[MusicInfo]:
+        """
+        Finds the track information from the search results.
+
+        Parameters
+        ----------
+        song : str
+            The title of the song.
+        artist : str
+            The name of the artist.
+        track : dict
+            A single track from the search results.
+        artist_ids : list
+            A list of artist IDs.
+
+        Returns
+        -------
+        Optional[MusicInfo]
+            The music information if found, otherwise None.
+        """
+        if not are_strings_similar(track["name"], song):
+            return None
+
+        artists_name = track["album"]["artist"]["name"]
+        matching_artists = (
+            artists_name if are_strings_similar(artists_name, artist) else None
+        )
+
+        if matching_artists:
+            return MusicInfo(
+                album_art=track["album"]["images"][2]["url"],
+                album_title=track["album"]["name"],
+                album_type=None,
+                artists=artists_name,
+                genre=None,
+                id=track["id"],
+                isrc=track["isrc"],
+                lyrics=None,
+                release_date=track["album"]["release_date"],
+                tempo=None,
+                title=track["name"],
+                type="track",
+                upc=None,
+                url=track["url"],
+            )
+
+        return None
+
+    def _find_album(self, song: str, artist: str, album: dict) -> Optional[MusicInfo]:
+        """
+        Finds the album information from the search results.
+
+        Parameters
+        ----------
+        song : str
+            The title of the song.
+        artist : str
+            The name of the artist.
+        album : dict
+            A single album from the search results.
+        artist_ids : list
+            A list of artist IDs.
+
+        Returns
+        -------
+        Optional[MusicInfo]
+            The music information if found, otherwise None.
+        """
+        if not are_strings_similar(album["name"], song):
+            return None
+
+        artists_name = album["artist"]["name"]
+        matching_artists = (
+            artists_name if are_strings_similar(artists_name, artist) else None
+        )
+
+        if matching_artists:
+            return MusicInfo(
+                album_art=album["images"][2]["url"],
+                album_title=album["name"],
+                album_type=None,
+                artists=artists_name,
+                genre=None,
+                id=album["id"],
+                isrc=None,
+                lyrics=None,
+                release_date=album["release_date"],
+                tempo=None,
+                title=album["name"],
+                type="album",
+                upc=None,
+                url=album["url"],
+            )
+
+        return None
+
+
+if __name__ == "__main__":
+    kkbox = KKBox(KKBOX_CLIENT_ID, KKBOX_CLIENT_SECRET)
+
+    try:
+        artist_name = input("Artist Name: ")
+        song_name = input("Song Name: ")
+        pprint(kkbox.search(artist_name, song_name))
+    finally:
+        kkbox.close_session()

yutipy/models.py

@@ -1,55 +1,55 @@
-from dataclasses import dataclass
-from typing import Optional
-
-
-@dataclass
-class MusicInfo:
-    """
-    A data class to store music information.
-
-    Attributes
-    ----------
-    album_art : Optional[str]
-        URL to the album art.
-    album_title : Optional[str]
-        Title of the album.
-    album_type : Optional[str]
-        Type of the album (e.g., album, single).
-    artists : str
-        Name(s) of the artist(s).
-    genre : Optional[str]
-        Genre of the music.
-    id : str
-        Unique identifier for the music.
-    isrc : Optional[str]
-        International Standard Recording Code.
-    lyrics : Optional[str]
-        Lyrics of the song.
-    release_date : Optional[str]
-        Release date of the music.
-    tempo : Optional[float]
-        Tempo of the music in BPM.
-    title : str
-        Title of the music.
-    type : Optional[str]
-        Type of the music (e.g., track, album).
-    upc : Optional[str]
-        Universal Product Code.
-    url : str
-        URL to the music on the platform.
-    """
-
-    album_art: Optional[str]
-    album_title: Optional[str]
-    album_type: Optional[str]
-    artists: str
-    genre: Optional[str]
-    id: str
-    isrc: Optional[str]
-    lyrics: Optional[str]
-    release_date: Optional[str]
-    tempo: Optional[float]
-    title: str
-    type: Optional[str]
-    upc: Optional[str]
-    url: str
+from dataclasses import dataclass
+from typing import Optional
+
+
+@dataclass
+class MusicInfo:
+    """
+    A data class to store music information.
+
+    Attributes
+    ----------
+    album_art : Optional[str]
+        URL to the album art.
+    album_title : Optional[str]
+        Title of the album.
+    album_type : Optional[str]
+        Type of the album (e.g., album, single).
+    artists : str
+        Name(s) of the artist(s).
+    genre : Optional[str]
+        Genre of the music.
+    id : str
+        Unique identifier for the music.
+    isrc : Optional[str]
+        International Standard Recording Code.
+    lyrics : Optional[str]
+        Lyrics of the song.
+    release_date : Optional[str]
+        Release date of the music.
+    tempo : Optional[float]
+        Tempo of the music in BPM.
+    title : str
+        Title of the music.
+    type : Optional[str]
+        Type of the music (e.g., track, album).
+    upc : Optional[str]
+        Universal Product Code.
+    url : str
+        URL to the music on the platform.
+    """
+
+    album_art: Optional[str]
+    album_title: Optional[str]
+    album_type: Optional[str]
+    artists: str
+    genre: Optional[str]
+    id: str
+    isrc: Optional[str]
+    lyrics: Optional[str]
+    release_date: Optional[str]
+    tempo: Optional[float]
+    title: str
+    type: Optional[str]
+    upc: Optional[str]
+    url: str

yutipy/spotify.py

@@ -23,20 +23,22 @@ from yutipy.utils.cheap_utils import (
 
 load_dotenv()
 
-CLIENT_ID = os.getenv("CLIENT_ID")
-CLIENT_SECRET = os.getenv("CLIENT_SECRET")
+SPOTIFY_CLIENT_ID = os.getenv("SPOTIFY_CLIENT_ID")
+SPOTIFY_CLIENT_SECRET = os.getenv("SPOTIFY_CLIENT_SECRET")
 
 
 class Spotify:
     """
     A class to interact with the Spotify API.
 
-    This class reads the ``CLIENT_ID`` and ``CLIENT_SECRET`` from environment variables or the ``.env`` file by default.
-    Alternatively, users can manually provide these values when creating an object.
+    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.
     """
 
     def __init__(
-        self, client_id: str = CLIENT_ID, client_secret: str = CLIENT_SECRET
+        self,
+        client_id: str = SPOTIFY_CLIENT_ID,
+        client_secret: str = SPOTIFY_CLIENT_SECRET,
     ) -> None:
         """
         Initializes the Spotify class and sets up the session.
@@ -44,20 +46,20 @@ class Spotify:
         Parameters
         ----------
         client_id : str, optional
-            The client ID for the Spotify API. Defaults to CLIENT_ID from .env file.
+            The Client ID for the Spotify API. Defaults to ``SPOTIFY_CLIENT_ID`` from .env file.
         client_secret : str, optional
-            The client secret for the Spotify API. Defaults to CLIENT_SECRET from .env file.
+            The Client secret for the Spotify API. Defaults to ``SPOTIFY_CLIENT_SECRET`` from .env file.
         """
         if not client_id or not client_secret:
             raise SpotifyException(
-                "Failed to read CLIENT_ID and CLIENT_SECRET from environment variables. Client ID and Client Secret must be provided."
+                "Failed to read `SPOTIFY_CLIENT_ID` and/or `SPOTIFY_CLIENT_SECRET` from environment variables. Client ID and Client Secret must be provided."
             )
 
         self.client_id = client_id
         self.client_secret = client_secret
         self._session = requests.Session()
         self.api_url = "https://api.spotify.com/v1"
-        self.__header = self.__authenticate()
+        self.__header, self.__expires_in = self.__authenticate()
         self.__start_time = time.time()
         self._is_session_closed = False
 
@@ -80,7 +82,7 @@ class Spotify:
         """Checks if the session is closed."""
         return self._is_session_closed
 
-    def __authenticate(self) -> dict:
+    def __authenticate(self) -> tuple:
         """
         Authenticates with the Spotify API and returns the authorization header.
 
@@ -90,14 +92,14 @@ class Spotify:
             The authorization header.
         """
         try:
-            token = self.__get_spotify_token()
-            return {"Authorization": f"Bearer {token}"}
+            token, expires_in = self.__get_spotify_token()
+            return {"Authorization": f"Bearer {token}"}, expires_in
         except Exception as e:
             raise AuthenticationException(
                 "Failed to authenticate with Spotify API"
             ) from e
 
-    def __get_spotify_token(self) -> str:
+    def __get_spotify_token(self) -> tuple:
         """
         Gets the Spotify API token.
 
@@ -125,14 +127,16 @@ class Spotify:
             raise NetworkException(f"Network error occurred: {e}")
 
         try:
-            return response.json().get("access_token")
+            response_json = response.json()
+            return response_json.get("access_token"), response_json.get("expires_in")
         except (KeyError, ValueError) as e:
             raise InvalidResponseException(f"Invalid response received: {e}")
 
     def __refresh_token_if_expired(self):
         """Refreshes the token if it has expired."""
-        if time.time() - self.__start_time >= 3600:
-            self.__header = self.__authenticate()
+        if time.time() - self.__start_time >= self.__expires_in:
+            self.__header, self.__expires_in = self.__authenticate()
+            self.__start_time = time.time()
 
     def search(self, artist: str, song: str) -> Optional[MusicInfo]:
         """
@@ -155,23 +159,37 @@ class Spotify:
                 "Artist and song names must be valid strings and can't be empty."
             )
 
-        self.__refresh_token_if_expired()
+        music_info = None
+        queries = [
+            f"?q=artist:{artist} track:{song}&type=track&limit=10",
+            f"?q=artist:{artist} album:{song}&type=album&limit=10",
+        ]
 
-        query = f"?q=artist:{artist} track:{song}&type=track&limit=10"
-        query_url = f"{self.api_url}/search{query}"
+        for query in queries:
+            if music_info:
+                return music_info
 
-        try:
-            response = self._session.get(query_url, headers=self.__header, timeout=30)
-            response.raise_for_status()
-        except requests.RequestException as e:
-            raise NetworkException(f"Network error occurred: {e}")
+            self.__refresh_token_if_expired()
 
-        try:
-            result = response.json()["tracks"]["items"]
-        except (KeyError, ValueError) as e:
-            raise InvalidResponseException(f"Invalid response received: {e}")
+            query_url = f"{self.api_url}/search{query}"
+
+            try:
+                response = self._session.get(
+                    query_url, headers=self.__header, timeout=30
+                )
+                response.raise_for_status()
+            except requests.RequestException as e:
+                raise NetworkException(f"Network error occurred: {e}")
+
+            if response.status_code != 200:
+                raise SpotifyException(f"Failed to search for music: {response.json()}")
+
+            artist_ids = self._get_artists_ids(artist)
+            music_info = self._find_music_info(
+                artist, song, response.json(), artist_ids
+            )
 
-        return self._parse_results(artist, song, result)
+        return music_info
 
     def search_advanced(
         self, artist: str, song: str, isrc: str = None, upc: str = None
@@ -281,7 +299,7 @@ class Spotify:
         """
         try:
             for track in response_json["tracks"]["items"]:
-                music_info = self._find_tracks(song, artist, track, artist_ids)
+                music_info = self._find_track(song, artist, track, artist_ids)
                 if music_info:
                     return music_info
         except KeyError:
@@ -297,7 +315,7 @@ class Spotify:
 
         return None
 
-    def _find_tracks(
+    def _find_track(
         self, song: str, artist: str, track: dict, artist_ids: list
     ) -> Optional[MusicInfo]:
         """
@@ -403,11 +421,11 @@ class Spotify:
 
 
 if __name__ == "__main__":
-    Spotify = Spotify(CLIENT_ID, CLIENT_SECRET)
+    spotify = Spotify(SPOTIFY_CLIENT_ID, SPOTIFY_CLIENT_SECRET)
 
     try:
         artist_name = input("Artist Name: ")
         song_name = input("Song Name: ")
-        pprint(Spotify.search(artist_name, song_name))
+        pprint(spotify.search(artist_name, song_name))
     finally:
-        Spotify._close_session()
+        spotify.close_session()

{yutipy-0.1.1.dist-info → yutipy-1.1.0.dist-info}/LICENSE

@@ -1,21 +1,21 @@
-MIT License
-
-Copyright (c) 2025 Cheap Nightbot
-
-Permission is hereby granted, free of charge, to any person obtaining a copy
-of this software and associated documentation files (the "Software"), to deal
-in the Software without restriction, including without limitation the rights
-to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
-copies of the Software, and to permit persons to whom the Software is
-furnished to do so, subject to the following conditions:
-
-The above copyright notice and this permission notice shall be included in all
-copies or substantial portions of the Software.
-
-THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
-IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
-FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
-AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
-LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
-OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
-SOFTWARE.
+MIT License
+
+Copyright (c) 2025 Cheap Nightbot
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

{yutipy-0.1.1.dist-info → yutipy-1.1.0.dist-info}/METADATA

@@ -1,140 +1,152 @@
-Metadata-Version: 2.2
-Name: yutipy
-Version: 0.1.1
-Summary: A simple package for retrieving music information from various music platforms APIs.
-Author: Cheap Nightbot
-Author-email: Cheap Nightbot <hi@cheapnightbot.slmail.me>
-Maintainer-email: Cheap Nightbot <hi@cheapnightbot.slmail.me>
-License: MIT License
-        
-        Copyright (c) 2025 Cheap Nightbot
-        
-        Permission is hereby granted, free of charge, to any person obtaining a copy
-        of this software and associated documentation files (the "Software"), to deal
-        in the Software without restriction, including without limitation the rights
-        to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
-        copies of the Software, and to permit persons to whom the Software is
-        furnished to do so, subject to the following conditions:
-        
-        The above copyright notice and this permission notice shall be included in all
-        copies or substantial portions of the Software.
-        
-        THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
-        IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
-        FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
-        AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
-        LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
-        OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
-        SOFTWARE.
-        
-Project-URL: Homepage, https://github.com/CheapNightbot/yutipy
-Project-URL: Documentation, https://yutipy.readthedocs.io/
-Project-URL: Repository, https://github.com/CheapNightbot/yutipy.git
-Project-URL: Issues, https://github.com/CheapNightbot/yutipy/issues
-Project-URL: Changelog, https://github.com/CheapNightbot/yutipy/blob/master/CHANGELOG.md
-Project-URL: funding, https://ko-fi.com/cheapnightbot
-Keywords: music,API,Deezer,iTunes,Spotify,YouTube Music,search,retrieve,information,yutify
-Classifier: Development Status :: 4 - Beta
-Classifier: Intended Audience :: Developers
-Classifier: Topic :: Software Development :: Libraries
-Classifier: Programming Language :: Python :: 3
-Classifier: Programming Language :: Python :: 3.8
-Classifier: Programming Language :: Python :: 3.9
-Classifier: Programming Language :: Python :: 3.10
-Classifier: Programming Language :: Python :: 3.11
-Classifier: Programming Language :: Python :: 3.12
-Classifier: License :: OSI Approved :: MIT License
-Classifier: Operating System :: OS Independent
-Requires-Python: >=3.8
-Description-Content-Type: text/markdown
-License-File: LICENSE
-Requires-Dist: python-dotenv==1.0.1
-Requires-Dist: rapidfuzz==3.12.1
-Requires-Dist: requests==2.32.3
-Requires-Dist: ytmusicapi==1.10.1
-Provides-Extra: dev
-Requires-Dist: pytest; extra == "dev"
-
-<p align="center">
-<img src="https://raw.githubusercontent.com/CheapNightbot/yutipy/main/docs/_static/yutipy_header.png" alt="yutipy" />
-</p>
-
-<p align="center">
-<a href="https://github.com/CheapNightbot/yutipy/actions/workflows/tests.yml">
-<img alt="GitHub Actions Workflow Status" src="https://img.shields.io/github/actions/workflow/status/cheapnightbot/yutipy/pytest-unit-testing.yml?style=for-the-badge&label=Pytest">
-</a>
-    
-<a href="https://pypi.org/project/yutipy/">
-<img src="https://img.shields.io/pypi/v/yutipy?style=for-the-badge" alt="PyPI" />
-</a>
-<a href="https://yutipy.readthedocs.io/en/latest/">
-<img src="https://img.shields.io/readthedocs/yutipy?style=for-the-badge" alt="Documentation Status" />
-</a>
-<a href="https://github.com/CheapNightbot/yutipy/blob/master/LICENSE">
-<img src="https://img.shields.io/github/license/CheapNightbot/yutipy?style=for-the-badge" alt="License" />
-</a>
-<a href="https://github.com/CheapNightbot/yutipy/stargazers">
-<img src="https://img.shields.io/github/stars/CheapNightbot/yutipy?style=for-the-badge" alt="Stars" />
-</a>
-<a href="https://github.com/CheapNightbot/yutipy/issues">
-<img src="https://img.shields.io/github/issues/CheapNightbot/yutipy?style=for-the-badge" alt="Issues" />
-</a>
-</p>
-
-A _**simple**_ Python package for searching and retrieving music information from various music platforms APIs, including Deezer, iTunes, Spotify, and YouTube Music.
-
-## Table of Contents
-
-- [Features](#features)
-- [Installation](#installation)
-- [Usage Example](#usage-example)
-- [Contributing](#contributing)
-- [License](#license)
-
-## Features
-
-- Simple & Easy integration with popular music APIs.
-- Search for music by artist and song title across multiple platforms.
-- Retrieve detailed music information, including album art, release dates, ISRC, and UPC codes.
-
-## Installation
-
-You can install the package using pip. Make sure you have Python 3.8 or higher installed.
-
-```bash
-pip install -U yutipy
-```
-
-## Usage Example
-
-Here's a quick example of how to use the `yutipy` package to search for a song:
-
-### Deezer
-
-```python
-from yutipy.deezer import Deezer
-
-with Deezer() as deezer:
-    result = deezer.search("Artist Name", "Song Title")
-    print(result)
-```
-
-For more usage examples, see the [Usage Examples](https://yutipy.readthedocs.io/en/latest/usage_examples.html) page in docs.
-
-## Contributing
-
-Contributions are welcome! Please follow these steps:
-
-1. Fork the repository.
-2. Optionally, create an issue to discuss the changes you plan to make.
-3. Create a new branch linked to that issue.
-4. Make your changes in the new branch.
-5. Write tests if you add new functionality.
-6. Ensure all tests pass before opening a pull request.
-7. Open a pull request for review.
-
-Thank you for your contributions!
-
-## License
-
-This project is licensed under the MIT License. See the [LICENSE](LICENSE) file for details.
+Metadata-Version: 2.2
+Name: yutipy
+Version: 1.1.0
+Summary: A simple package for retrieving music information from various music platforms APIs.
+Author: Cheap Nightbot
+Author-email: Cheap Nightbot <hi@cheapnightbot.slmail.me>
+Maintainer-email: Cheap Nightbot <hi@cheapnightbot.slmail.me>
+License: MIT License
+        
+        Copyright (c) 2025 Cheap Nightbot
+        
+        Permission is hereby granted, free of charge, to any person obtaining a copy
+        of this software and associated documentation files (the "Software"), to deal
+        in the Software without restriction, including without limitation the rights
+        to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+        copies of the Software, and to permit persons to whom the Software is
+        furnished to do so, subject to the following conditions:
+        
+        The above copyright notice and this permission notice shall be included in all
+        copies or substantial portions of the Software.
+        
+        THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+        IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+        FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+        AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+        LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+        OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+        SOFTWARE.
+        
+Project-URL: Homepage, https://github.com/CheapNightbot/yutipy
+Project-URL: Documentation, https://yutipy.readthedocs.io/
+Project-URL: Repository, https://github.com/CheapNightbot/yutipy.git
+Project-URL: Issues, https://github.com/CheapNightbot/yutipy/issues
+Project-URL: Changelog, https://github.com/CheapNightbot/yutipy/blob/master/CHANGELOG.md
+Project-URL: funding, https://ko-fi.com/cheapnightbot
+Keywords: music,API,Deezer,iTunes,Spotify,YouTube Music,search,retrieve,information,yutify
+Classifier: Development Status :: 4 - Beta
+Classifier: Intended Audience :: Developers
+Classifier: Topic :: Software Development :: Libraries
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.8
+Classifier: Programming Language :: Python :: 3.9
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+Requires-Python: >=3.8
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: python-dotenv==1.0.1
+Requires-Dist: rapidfuzz==3.12.1
+Requires-Dist: requests==2.32.3
+Requires-Dist: ytmusicapi==1.10.1
+Provides-Extra: dev
+Requires-Dist: pytest; extra == "dev"
+
+<p align="center">
+<img src="https://raw.githubusercontent.com/CheapNightbot/yutipy/main/docs/_static/yutipy_header.png" alt="yutipy" />
+</p>
+
+<p align="center">
+<a href="https://github.com/CheapNightbot/yutipy/actions/workflows/tests.yml">
+<img alt="GitHub Actions Workflow Status" src="https://img.shields.io/github/actions/workflow/status/cheapnightbot/yutipy/pytest-unit-testing.yml?style=for-the-badge&label=Pytest">
+</a>
+<a href="https://pypi.org/project/yutipy/">
+<img src="https://img.shields.io/pypi/v/yutipy?style=for-the-badge" alt="PyPI" />
+</a>
+<a href="https://yutipy.readthedocs.io/en/latest/">
+<img src="https://img.shields.io/readthedocs/yutipy?style=for-the-badge" alt="Documentation Status" />
+</a>
+<a href="https://github.com/CheapNightbot/yutipy/blob/master/LICENSE">
+<img src="https://img.shields.io/github/license/CheapNightbot/yutipy?style=for-the-badge" alt="License" />
+</a>
+<a href="https://github.com/CheapNightbot/yutipy/stargazers">
+<img src="https://img.shields.io/github/stars/CheapNightbot/yutipy?style=for-the-badge" alt="Stars" />
+</a>
+<a href="https://github.com/CheapNightbot/yutipy/issues">
+<img src="https://img.shields.io/github/issues/CheapNightbot/yutipy?style=for-the-badge" alt="Issues" />
+</a>
+</p>
+
+A _**simple**_ Python package for searching and retrieving music information from various music platforms APIs, including Deezer, iTunes, Spotify, and YouTube Music.
+
+## Table of Contents
+
+- [Features](#features)
+    - [Available Music Platforms](#available-music-platforms)
+- [Installation](#installation)
+- [Usage Example](#usage-example)
+- [Contributing](#contributing)
+- [License](#license)
+
+## Features
+
+- Simple & Easy integration with popular music APIs.
+- Search for music by artist and song title across multiple platforms.
+- It uses `RapidFuzz` to compare & return the best match so that you can be sure you got what you asked for without having to worry and doing all that work by yourself.
+- Retrieve detailed music information, including album art, release dates, lyrics, ISRC, and UPC codes.
+
+### Available Music Platforms
+
+Right now, the following music platforms are available in yutipy for searching music. New platforms will be added in the future.
+Feel free to request any music platform you would like me to add by opening an issue on [GitHub](https://github.com/CheapNightbot/yutipy/issues) or by emailing me.
+
+- `Deezer`: https://www.deezer.com
+- `iTunes`: https://music.apple.com
+- `KKBOX`: https://www.kkbox.com
+- `Spotify`: https://spotify.com
+- `YouTube Music`: https://music.youtube.com
+
+## Installation
+
+You can install the package using pip. Make sure you have Python 3.8 or higher installed.
+
+```bash
+pip install -U yutipy
+```
+
+## Usage Example
+
+Here's a quick example of how to use the `yutipy` package to search for a song:
+
+### Deezer
+
+```python
+from yutipy.deezer import Deezer
+
+with Deezer() as deezer:
+    result = deezer.search("Artist Name", "Song Title")
+    print(result)
+```
+
+For more usage examples, see the [Usage Examples](https://yutipy.readthedocs.io/en/latest/usage_examples.html) page in docs.
+
+## Contributing
+
+Contributions are welcome! Please follow these steps:
+
+1. Fork the repository.
+2. Optionally, create an issue to discuss the changes you plan to make.
+3. Create a new branch linked to that issue.
+4. Make your changes in the new branch.
+5. Write tests if you add new functionality.
+6. Ensure all tests pass before opening a pull request.
+7. Open a pull request for review.
+
+Thank you for your contributions!
+
+## License
+
+This project is licensed under the MIT License. See the [LICENSE](LICENSE) file for details.

yutipy-1.1.0.dist-info/RECORD

@@ -0,0 +1,15 @@
+yutipy/__init__.py,sha256=t0w-pRLjIGD3UtDyd-JpeL-RrMona7YTV_0lZCpGLEc,232
+yutipy/deezer.py,sha256=TbPk6f1ytrtk9GHXOoRZ948fcgOi0619-rQC9xfTYu0,8641
+yutipy/exceptions.py,sha256=4L0Oe1PwFP34LoFTy-Fruipk7uB-JkaackRmkjlaZJU,1138
+yutipy/itunes.py,sha256=NhrllA3U0PUY3dNoMyiG1oZuyvdMQKYRBHzYSkt8ikM,5843
+yutipy/kkbox.py,sha256=l-I1FZjKzLLqjN0hO2hvz6AdNuYvD1B4XI36m3sWmfM,10123
+yutipy/models.py,sha256=RnfWjoNO1UoNsRvNRYd-4TpkU-4jHKu5t394vIqOOgw,1360
+yutipy/musicyt.py,sha256=kvRYuhlNVuvy-WahJq895T3JAzmGTTiKB89r_uTMTAI,7155
+yutipy/spotify.py,sha256=CZA9XF0EV5wSrLrN9cURtiFKSEHsIvqVlXLKkvb4JEM,13609
+yutipy/utils/__init__.py,sha256=7UFcFZ7fBtNXOTngjnRD3MeobT3x5UT2Gag94TXVgLk,169
+yutipy/utils/cheap_utils.py,sha256=LIuEHib_97NuLahXxdHJUD9v-ccXNUc3NrLYk8EQ52A,1652
+yutipy-1.1.0.dist-info/LICENSE,sha256=_89JsS2QnBG8tAb5-VWbJDj_uJ002zPJAYBJJdh3DPY,1071
+yutipy-1.1.0.dist-info/METADATA,sha256=2EY4cfuWnLA1fH4E1G1qp8x3o53M8bzAYSX6QPdxAms,6467
+yutipy-1.1.0.dist-info/WHEEL,sha256=jB7zZ3N9hIM9adW7qlTAyycLYW9npaWKLRzaoVcLKcM,91
+yutipy-1.1.0.dist-info/top_level.txt,sha256=t2A5V2_mUcfnHkbCy6tAQlb3909jDYU5GQgXtA4756I,7
+yutipy-1.1.0.dist-info/RECORD,,

{yutipy-0.1.1.dist-info → yutipy-1.1.0.dist-info}/WHEEL

@@ -1,5 +1,5 @@
 Wheel-Version: 1.0
-Generator: setuptools (75.8.0)
+Generator: setuptools (75.8.2)
 Root-Is-Purelib: true
 Tag: py3-none-any
 

yutipy-0.1.1.dist-info/RECORD

@@ -1,23 +0,0 @@
-yutipy/__init__.py,sha256=t0w-pRLjIGD3UtDyd-JpeL-RrMona7YTV_0lZCpGLEc,232
-yutipy/deezer.py,sha256=TbPk6f1ytrtk9GHXOoRZ948fcgOi0619-rQC9xfTYu0,8641
-yutipy/exceptions.py,sha256=QDfOkaeZtSNg1lhXZ872yNJwbof68eVHDezZeZh8DiU,1029
-yutipy/itunes.py,sha256=NhrllA3U0PUY3dNoMyiG1oZuyvdMQKYRBHzYSkt8ikM,5843
-yutipy/models.py,sha256=-UEi05on5XsKjFSqUNt1yZnLod_A9upqh2nIPWTtEEI,1415
-yutipy/musicyt.py,sha256=kvRYuhlNVuvy-WahJq895T3JAzmGTTiKB89r_uTMTAI,7155
-yutipy/spotify.py,sha256=YYTF1git7mRVFWWGM1TILIIyZMPPDbD_F_BLjfqU6cI,12906
-yutipy/__pycache__/__init__.cpython-312.pyc,sha256=q-CaghM107NTOH0ZfH9LKDDUZJuGA_teF1QyoO1wNb8,392
-yutipy/__pycache__/deezer.cpython-312.pyc,sha256=UfRxyBobsocMxkpF4HP06EpFsAz96ZHU4QlYn8EzQcY,10588
-yutipy/__pycache__/exceptions.cpython-312.pyc,sha256=Zc73Tr79emWJ9pmpAVoL12YnBBOWJulV1hxtSso4hy8,2096
-yutipy/__pycache__/itunes.cpython-312.pyc,sha256=59fJpxL2ZjQoyzq_1U6sesJEuNrfa62kvtPYeSwzZNg,7521
-yutipy/__pycache__/models.cpython-312.pyc,sha256=KJUa3-C67TMq1EAGuQlZYT99JS1AEDUi74KY8bEHkkg,1848
-yutipy/__pycache__/musicyt.cpython-312.pyc,sha256=y508WR8Cl8DtisJli3FwNDEC6CJZajiZdcWJLN7xXyY,9176
-yutipy/__pycache__/spotify.cpython-312.pyc,sha256=0Knor0AN6zG6ATYSGL0YPb6b7rrT2krnpBv-e2ynam8,15870
-yutipy/utils/__init__.py,sha256=7UFcFZ7fBtNXOTngjnRD3MeobT3x5UT2Gag94TXVgLk,169
-yutipy/utils/cheap_utils.py,sha256=LIuEHib_97NuLahXxdHJUD9v-ccXNUc3NrLYk8EQ52A,1652
-yutipy/utils/__pycache__/__init__.cpython-312.pyc,sha256=_ldEMv66ELlrY1M7fN_2r5XySvgAsqTE0U8ASGXx8bs,286
-yutipy/utils/__pycache__/cheap_utils.cpython-312.pyc,sha256=i6nRmXcRtCkTzKQ1mWyjN7Xz4NapqgBdXA33so8xgLU,2376
-yutipy-0.1.1.dist-info/LICENSE,sha256=Tymbhvk1F_6BDFE0X8BBiQp7cBCjbzKfRAITmvxJIyA,1092
-yutipy-0.1.1.dist-info/METADATA,sha256=nWGLHD2t-1GvvU9vUXcU5TtvLe05_w2G0U8pKhWw_Uc,5865
-yutipy-0.1.1.dist-info/WHEEL,sha256=In9FTNxeP60KnTkGw7wk6mJPYd_dQSjEZmXdBdMCI-8,91
-yutipy-0.1.1.dist-info/top_level.txt,sha256=t2A5V2_mUcfnHkbCy6tAQlb3909jDYU5GQgXtA4756I,7
-yutipy-0.1.1.dist-info/RECORD,,