Get playlist tracks, items count. Get playlist tracks paginated.

Author: tehkillerbee

tidalapi/playlist.py

@@ -25,6 +25,7 @@
 from tidalapi.exceptions import ObjectNotFound, TooManyRequests
 from tidalapi.types import ItemOrder, JsonObj, OrderDirection
 from tidalapi.user import LoggedInUser
+from tidalapi.workers import get_items
 
 if TYPE_CHECKING:
     from tidalapi.artist import Artist
@@ -161,6 +162,40 @@ def parse_factory(self, json_obj: JsonObj) -> "Playlist":
         self.parse(json_obj)
         return copy.copy(self.factory())
 
+    def get_tracks_count(
+        self,
+    ) -> int:
+        """Get the total number of tracks in the playlist.
+
+        This performs a minimal API request (limit=1) to fetch metadata about the tracks
+        without retrieving all of them. The API response contains 'totalNumberOfItems',
+        which represents the total items (tracks) available.
+        :return: The number of items available.
+        """
+        params = {"limit": 1, "offset": 0}
+
+        json_obj = self.request.map_request(
+            self._base_url % self.id + "/tracks", params=params
+        )
+        return json_obj.get("totalNumberOfItems", 0)
+
+    def get_items_count(
+        self,
+    ) -> int:
+        """Get the total number of items in the playlist.
+
+        This performs a minimal API request (limit=1) to fetch metadata about the tracks
+        without retrieving all of them. The API response contains 'totalNumberOfItems',
+        which represents the total items (tracks) available.
+        :return: The number of items available.
+        """
+        params = {"limit": 1, "offset": 0}
+
+        json_obj = self.request.map_request(
+            self._base_url % self.id + "/items", params=params
+        )
+        return json_obj.get("totalNumberOfItems", 0)
+
     def tracks(
         self,
         limit: Optional[int] = None,
@@ -195,6 +230,20 @@ def tracks(
             )
         )
 
+    def tracks_paginated(
+        self,
+        order: Optional[ItemOrder] = None,
+        order_direction: Optional[OrderDirection] = None,
+    ) -> List["Playlist"]:
+        """Get the tracks in the playlist, using pagination.
+
+        :param order: Optional; A :class:`ItemOrder` describing the ordering type when returning the user favorite tracks. eg.: "NAME, "DATE"
+        :param order_direction: Optional; A :class:`OrderDirection` describing the ordering direction when sorting by `order`. eg.: "ASC", "DESC"
+        :return: A :class:`list` :class:`~tidalapi.playlist.Playlist` objects containing the favorite tracks.
+        """
+        count = self.get_tracks_count()
+        return get_items(self.tracks, count, order, order_direction)
+
     def items(
         self,
         limit: int = 100,