yutipy 0.1.0__py3-none-any.whl

yutipy/utils/cheap_utils.py

@@ -0,0 +1,50 @@
+def are_strings_similar(str1: str, str2: str, threshold: int = 80) -> bool:
+    """
+    Determine if two strings are similar based on a given threshold.
+
+    Args:
+        str1 (str): First string to compare.
+        str2 (str): Second string to compare.
+        threshold (int, optional): Similarity threshold. Defaults to 80.
+
+    Returns:
+        bool: True if the strings are similar, otherwise False.
+    """
+    from rapidfuzz import fuzz
+    from rapidfuzz.utils import default_process
+
+    similarity_score = fuzz.WRatio(str1, str2, processor=default_process)
+    return similarity_score > threshold
+
+
+def separate_artists(artists: str, custom_separator: str = None) -> list[str]:
+    """
+    Separate artist names of a song or album into a list.
+
+    Args:
+        artists (str): Artists string (e.g., artistA & artistB, artistA ft. artistB).
+        custom_separator (str, optional): A specific separator to use. Defaults to None.
+
+    Returns:
+        list[str]: List of individual artists.
+    """
+    default_separators = [";", "/", "ft.", "ft", "feat", "feat.", "with", "&", "and"]
+
+    if custom_separator:
+        separators = [custom_separator]
+    else:
+        separators = default_separators
+
+    for sep in separators:
+        artists = artists.replace(sep, ",")
+
+    return [artist.strip() for artist in artists.split(",") if artist.strip()]
+
+
+def is_valid_string(string: str) -> bool:
+    """Validate if a string is non-empty, alphanumeric, or contains non-whitespace characters."""
+    return bool(string and (string.isalnum() or not string.isspace()))
+
+
+if __name__ == "__main__":
+    separate_artists("Artist A ft. Artist B")

yutipy-0.1.0.dist-info/LICENSE

@@ -0,0 +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.

yutipy-0.1.0.dist-info/METADATA

@@ -0,0 +1,119 @@
+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.

yutipy-0.1.0.dist-info/RECORD

@@ -0,0 +1,23 @@
+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,,

yutipy-0.1.0.dist-info/WHEEL

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

yutipy-0.1.0.dist-info/top_level.txt

@@ -0,0 +1 @@
+yutipy