rspotify 1.4.0 → 1.5.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: 5d9e31b9626c059235d8ae9a280d2aeda3401bdb
-  data.tar.gz: d31cd52b6f9f42267a7eeac70a166f3386bb8cf5
+  metadata.gz: 915098c8b8896573470f1b8eeaccafc685352674
+  data.tar.gz: 666dddc4c95848340a2e0f1b0f4425c2e74c8bcc
 SHA512:
-  metadata.gz: 9e27b5891b2c93c8bd0a0d291372eb563e765020adfb4cd3de1da96525b835a99830fef3020706a6de841e33767880bcd06f8c4a6d91734085740667e77ebcdb
-  data.tar.gz: e5f1595da9fef102f1ccd0047336f23435d59bc3a510e689c1d38b781c8dd0336d3228ad23e210cd18f3f95b885db8948d4b26a958d8b7c524a21e618b4fd697
+  metadata.gz: c829c3d977cc9aa8dc2b9c1d4f2aaaa45626f425729b9135fac31c118c464d48ccabcc5ec7c5a74987237e46ec9e792b2f4b61f140955e1fa5848d510337d94b
+  data.tar.gz: ee4fcd289269c373f3a7e76dbc960818e75b3b7bd227b2918aeed9ee64bc0850f7fb16fb6d52c2c99aa817e4abfec8d34dda964233bbb0014cf7e0eb9c9b26e1

data/lib/rspotify/artist.rb

@@ -57,8 +57,8 @@ module RSpotify
     #
     # @param limit      [Integer] Maximum number of albums to return. Maximum: 50. 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.
-    # @param album_type [String]  A comma-separated list of keywords that will be used to filter the response. If not supplied, all album types will be returned. Valid values are: album; single; appears_on; compilation.
-    # @param market     [String]  (synonym: country). An {http://en.wikipedia.org/wiki/ISO_3166-1_alpha-2 ISO 3166-1 alpha-2 country code}. Supply this parameter to limit the response to one particular geographical market. If not supplied, results will be returned for all markets. Note if you do not provide this field, you are likely to get duplicate results per album, one for each market in which the album is available.
+    # @param album_type [String]  Optional. A comma-separated list of keywords that will be used to filter the response. If not supplied, all album types will be returned. Valid values are: album; single; appears_on; compilation.
+    # @param market     [String]  Optional. (synonym: country). An {http://en.wikipedia.org/wiki/ISO_3166-1_alpha-2 ISO 3166-1 alpha-2 country code}. Supply this parameter to limit the response to one particular geographical market. If not supplied, results will be returned for all markets. Note if you do not provide this field, you are likely to get duplicate results per album, one for each market in which the album is available.
     # @return [Array<Album>]
     #
     # @example

data/lib/rspotify/playlist.rb

@@ -72,10 +72,34 @@ module RSpotify
       url << "&position=#{position}" if position
       
       User.oauth_post(@owner.id, url, {})
-      @tracks = nil
+      @tracks_cache = nil
       tracks
     end
 
+    # Change name and public/private state of playlist in user's Spotify account. Changing a public playlist
+    # requires the *playlist-modify* scope; changing a private playlist requires the *playlist-modify-private* scope.
+    # 
+    # @param name   [String]  Optional. The new name for the playlist.
+    # @param public [Boolean] Optional. If true the playlist will be public, if false it will be private.
+    # @return [Playlist]
+    #
+    # @example
+    #           playlist.name   #=> "Movie Soundtrack Masterpieces"
+    #           playlist.public #=> true
+    #
+    #           playlist.change_details!(name: 'Movie Tracks', public: false)
+    #
+    #           playlist.name   #=> "Movie Tracks"
+    #           playlist.public #=> false
+    def change_details!(**data)
+      url = "users/#{@owner.id}/playlists/#{@id}"
+      User.oauth_put(@owner.id, url, data.to_json)
+      data.each do |field, value|
+        instance_variable_set("@#{field}", value)
+      end
+      self
+    end
+
     # When an object is obtained undirectly, Spotify usually returns a simplified version of it.
     # This method updates it into a full object, with all attributes filled.
     # 
@@ -120,11 +144,33 @@ module RSpotify
         RSpotify.auth_get(url)
       end
 
-      tracks = json['items'].map { |i| Track.new i['track'] }
+      tracks = json['items'].map do |i|
+        Track.new i['track'] unless i['track'].nil?
+      end.compact
+
       @tracks_cache = tracks if limit == 100 && offset == 0
       tracks
     end
 
+    # Replace all the tracks in a playlist, overwriting its existing tracks. Changing a public playlist
+    # requires the *playlist-modify* scope; changing a private playlist requires the *playlist-modify-private* scope.
+    # 
+    # @param tracks [Array<Track>] The tracks that will replace the existing ones. Maximum: 100 per request
+    # @return [Array<Track>] The tracks that were added.
+    #
+    # @example
+    #           playlist.tracks.map(&:name) #=> ["All of Me", "Wasted Love", "Love Runs Out"]
+    #           tracks = RSpotify::Track.search('Know', limit: 2)
+    #           playlist.replace_tracks!(tracks)
+    #           playlist.tracks.map(&:name) #=> ["Somebody That I Used To Know", "Do I Wanna Know?"]
+    def replace_tracks!(tracks)
+      track_uris = tracks.map(&:uri).join(',')
+      url = "users/#{@owner.id}/playlists/#{@id}/tracks?uris=#{track_uris}"
+      User.oauth_put(@owner.id, url, {})
+      @tracks_cache = nil
+      tracks
+    end
+
     private
 
     def users_credentials

data/lib/rspotify/user.rb

@@ -99,7 +99,7 @@ module RSpotify
     #           playlist.public #=> false
     def create_playlist!(name, public: true)
       url = "users/#{@id}/playlists"
-      request_data = %Q({"name":"#{name}", "public":#{public}})
+      request_data = { name: name, public: public }.to_json
       Playlist.new User.oauth_post(@id, url, request_data)
     end
 

data/lib/rspotify/version.rb

@@ -1,3 +1,3 @@
 module RSpotify
-  VERSION = '1.4.0'
+  VERSION = '1.5.0'
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: rspotify
 version: !ruby/object:Gem::Version
-  version: 1.4.0
+  version: 1.5.0
 platform: ruby
 authors:
 - Guilherme Sad
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2014-10-10 00:00:00.000000000 Z
+date: 2014-10-16 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: omniauth-oauth2