rspotify 1.15.5 → 1.16.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: a93128fa50a4191e8d52b20c6cb567cdbe4215a0
-  data.tar.gz: e8add7787638abd2258e878402ec5570026c9a62
+  metadata.gz: 8a88de811476fbb0042abe48a1a7ff99ed6d3e30
+  data.tar.gz: e1f261ed242e3a7abc2cf0f5b1aae6c05495f04e
 SHA512:
-  metadata.gz: d9db6786d6234198aba5c14416a18e08c187d70033ae0a99b18daae560d51aac91a59a8309fc352788d560f746094922c58c92c61443944e9a62c850092f90bd
-  data.tar.gz: 51e330b4b6ea9858c29e0c1dd4b395e634f8ff9560a2b0d7d2edd5c529924ad75202f0442bb7c4a782bc78f36ac4cc29f1125c6acb7b67e862d45d20bb1e0586
+  metadata.gz: 58a7634fff6edcbe1d5b9f73c9c5723f49d3c446b16bff93a4e93dbe3e98bf8dd422e77ef671cbe797ae54913a05d15142e994d09d7eef71d88e79509006dd4f
+  data.tar.gz: 24200d848d08744d17002d3215ca67d2efa6c54cefd708bdad33ac3ffef98476ac769315555c239249a02436d402fad8d2c871aa10d8cd7b0959812ac732851c

data/README.md

@@ -186,6 +186,11 @@ class UsersController < ApplicationController
     spotify_user.saved_tracks.size #=> 20
     spotify_user.remove_tracks!(tracks)
 
+    albums = RSpotify::Album.search('launeddas')
+    spotify_user.save_albums!(albums)
+    spotify_user.saved_albums.size #=> 10
+    spotify_user.remove_albums!(albums)
+
     # Use Spotify Follow features
     spotify_user.follow(playlist)
     spotify_user.follows?(artists)

data/lib/rspotify/user.rb

@@ -286,6 +286,78 @@ module RSpotify
       User.oauth_get(@id, url)
     end
 
+    # Remove albums from the user’s “Your Music” library.
+    #
+    # @param albums [Array<Album>] The albums to remove. Maximum: 50.
+    # @return [Array<Album>] The albums removed.
+    #
+    # @example
+    #           albums = user.saved_albums
+    #
+    #           user.saved_albums.size #=> 20
+    #           user.remove_albums!(albums)
+    #           user.saved_albums.size #=> 0
+    def remove_albums!(albums)
+      albums_ids = albums.map(&:id)
+      url = "me/albums?ids=#{albums_ids.join ','}"
+      User.oauth_delete(@id, url)
+      albums
+    end
+
+    # Save albums to the user’s “Your Music” library.
+    #
+    # @param albums [Array<Album>] The albums to save. Maximum: 50.
+    # @return [Array<Album>] The albums saved.
+    #
+    # @example
+    #           albums = RSpotify::Album.search('launeddas')
+    #
+    #           user.saved_albums.size #=> 0
+    #           user.save_albums!(albums)
+    #           user.saved_albums.size #=> 10
+    def save_albums!(albums)
+      albums_ids = albums.map(&:id)
+      url = "me/albums"
+      request_body = albums_ids.inspect
+      User.oauth_put(@id, url, request_body)
+      albums
+    end
+
+    # Returns the albums saved in the Spotify user’s “Your Music” library. ** Includes albums whose tracks you saved
+    #
+    # @param limit  [Integer] Maximum number of albums to return. Maximum: 50. Minimum: 1. Default: 20.
+    # @param offset [Integer] The index of the first album to return. Use with limit to get the next set of albums. Default: 0.
+    # @return [Array<Album>]
+    #
+    # @example
+    #           albums = user.saved_albums
+    #           albums.size       #=> 20
+    #           albums.first.name #=> "Launeddas"
+    def saved_albums(limit: 20, offset: 0)
+      url = "me/albums?limit=#{limit}&offset=#{offset}"
+      response = User.oauth_get(@id, url)
+      json = RSpotify.raw_response ? JSON.parse(response) : response
+
+      albums = json['items'].select { |i| i['album'] }
+
+      return response if RSpotify.raw_response
+      albums.map { |a| Album.new a['album'] }
+    end
+
+    # Check if albums are already saved in the Spotify user’s “Your Music” library. ** Only returns true if the album was saved via me/albums, not if you saved each track individually.
+    #
+    # @param albums [Array<Album>] The albums to check. Maximum: 50.
+    # @return [Array<Boolean>] Array of booleans, in the same order in which the albums were specified.
+    #
+    # @example
+    #           albums = RSpotify::Album.search('launeddas')
+    #           user.saved_albums?(albums) #=> [true, false, true...]
+    def saved_albums?(albums)
+      albums_ids = albums.map(&:id)
+      url = "me/albums/contains?ids=#{albums_ids.join ','}"
+      User.oauth_get(@id, url)
+    end
+
     # Returns a hash containing all user attributes
     def to_hash
       pairs = instance_variables.map do |var|

data/lib/rspotify/version.rb

@@ -1,3 +1,3 @@
 module RSpotify
-  VERSION = '1.15.5'
+  VERSION = '1.16.0'
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: rspotify
 version: !ruby/object:Gem::Version
-  version: 1.15.5
+  version: 1.16.0
 platform: ruby
 authors:
 - Guilherme Sad
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2015-11-08 00:00:00.000000000 Z
+date: 2015-11-22 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: omniauth-oauth2