API improvements

This is the first release to feature a streamlined import structure (only top level imports). All old-style imports (from submodules) are still available, a few still needed, but they will be removed in the next major release of Tekore, version 2.0.

Added

• Most imports can be done directly at the top level (#174)

Deprecated

• Importing from submodules, removed in Tekore 2.0 (#81)

Fixed

• recommendations documentation changed to reflect that only IDs are accepted as seeds, not URIs or URLs (#173)
• track_audio_analysis allow for missing attributes in analysis (#175)

Podcast support

Added

• Support for podcasts: new APIs for episodes and shows. New scope user-read-playback-position for returning episode resume points. New endpoints for saving shows in library. playback_queue_add now accepts episode URIs. playback and playback_currently_playing can return currently playing episodes and shows. playlist and playlist_tracks can return episodes on playlists. search allows for searching episodes and shows. (#164)
• Dependency to HTTPX upgraded to include version 0.12.* (#166)

Fixed

• Errors are now correctly raised when parsing responses in playlist and playlist_tracks (#164)
• Conversions to_url now return URLs with prefix https instead of http, in line with API and application behavior.from_url now correctly accepts https addresses for conversion. (#165)
• The repr of local items can now be produced without errors (#171)

Minor improvements

Added

• RetryingSender avoid unnecessary retries and reduce total wait time (#163)

Fixed

• category_playlists require category parameter (#160)
• AsyncPersistentSender persist connections appropriately (#161)
• playback_queue_add match endpoint address to changed API (#162)

Clear playlist

Added

• playlist_tracks_clear convenience endpoint for deleting tracks from a playlist (#155)
• convert accept shows and episodes as valid types (#159)

Fixed

• playlist_tracks_add insert tracks in correct order when chunking (#156)

Queue and repr

Added

• Endpoint for adding to queue
• Readable repr for response models
• Option to specify a maximum size for CachingSender
• Optionally send long lists of resources as chunks

Max limits

Added

• Optionally use maximum limits in all paging calls

Fixed

• Retrieving all items and pages of a search respects API limits (#145)
• Always return an awaitable in paging navigation (#146)

Async support and caching

Added

• Async support in authentication and API endpoints
• Sender that implements response caching
• Reading configuration with missing values produces a warning

Fixed

• Correctly parse playlist when fields is specified (#142)

Bugfix

Bugfixes

• Accept missing video thumbnail in PlaylistTrack (#132)

First stable release

• Packaging improvements
• Declare versioning scheme