yutipy 2.3.6__py3-none-any.whl → 2.4.0__py3-none-any.whl

yutipy/lastfm.py

@@ -71,6 +71,11 @@ class LastFm:
         """
         Fetches the user profile information for the provided username.
 
+        Parameters
+        ----------
+        username : str
+            The Last.fm username to fetch profile information for.
+
         Returns
         -------
         dict
@@ -109,7 +114,7 @@ class LastFm:
 
     def get_currently_playing(self, username: str) -> Optional[UserPlaying]:
         """
-        Fetches information about the currently playing or most recent track for a user.
+        Fetches information about the currently playing track for a user.
 
         Parameters
         ----------

yutipy/listenbrainz.py

@@ -0,0 +1,141 @@
+__all__ = ["ListenBrainz"]
+
+from typing import Optional
+from time import time
+
+import requests
+
+from yutipy.logger import logger
+from yutipy.models import UserPlaying
+from yutipy.utils.helpers import are_strings_similar
+
+
+class ListenBrainz:
+    """A class to interact with the ListenBrainz API for fetching user music data."""
+
+    def __init__(self):
+        self._is_session_closed = False
+        self.__api_url = "https://api.listenbrainz.org"
+        self.__session = requests.Session()
+
+    def __enter__(self):
+        return self
+
+    def __exit__(self, exc_type, exc_value, exc_traceback):
+        self.close_session()
+
+    def close_session(self):
+        """Closes the current session(s)."""
+        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 find_user(self, username: str) -> Optional[str]:
+        """
+        Whether profile with the provided username exists on the ListenBrainz.
+
+        It searches ListenBrainz for the provided username and fuzzy matches
+        the provided username with the username(s) returned from ListenBrainz API.
+
+        Parameters
+        ----------
+        username : str
+            The username to search.
+
+        Returns
+        -------
+        Optional[str]
+            The username returned by ListenBrainz API if user found,
+            or ``None`` if the user with provided username does not exist.
+        """
+        endpoint = "/1/search/users/"
+        url = self.__api_url + endpoint
+
+        try:
+            response = self.__session.get(
+                url=url, params={"search_term": username}, timeout=30
+            )
+            response.raise_for_status()
+        except requests.RequestException as e:
+            logger.warning(f"Failed to search for the user: {e}")
+            return
+
+        response_json = response.json()
+        users = response_json.get("users")
+
+        if not users:
+            return
+
+        for user in users:
+            user_name = user.get("user_name")
+            if are_strings_similar(
+                username, user_name, threshold=100, use_translation=False
+            ):
+                return user_name
+
+    def get_currently_playing(self, username: str) -> Optional[UserPlaying]:
+        """
+        Fetches information about the currently playing track for a user.
+
+        Parameters
+        ----------
+        username : str
+            The ListenBrainz username to fetch data for.
+
+        Returns
+        -------
+        Optional[UserPlaying_]
+            An instance of the ``UserPlaying`` model containing details about the currently
+            playing track if available, or ``None`` if the request fails or no data is available.
+        """
+        endpoint = f"/1/user/{username}/playing-now"
+        url = self.__api_url + endpoint
+
+        try:
+            response = self.__session.get(url=url, timeout=30)
+            response.raise_for_status()
+        except requests.RequestException as e:
+            logger.warning(f"Failed to retrieve listening activity: {e}")
+            return
+
+        response_json = response.json()
+        if not response_json:
+            logger.info(
+                f"It seems no activity found for `{username}`. Might be user does not exist or not no data available."
+            )
+            return
+
+        result = response_json.get("payload", {})
+        is_playing = result.get("playing_now", False)
+        user_id = result.get("user_id", "")
+
+        if username.lower() != user_id.lower():
+            return
+
+        if result and is_playing:
+            track_metadata = result.get("listens", [{}])[0].get("track_metadata", {})
+            return UserPlaying(
+                artists=track_metadata.get("artist_name"),
+                id=None,
+                timestamp=time(),
+                title=track_metadata.get("track_name"),
+                url=track_metadata.get("additional_info", {}).get("origin_url"),
+                is_playing=is_playing,
+            )
+        return None
+
+
+if __name__ == "__main__":
+    with ListenBrainz() as listenbrainz:
+        username = input("Enter ListenBrainz Username: ").strip()
+        result = listenbrainz.find_user(username)
+
+        if result:
+            print(f"User found with username: {result}")
+        else:
+            print(f"No user with username '{username}' found!")

yutipy/utils/helpers.py

