yutipy 0.1.0__py3-none-any.whl → 1.0.0__py3-none-any.whl

yutipy/__init__.py

@@ -2,12 +2,12 @@ from .deezer import Deezer
 from .itunes import Itunes
 from .models import MusicInfo
 from .musicyt import MusicYT
-from .spotify import Spotipy
+from .spotify import Spotify
 
 __all__ = [
     "Deezer",
     "Itunes",
     "MusicInfo",
     "MusicYT",
-    "Spotipy",
+    "Spotify",
 ]

yutipy/deezer.py

@@ -30,7 +30,7 @@ class Deezer:
         """Exits the runtime context related to this object."""
         self._close_session()
 
-    def _close_session(self) -> None:
+    def close_session(self) -> None:
         """Closes the current session."""
         if not self.is_session_closed:
             self._session.close()
@@ -54,7 +54,7 @@ class Deezer:
 
         Returns
         -------
-        Optional[MusicInfo]
+        Optional[MusicInfo_]
             The music information if found, otherwise None.
         """
         if not is_valid_string(artist) or not is_valid_string(song):
@@ -104,13 +104,12 @@ class Deezer:
         Optional[Dict]
             A dictionary containing UPC and ISRC information.
         """
-        match music_type:
-            case "track":
-                return self._get_track_info(music_id)
-            case "album":
-                return self._get_album_info(music_id)
-            case _:
-                raise DeezerException(f"Invalid music type: {music_type}")
+        if music_type == "track":
+            return self._get_track_info(music_id)
+        elif music_type == "album":
+            return self._get_album_info(music_id)
+        else:
+            raise DeezerException(f"Invalid music type: {music_type}")
 
     def _get_track_info(self, music_id: int) -> Optional[Dict]:
         """

yutipy/itunes.py

@@ -31,7 +31,7 @@ class Itunes:
         """Exits the runtime context related to this object."""
         self._close_session()
 
-    def _close_session(self) -> None:
+    def close_session(self) -> None:
         """Closes the current session."""
         if not self.is_session_closed:
             self._session.close()
@@ -55,7 +55,7 @@ class Itunes:
 
         Returns
         -------
-        Optional[MusicInfo]
+        Optional[MusicInfo_]
             The music information if found, otherwise None.
         """
         if not is_valid_string(artist) or not is_valid_string(song):

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/musicyt.py

@@ -33,7 +33,7 @@ class MusicYT:
 
         Returns
         -------
-        Optional[MusicInfo]
+        Optional[MusicInfo_]
             The music information if found, otherwise None.
         """
         if not is_valid_string(artist) or not is_valid_string(song):

yutipy/spotify.py

@@ -2,7 +2,7 @@ import base64
 import os
 import time
 from pprint import pprint
-from typing import Optional
+from typing import Optional, Union
 
 import requests
 from dotenv import load_dotenv
@@ -23,41 +23,41 @@ 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 Spotipy:
+class Spotify:
     """
     A class to interact with the Spotify API.
 
