feat: Add sonicAdventure method to MusicSection

plexapi/library.py

@@ -1,5 +1,8 @@
 # -*- coding: utf-8 -*-
+from __future__ import annotations
+
 import re
+from typing import Any, TYPE_CHECKING
 import warnings
 from collections import defaultdict
 from datetime import datetime
@@ -17,6 +20,10 @@
 from plexapi.utils import deprecated
 
 
+if TYPE_CHECKING:
+    from plexapi.audio import Track
+
+
 class Library(PlexObject):
     """ Represents a PlexServer library. This contains all sections of media defined
         in your Plex server including video, shows and audio.
@@ -2033,6 +2040,26 @@ def sync(self, bitrate, limit=None, **kwargs):
         kwargs['policy'] = Policy.create(limit)
         return super(MusicSection, self).sync(**kwargs)
 
+    def sonicAdventure(
+            self,
+            startID: int,
+            endID: int,
+            **kwargs: Any,
+    ) -> list[Track]:
+        """ Returns a list of tracks from this library section that are part of a sonic adventure.
+        ID's should be of a track, other ID's will return an empty list or items itself or an error.
+
+                Parameters:
+                    startID (int): The ratingKey of the first track in the sonic adventure.
+                    endID (int): The ratingKey of the last track in the sonic adventure.
+
+                Returns:
+                    List[:class:`~plexapi.audio.Track`]: a list of tracks from this library section
+                    that are part of a sonic adventure.
+        """
+        key = f"/library/sections/{self.key}/computePath?startID={startID}&endID={endID}"
+        return self.fetchItems(key, **kwargs)
+
 
 class PhotoSection(LibrarySection, PhotoalbumEditMixins, PhotoEditMixins):
     """ Represents a :class:`~plexapi.library.LibrarySection` section containing photos.

tests/test_library.py

@@ -430,6 +430,13 @@ def test_library_MusicSection_recentlyAdded(music, artist):
     assert track in music.recentlyAddedTracks()
 
 
+def test_library_MusicSection_sonicAdventure(music):
+    tracks = music.searchTracks()
+    adventure = music.sonicAdventure(tracks[0].ratingKey, tracks[-1].ratingKey)
+    assert len(adventure)
+    assert all(isinstance(t, plexapi.audio.Track) for t in adventure)
+
+
 def test_library_PhotoSection_searchAlbums(photos, photoalbum):
     title = photoalbum.title
     assert len(photos.searchAlbums(title=title))