What's Changed

• Update the link to information on rate limits by @oifj34f34f in https://github.com/zmb3/spotify/pull/245
• Enable race detection in CI testing by @strideynet in https://github.com/zmb3/spotify/pull/252
• Update CI test steps by @strideynet in https://github.com/zmb3/spotify/pull/253
• Update Lint CI action by @strideynet in https://github.com/zmb3/spotify/pull/254
• build(deps): bump google.golang.org/protobuf from 1.27.1 to 1.33.0 by @dependabot in https://github.com/zmb3/spotify/pull/255
• fix: unmarshal numeric fields regardless of them being int or float by @wernerdweight in https://github.com/zmb3/spotify/pull/251
• build(deps): bump golang.org/x/net from 0.17.0 to 0.23.0 by @dependabot in https://github.com/zmb3/spotify/pull/259

New Contributors

• @oifj34f34f made their first contribution in https://github.com/zmb3/spotify/pull/245
• @wernerdweight made their first contribution in https://github.com/zmb3/spotify/pull/251

Full Changelog: https://github.com/zmb3/spotify/compare/v2.4.1...v2.4.2

What's Changed

• Recommendation example by @ahmed-deftoner in https://github.com/zmb3/spotify/pull/223
• add RefreshToken method for Authenticator by @JunNishimura in https://github.com/zmb3/spotify/pull/233
• build(deps): bump golang.org/x/net from 0.7.0 to 0.17.0 by @dependabot in https://github.com/zmb3/spotify/pull/240

New Contributors

• @JunNishimura made their first contribution in https://github.com/zmb3/spotify/pull/233

Full Changelog: https://github.com/zmb3/spotify/compare/v2.4.0...v2.4.1

What's Changed

• Added Album member to SimpleTrack struct by @obrhoff in https://github.com/zmb3/spotify/pull/184
• build(deps): bump golang.org/x/net from 0.0.0-20210813160813-60bc85c4be6d to 0.7.0 by @dependabot in https://github.com/zmb3/spotify/pull/214
• fix: support HTTP status 202 by @rmillet42 in https://github.com/zmb3/spotify/pull/215
• Change incorrect player repeat options by @beatzzz in https://github.com/zmb3/spotify/pull/216
• add features example by @ahmed-deftoner in https://github.com/zmb3/spotify/pull/222
• Make spotify.PlaybackOffset.Position an *int by @aditya-K2 in https://github.com/zmb3/spotify/pull/220
• Add episode endpoint by @coolbaluk in https://github.com/zmb3/spotify/pull/234

New Contributors

• @obrhoff made their first contribution in https://github.com/zmb3/spotify/pull/184
• @dependabot made their first contribution in https://github.com/zmb3/spotify/pull/214
• @rmillet42 made their first contribution in https://github.com/zmb3/spotify/pull/215
• @beatzzz made their first contribution in https://github.com/zmb3/spotify/pull/216
• @ahmed-deftoner made their first contribution in https://github.com/zmb3/spotify/pull/222
• @aditya-K2 made their first contribution in https://github.com/zmb3/spotify/pull/220
• @coolbaluk made their first contribution in https://github.com/zmb3/spotify/pull/234

Full Changelog: https://github.com/zmb3/spotify/compare/v2.3.1...v2.4.0

Breaking Changes

PlaybackOffset.Position has changed from int to *int. This is to account for a behaviour in the Spotify API where the position can be specified separately inside the URI. See https://github.com/zmb3/spotify/pull/220/files for specific details.

What's Changed

• fix: description field in FullPlaylist was shadowing the one from SimplePlaylist by @Sundava in https://github.com/zmb3/spotify/pull/203
• Add SaveShowsForCurrentUser endpoint by @elliotwms in https://github.com/zmb3/spotify/pull/204
• Pass context to modifyLibrary calls by @elliotwms in https://github.com/zmb3/spotify/pull/205
• Allow retry period to be cancelled by context by @rtrox in https://github.com/zmb3/spotify/pull/212
• [Fix #182] Test success before retrying request by @rtrox in https://github.com/zmb3/spotify/pull/213
• Adding "GetQueue" Function to player.go. by @R0qs3T in https://github.com/zmb3/spotify/pull/211
• Added support for the ExternalIDs field on Tracks by @strideynet

New Contributors

• @elliotwms made their first contribution in https://github.com/zmb3/spotify/pull/204
• @rtrox made their first contribution in https://github.com/zmb3/spotify/pull/212
• @R0qs3T made their first contribution in https://github.com/zmb3/spotify/pull/211

Full Changelog: https://github.com/zmb3/spotify/compare/v2.3.0...v2.3.1

This release includes no breaking API changes.

What's Changed

• Add Description field to SimplePlaylist by @Sundava in https://github.com/zmb3/spotify/pull/202
• add shows and episodes in search results by @manland in https://github.com/zmb3/spotify/pull/188

New Contributors

• @Sundava made their first contribution in https://github.com/zmb3/spotify/pull/202
• @manland made their first contribution in https://github.com/zmb3/spotify/pull/188

Full Changelog: https://github.com/zmb3/spotify/compare/v2.2.1...v2.3.0

Fixes GetPlaylistItems to better handle local tracks.

Also includes additional notes in README re: markets, and expands one of the example scripts.

This release includes no breaking API changes. It does however deprecate GetPlaylistTracks in favour of GetPlaylistItems, as per changes to the Spotify API that this endpoint can now return tracks or episodes. Please switch to this new method where possible.

Many thanks to @xonstone for this change.

This release includes no breaking API changes. There is 1 change that users should be aware of, and let me know if they experience any changes in behaviour (https://github.com/zmb3/spotify/pull/179). We no longer override the HTTP client used for oauth, and this means it will now use the default Go HTTP client. If you environment includes variables that control the configuration of this client, you may experience changes in behaviour.

Changes

Revert to default HTTP client for oauth

Originally, Spotify's API did not work properly with HTTP/2, so we overrode the client here to ensure that we would not attempt to use HTTP/2. It appears this is now correctly supported, so this override is redundant.

Many thanks to @StalkR for this change.

https://github.com/zmb3/spotify/pull/179

Introduce a method for getting the current API token

The client now includes a .Token() method for returning the current token being used.

Many thanks to @elivlo for this change.

https://github.com/zmb3/spotify/pull/170

It's been a while since the Library has had a significant overhaul.

V2 brings:

• Support for context.Context across all actions
• Functional options for the creation of the Client
• More modular auth support, allowing users to inject a HTTP client that meets their authentication needs.

Thanks to @samuelrey for this PR :)

Introduces a new method for creating a collaborative playlist.

Support for GetShow and GetShowEpisodes introduced, many thanks to @davidiola

This release contains no breaking changes!

Changes

Change the page implementation to use a pointer receiver for panic safety

Previously, a value receiver was used which allowed developers to pass a value into the NextPage and PreviousPage methods. This would result in a panic due to the underlying implementation relying on reflection. This now is impossible, and code that could cause a panic will now no longer compile.

Many thanks to @klokare for the detail report

This release contains no breaking changes!

Changes

Allow Auth client Exchange() method to take variadic oauth2.AuthCodeOption

So we can set "code_verifier" param url without needing an
HTTP request.

Courtesy of @ialbors