-    This class reads the CLIENT_ID and CLIENT_SECRET from 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 Spotipy class and sets up the session.
+        Initializes the Spotify class and sets up the session.
 
         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 `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
 
@@ -69,7 +69,7 @@ class Spotipy:
         """Exits the runtime context related to this object."""
         self._close_session()
 
-    def _close_session(self) -> None:
+    def close_session(self) -> None:
         """Closes the current session."""
         if not self.is_session_closed:
             self._session.close()
@@ -80,7 +80,7 @@ class Spotipy:
         """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 +90,14 @@ class Spotipy:
             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 +125,16 @@ class Spotipy:
             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]:
         """
@@ -147,7 +149,7 @@ class Spotipy:
 
         Returns
         -------
-        Optional[MusicInfo]
+        Optional[MusicInfo_]
             The music information if found, otherwise None.
         """
         if not is_valid_string(artist) or not is_valid_string(song):
@@ -166,12 +168,11 @@ class Spotipy:
         except requests.RequestException as e:
             raise NetworkException(f"Network error occurred: {e}")
 
-        try:
-            result = response.json()["tracks"]["items"]
-        except (KeyError, ValueError) as e:
-            raise InvalidResponseException(f"Invalid response received: {e}")
+        if response.status_code != 200:
+            raise SpotifyException(f"Failed to search for music: {response.json()}")
 
-        return self._parse_results(artist, song, result)
+        artist_ids = self._get_artists_ids(artist)
+        return self._find_music_info(artist, song, response.json(), artist_ids)
 
     def search_advanced(
         self, artist: str, song: str, isrc: str = None, upc: str = None
@@ -192,7 +193,7 @@ class Spotipy:
 
         Returns
         -------
-        Optional[MusicInfo]
+        Optional[MusicInfo_]
             The music information if found, otherwise None.
         """
         if not is_valid_string(artist) or not is_valid_string(song):
@@ -224,7 +225,7 @@ class Spotipy:
         artist_ids = self._get_artists_ids(artist)
         return self._find_music_info(artist, song, response.json(), artist_ids)
 
-    def _get_artists_ids(self, artist: str) -> list | None:
+    def _get_artists_ids(self, artist: str) -> Union[list, None]:
         """
         Retrieves the IDs of the artists.
 
@@ -235,7 +236,7 @@ class Spotipy:
 
         Returns
         -------
-        list | None
+        Union[list, None]
             A list of artist IDs or None if not found.
         """
         artist_ids = []
@@ -403,11 +404,11 @@ class Spotipy:
 
 
 if __name__ == "__main__":
-    spotipy = Spotipy(CLIENT_ID, CLIENT_SECRET)
+    Spotify = Spotify(SPOTIFY_CLIENT_ID, SPOTIFY_CLIENT_SECRET)
 
     try:
         artist_name = input("Artist Name: ")
         song_name = input("Song Name: ")
-        pprint(spotipy.search(artist_name, song_name))
+        pprint(Spotify.search(artist_name, song_name))
     finally:
-        spotipy._close_session()
+        Spotify.close_session()

{yutipy-0.1.0.dist-info → yutipy-1.0.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.0.dist-info → yutipy-1.0.0.dist-info}/METADATA

@@ -1,119 +1,140 @@
-Metadata-Version: 2.2
-Name: yutipy
-Version: 0.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==8.3.4; extra == "dev"
-Requires-Dist: Sphinx==8.2.0; extra == "dev"
-
-<p align="center">
-<img src="https://raw.githubusercontent.com/CheapNightbot/yutipy/main/docs/_static/yutipy_header.png" alt="yutipy" />
-</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 [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.0.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)
+- [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.
+
+## 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.0.0.dist-info/RECORD

@@ -0,0 +1,14 @@
+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=RnfWjoNO1UoNsRvNRYd-4TpkU-4jHKu5t394vIqOOgw,1360
+yutipy/musicyt.py,sha256=kvRYuhlNVuvy-WahJq895T3JAzmGTTiKB89r_uTMTAI,7155
+yutipy/spotify.py,sha256=ZFn73iHtXczO4Dq3ZfYquwtP_fyfHBK2sJTFrcv_xYE,13232
+yutipy/utils/__init__.py,sha256=7UFcFZ7fBtNXOTngjnRD3MeobT3x5UT2Gag94TXVgLk,169
+yutipy/utils/cheap_utils.py,sha256=LIuEHib_97NuLahXxdHJUD9v-ccXNUc3NrLYk8EQ52A,1652
+yutipy-1.0.0.dist-info/LICENSE,sha256=_89JsS2QnBG8tAb5-VWbJDj_uJ002zPJAYBJJdh3DPY,1071
+yutipy-1.0.0.dist-info/METADATA,sha256=b8VSSJH__Ii-QJOfCszX4pBWEx6sKAmHcL9t4_qPVHQ,5897
+yutipy-1.0.0.dist-info/WHEEL,sha256=jB7zZ3N9hIM9adW7qlTAyycLYW9npaWKLRzaoVcLKcM,91
+yutipy-1.0.0.dist-info/top_level.txt,sha256=t2A5V2_mUcfnHkbCy6tAQlb3909jDYU5GQgXtA4756I,7
+yutipy-1.0.0.dist-info/RECORD,,

{yutipy-0.1.0.dist-info → yutipy-1.0.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.0.dist-info/RECORD

@@ -1,23 +0,0 @@
-yutipy/__init__.py,sha256=GKMg-aksc_2IAjcKAogGCe_aeSstuwAexjVdJRPS0mE,232
-yutipy/deezer.py,sha256=h2ZeOyzS0L0--qmowkNsFXUl0Nbk30x447bapTV10Io,8667
-yutipy/exceptions.py,sha256=QDfOkaeZtSNg1lhXZ872yNJwbof68eVHDezZeZh8DiU,1029
-yutipy/itunes.py,sha256=NiRGCgV5EASjkS_FPhzDwOq8oge-AeDwkVK4JHNy698,5843
-yutipy/models.py,sha256=-UEi05on5XsKjFSqUNt1yZnLod_A9upqh2nIPWTtEEI,1415
-yutipy/musicyt.py,sha256=fVhCFZUgv34CjyDRMIBeLNYsEuTgENxyMlGUt9Uf1JA,7154
-yutipy/spotify.py,sha256=X8-jDFj8U5kY4zeuGoZ-hrgDbzbKKww47vpVvJev1rA,12849
-yutipy/__pycache__/__init__.cpython-312.pyc,sha256=hnQz69yUeXB3mK1j0EiIsKfFRm1ywiQF170VggBhjdc,392
-yutipy/__pycache__/deezer.cpython-312.pyc,sha256=w5LdiOePHf0NLLDQfj__FxsuplJ4dN5JLnCAK0MXD9I,10578
-yutipy/__pycache__/exceptions.cpython-312.pyc,sha256=Zc73Tr79emWJ9pmpAVoL12YnBBOWJulV1hxtSso4hy8,2096
-yutipy/__pycache__/itunes.cpython-312.pyc,sha256=PvXlgEp6uWzAR_VlPYP-bmQQPmkURz2237AOgFiD5o4,7511
-yutipy/__pycache__/models.cpython-312.pyc,sha256=KJUa3-C67TMq1EAGuQlZYT99JS1AEDUi74KY8bEHkkg,1848
-yutipy/__pycache__/musicyt.cpython-312.pyc,sha256=494-Q64MEXVwsRSZycCCp6T-h37y0RAARnv_OA2QZ-0,9175
-yutipy/__pycache__/spotify.cpython-312.pyc,sha256=P5UXhd8g0h9EaxfPaPyQUeIIHHqLmQCcAXfJcTTKzsI,15789
-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.0.dist-info/LICENSE,sha256=Tymbhvk1F_6BDFE0X8BBiQp7cBCjbzKfRAITmvxJIyA,1092
-yutipy-0.1.0.dist-info/METADATA,sha256=krlRAHqZqAowrWiRymP1L5pyC5IgHht8BVpQTz01qMs,4708
-yutipy-0.1.0.dist-info/WHEEL,sha256=In9FTNxeP60KnTkGw7wk6mJPYd_dQSjEZmXdBdMCI-8,91
-yutipy-0.1.0.dist-info/top_level.txt,sha256=t2A5V2_mUcfnHkbCy6tAQlb3909jDYU5GQgXtA4756I,7
-yutipy-0.1.0.dist-info/RECORD,,