@@ -76,7 +76,7 @@ def are_strings_similar(
     Args:
         str1 (str): First string to compare.
         str2 (str): Second string to compare.
-        threshold (int, optional): Similarity threshold. Defaults to 80.
+        threshold (int, optional): Similarity threshold. Defaults to 95.
         use_translation (bool, optional): Use translations to compare strings. Defaults to ``True``
         translation_session (requests.Session, optional): A `requests.Session` object to use for making the API request. If not provided, a new session will be created and closed within the function.
             Providing your own session can improve performance by reusing the same session for multiple requests. Don't forget to close the session afterwards.

{yutipy-2.3.6.dist-info → yutipy-2.4.0.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: yutipy
-Version: 2.3.6
+Version: 2.4.0
 Summary: A simple Python package to interact with various music platforms APIs.
 Author: Cheap Nightbot
 Author-email: Cheap Nightbot <hi@cheapnightbot.slmail.me>
@@ -92,6 +92,7 @@ Feel free to request any music platform you would like me to add by opening an i
 - `iTunes`: https://music.apple.com
 - `KKBOX`: https://www.kkbox.com
 - `Lastfm`: https://last.fm
+- `ListenBrainz`: https://listenbrainz.org
 - `Spotify`: https://spotify.com
 - `YouTube Music`: https://music.youtube.com
 

{yutipy-2.3.6.dist-info → yutipy-2.4.0.dist-info}/RECORD

@@ -4,7 +4,8 @@ yutipy/deezer.py,sha256=WzqC4ylZo7VmbyAfVZarvaqmnlamdEge3ceY_OJ9h4Y,11021
 yutipy/exceptions.py,sha256=zz0XyyZr5xRcmRyw3hdTGaVRcwRn_RSYZdmwmuO0sEM,1379
 yutipy/itunes.py,sha256=_iWq1COXNAiLIrUtwfI1jNey9dXe3-gCzoRF0eGgTs8,8038
 yutipy/kkbox.py,sha256=nvclRgGqQHUzIS_zhbJp_PJHiWmkU3nzwLAUhdaPCLI,12103
-yutipy/lastfm.py,sha256=2CQJfHtJyrg0qQ_kVdG2v18n6K8nbnBEKgrLagLtIf8,5775
+yutipy/lastfm.py,sha256=UylKs6yHOvnSguW7KJHx5yzPuOUXP3haqm_5TdOQKLA,5889
+yutipy/listenbrainz.py,sha256=dhTy5sFHmMUGdp6MyDQtNH2xSKMobq7PzQqyWDi7YXw,4518
 yutipy/logger.py,sha256=GyLBlfQZ6pLNJ5MbyQSvcD_PkxmFdX41DPq5aeG1z68,1316
 yutipy/lrclib.py,sha256=7EFoCZ7kF2blbwA81tzyCrmIIvuuWsE2aO3SfNyyWEc,5220
 yutipy/models.py,sha256=45M-bNHusaAan_Ta_E9DyvsWujsT-ivbJqIfy2-i3R8,2343
@@ -15,10 +16,10 @@ yutipy/cli/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 yutipy/cli/config.py,sha256=e5RIq6RxVxxzx30nKVMa06gwyQ258s7U0WA1xvJuR_0,4543
 yutipy/cli/search.py,sha256=8SQw0bjRzRqAg-FuVz9aWjB2KBZqmCf38SyKAQ3rx5E,3025
 yutipy/utils/__init__.py,sha256=AZaqvs6AJwnqwJuodbGnHu702WSUqc8plVC16SppOcU,239
-yutipy/utils/helpers.py,sha256=UDhRIFC-WeAFwmGAkluqdcLMWTpFZPgp2EnNo7kiPe4,7413
-yutipy-2.3.6.dist-info/licenses/LICENSE,sha256=_89JsS2QnBG8tAb5-VWbJDj_uJ002zPJAYBJJdh3DPY,1071
-yutipy-2.3.6.dist-info/METADATA,sha256=9_hS1xLfe0cKE4vmmRKzr0RodSKK-qO4WyzCnas41qw,6577
-yutipy-2.3.6.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
-yutipy-2.3.6.dist-info/entry_points.txt,sha256=BrgmanaPjQqKQ3Ip76JLcsPgGANtrBSURf5CNIxl1HA,106
-yutipy-2.3.6.dist-info/top_level.txt,sha256=t2A5V2_mUcfnHkbCy6tAQlb3909jDYU5GQgXtA4756I,7
-yutipy-2.3.6.dist-info/RECORD,,
+yutipy/utils/helpers.py,sha256=ia9egDoRfDqUJvVTsuGk08pf6-n4hZITrvPPtXCohIY,7413
+yutipy-2.4.0.dist-info/licenses/LICENSE,sha256=_89JsS2QnBG8tAb5-VWbJDj_uJ002zPJAYBJJdh3DPY,1071
+yutipy-2.4.0.dist-info/METADATA,sha256=WvofogvK5MjOEevTwdfsXvm81uRw16mSwTeZC_8EfjE,6620
+yutipy-2.4.0.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
+yutipy-2.4.0.dist-info/entry_points.txt,sha256=BrgmanaPjQqKQ3Ip76JLcsPgGANtrBSURf5CNIxl1HA,106
+yutipy-2.4.0.dist-info/top_level.txt,sha256=t2A5V2_mUcfnHkbCy6tAQlb3909jDYU5GQgXtA4756I,7
+yutipy-2.4.0.dist-info/RECORD,,