Sourced from spotipy's releases.

2.25.1: CVE-2025-27154

Security

• CVE-2025-27154 – Cache file permissions tightened: now 600 (user read/write only) instead of 644, preventing unauthorized local access to auth tokens (by @​alichtman)
  • Upgrade if you run spotipy in a multi-user environment, manage multiple users' auth tokens, or need better protection against local unauthorized access; not required if you're the only user and your home directory is private.

Added

• Added examples for audiobooks, shows and episodes methods to examples directory

Fixed

• Fixed scripts in examples directory that didn't run correctly
• Updated documentation for Client.current_user_top_artists to indicate maximum number of artists limit

Changed

• Updated get_cached_token and save_token_to_cache methods to utilize Python's Context Management Protocol
• Added except clause to get_cached_token method to handle json decode errors
• Added warnings and updated docs due to Spotify's deprecation of HTTP and "localhost" redirect URIs
• Use newer string formatters (https://pyformat.info)
• Marked recommendation_genre_seeds as deprecated

2.25: Deprecated methods & misc. updates

Added

• Added unit tests for queue functions
• Added detailed function docstrings to 'util.py', including descriptions and special sections that lists arguments, returns, and raises.
• Updated order of instructions for Python and pip package manager installation in TUTORIAL.md
• Updated TUTORIAL.md instructions to match current layout of Spotify Developer Dashboard
• Added test_artist_id, test_artist_url, and test_artists_mixed_ids to non_user_endpoints test.py
• Added rate/request limit to FAQ
• Added custom urllib3.Retry class for printing a warning when a rate/request limit is reached.
• Added personalized_playlist.py, track_recommendations.py, and audio_features_analysis.py to /examples.
• Discord badge in README
• Added SpotifyBaseException and moved all exceptions to exceptions.py
• Marked the following methods as deprecated:
  • artist_related_artists
  • recommendations
  • audio_features
  • audio_analysis
  • featured_playlists
  • category_playlists
• Added FAQ entry for inaccessible playlists

Fixed

• Audiobook integration tests
• Edited docstrings for certain functions in client.py for functions that are no longer in use and have been replaced.
• current_user_unfollow_playlist() now supports playlist IDs, URLs, and URIs rather than previously where it only supported playlist IDs.

Removed

... (truncated)

Sourced from spotipy's changelog.

[2.25.1] - 2025年02月27日

Added

• Added examples for audiobooks, shows and episodes methods to examples directory

Fixed

• Fixed scripts in examples directory that didn't run correctly
• Updated documentation for Client.current_user_top_artists to indicate maximum number of artists limit
• Set auth cache file permissions to 600: GHSA-pwhh-q4h6-w599

Changed

• Updated get_cached_token and save_token_to_cache methods to utilize Python's Context Management Protocol
• Added except clause to get_cached_token method to handle json decode errors
• Added warnings and updated docs due to Spotify's deprecation of HTTP and "localhost" redirect URIs
• Use newer string formatters (https://pyformat.info)
• Marked recommendation_genre_seeds as deprecated

[2.25.0] - 2025年03月01日

Added

• Added unit tests for queue functions
• Added detailed function docstrings to 'util.py', including descriptions and special sections that lists arguments, returns, and raises.
• Updated order of instructions for Python and pip package manager installation in TUTORIAL.md
• Updated TUTORIAL.md instructions to match current layout of Spotify Developer Dashboard
• Added test_artist_id, test_artist_url, and test_artists_mixed_ids to non_user_endpoints test.py
• Added rate/request limit to FAQ
• Added custom urllib3.Retry class for printing a warning when a rate/request limit is reached.
• Added personalized_playlist.py, track_recommendations.py, and audio_features_analysis.py to /examples.
• Discord badge in README
• Added SpotifyBaseException and moved all exceptions to exceptions.py
• Marked the following methods as deprecated:
  • artist_related_artists
  • recommendations
  • audio_features
  • audio_analysis
  • featured_playlists
  • category_playlists
• Added FAQ entry for inaccessible playlists
• Workflow to check for f-strings

Changed

• Split test and lint workflows
• Updated get_cached_token and save_token_to_cache methods to utilize Python's Context Management Protocol
• Added except clause to get_cached_token method to handle json decode errors

... (truncated)

• 103d687 Bump to 2.25.1
• 1ca453f Merge commit from fork
• 668158f Fixed Spotify's deprecation of http and localhost (#1187)
• a6f6841 Remove dead link
• d9ec669 added branch overview
• c738376 Check f-strings (#1184)
• 1d920ff use f-strings
• 8178893 Add back submodule
• 1dbbbf6 Changed cache_handler.py to utilize Python's Context Management Protocol (#991)
• d319c6e Move examples to spotipy-dev/spotipy-examples, add as submodule
• Additional commits viewable in compare view

You can trigger Dependabot actions by commenting on this PR:

• @dependabot rebase will rebase this PR
• @dependabot recreate will recreate this PR, overwriting any edits that have been made to it
• @dependabot merge will merge this PR after your CI passes on it
• @dependabot squash and merge will squash and merge this PR after your CI passes on it
• @dependabot cancel merge will cancel a previously requested merge and block automerging
• @dependabot reopen will reopen this PR if it is closed
• @dependabot close will close this PR and stop Dependabot recreating it. You can achieve the same result by closing it manually
• @dependabot show <dependency name> ignore conditions will show all of the ignore conditions of the specified dependency
• @dependabot ignore this major version will close this PR and stop Dependabot creating any more for this major version (unless you reopen the PR or upgrade to it yourself)
• @dependabot ignore this minor version will close this PR and stop Dependabot creating any more for this minor version (unless you reopen the PR or upgrade to it yourself)
• @dependabot ignore this dependency will close this PR and stop Dependabot creating any more for this dependency (unless you reopen the PR or upgrade to it yourself)
  You can disable automated security fix PRs for this repo from the Security Alerts page.