Ytmusicapi

Fixes 🐞
---------
- more fixes for video search edge cases (149)
- fix get_watch_playlist edge case where length field is missing

As always, thanks to all contributors for providing helpful debug information and bringing feature requests to my attention. This release contains some minor new features for existing functions and several important bug fixes.

Features ✨
---------

- `get_library_upload_artist`: added limit parameter for continuations
- `get_watch_playlist`: added artists, album, feedbackTokens and likeStatus
- `isExplicit` key is now available on most endpoints returning songs, most notably `search`, `get_playlist` and `get_album`

Changes ⚒
-----------
- **BREAKING** `get_lyrics` behavior changed. If there are no lyrics, `get_watch_playlist` will now return `None` for the `lyrics` key. The `lyricsFound` key no longer exists. Instead, `get_lyrics` will raise an exception if `None` is passed as the `browseId`
- 4xx HTTP error codes from the YouTube Music API will now raise an exception right away, instead of somewhat confusing error messages from parsing errors

Fixes 🐞
---------
- stop continuation requests if continuation contents are empty (fixes some crashes with continuations)
- fixed view/duration for video search results with missing duration (149)
- fixed get_library_albums error if a library album has no year

A release a day keeps the bugs away... hopefully.

Changes ⚒
-----------
- **potentially breaking** video search results returned by `search` now contain an `artists` key, since videos can now have multiple artists. As with other endpoints, each list entry contains `name` and `id` of the artist.
- if a song search result does not contain an album, the key `album` will be `None` again, as it was before 0.12

Fixes 🐞
---------
- fixed several additional bugs that could cause `search` to throw an Exception
- video search results now have correct `views` and `duration` fields
- fixed an issue with parsing the trackCount of playlists (`get_playlist`) if locale was not set correctly (125)

Fixes 🐞
---------
- some remaining bugs with `search` are fixed in this update (121, 122, 123, 124)

Features ✨
---------
- `get_lyrics`: Thanks to alexmercerind we now have `get_lyrics`, which returns the lyrics for a given song. To retrieve the required `browseId`, call `get_watch_playlist` to get the corresponding


- `edit_song_library_status`: Adding songs to library is now possible. YouTube Music recently separated this feature from the Like Button for individual songs. You can now add or remove songs from your library by passing `feedbackTokens`, which are returned by endpoints that return songs (`search`,`get_playlist`,`get_library_songs`,`get_album`)

Changes ⚒
-----------
- **BREAKING** `get_watch_playlist` no longer directly returns a list of tracks. Instead, a dictionary is now returned with a `tracks` key containing the same data it returned before. This change was made to provide additional data returned by the next endpoint, which can now be used with `get_lyrics`
- `get_song` result now has a category field (thanks maraid )

Fixes 🐞
---------
- `search` results parsing was broken by a YouTube Music update on December 16. 0.12.0 fixes any errors introduced by this update
- `get_liked_songs` now returns the correct `trackCount` (previously erroneously in the `duration` field)
- artist results returned by `search` now have a `browseId` again
- `get_artist` works again with channel IDs returned by `get_library_artists` (future plans include a separate endpoint to list the songs in the library by a specific artist, a recently introduced YouTube Music feature)

Features ✨
---------
- support continuations for `search` and `search_uploads` with new `limit` parameter (95, thanks natumbri )
- add option to ignore spelling correction for `search` (91, thanks osum4est )
- added sort order option to library functions `get_library_songs`, `get_library_albums`, `get_library_artists`, `get_library_subscriptions`, `get_library_upload_songs`, `get_library_upload_albums`, `get_library_upload_artists` (102, thanks ide-an )
- new `get_streaming_data` call to get authenticated AAC stream data for subscribed users (108, thanks corrmaan )

Fixes 🐞
---------
- Small documentation fix for `get_library_artists`