spotify-ruby 0.1.1 → 0.2.1

data/lib/spotify/sdk/connect/playback_state.rb

@@ -0,0 +1,141 @@
+# frozen_string_literal: true
+
+module Spotify
+  class SDK
+    class Connect
+      class PlaybackState < Model
+        ##
+        # Get the device the current playback is on.
+        #
+        # @example
+        #   device = @sdk.connect.devices[0]
+        #   device.playback.device
+        #
+        # @return [Spotify::SDK::Connect::Device] self Return the device object.
+        #
+        def device
+          Spotify::SDK::Connect::Device.new(super, parent)
+        end
+
+        ##
+        # Is the current user playing a track?
+        #
+        # @example
+        #   playback = @sdk.connect.playback
+        #   playback.playing?
+        #
+        # @return [FalseClass,TrueClass] is_playing True if user is currently performing playback.
+        #
+        alias_attribute :playing?, :is_playing
+
+        ##
+        # Is the current playback set to shuffle?
+        #
+        # @example
+        #   playback = @sdk.connect.playback
+        #   playback.shuffling?
+        #
+        # @return [FalseClass,TrueClass] is_shuffling True if shuffle is set.
+        #
+        alias_attribute :shuffling?, :shuffle_state
+
+        ##
+        # What repeat mode is the current playback set to?
+        #
+        # Options:
+        #   :off => This means no repeat is set.
+        #   :context => This means it will repeat within the same context.
+        #   :track => This will repeat the same track.
+        #
+        # @example
+        #   playback = @sdk.connect.playback
+        #   playback.repeat # :off, :context, or :track
+        #
+        # @return [Symbol] repeat_mode Either :off, :context, or :track
+        #
+        def repeat_mode
+          repeat_state.to_sym
+        end
+
+        ##
+        # The current timestamp of the playback state
+        #
+        # @example
+        #   playback = @sdk.connect.playback
+        #   playback.time
+        #
+        # @return [Time] time The accuracy time of the playback state.
+        #
+        def time
+          Time.at(timestamp / 1000)
+        end
+
+        ##
+        # What is the current position of the track?
+        #
+        # @example
+        #   playback = @sdk.connect.playback
+        #   playback.position
+        #
+        # @return [Integer] position_ms In milliseconds, the position of the track.
+        #
+        alias_attribute :position, :progress_ms
+
+        ##
+        # How much percentage of the track is the position currently in?
+        #
+        # @example
+        #   playback = @sdk.connect.playback
+        #   playback.position_percentage # => 7.30
+        #   playback.position_percentage(4) # => 7.3039
+        #
+        # @param [Integer] decimal_points How many decimal points to return
+        # @return [Float] percentage Completion percentage. Rounded to 2 decimal places.
+        #
+        def position_percentage(decimal_points=2)
+          return nil if position.nil?
+          ((position.to_f / item.duration.to_f) * 100).ceil(decimal_points)
+        end
+
+        ##
+        # Get the artists for the currently playing track.
+        #
+        # @example
+        #   @sdk.connect.playback.artists
+        #
+        # @return [Array] artists An array of artists wrapped in Spotify::SDK::Artist
+        #
+        def artists
+          item[:artists].map do |artist|
+            Spotify::SDK::Artist.new(artist, parent)
+          end
+        end
+
+        ##
+        # Get the main artist for the currently playing track.
+        #
+        # @example
+        #   @sdk.connect.playback.artist
+        #
+        # @return [Spotify::SDK::Artist] artist The main artist of the track.
+        #
+        def artist
+          artists.first
+        end
+
+        ##
+        # Get the item for the currently playing track.
+        #
+        # @example
+        #   @sdk.connect.playback.item
+        #
+        # @return [Spotify::SDK::Item] item The currently playing track, wrapped in Spotify::SDK::Item
+        #
+        def item
+          raise "Playback information is not available if user has a private session enabled" if device.private_session?
+          Spotify::SDK::Item.new(super, parent)
+        end
+      end
+    end
+  end
+end

data/lib/spotify/sdk/image.rb

@@ -0,0 +1,44 @@
+# frozen_string_literal: true
+
+module Spotify
+  class SDK
+    class Image < Model
+      ##
+      # Get the ID of the image.
+      #
+      # @example
+      #   artist = @sdk.connect.playback.artist
+      #   artist.images[0].id # => "941223d904f006c4d998598272d43d94"
+      #
+      # @return [String] image_id The image ID generated from Spotify.
+      #
+      def id
+        url.match(/[a-z0-9]+$/i)[0]
+      end
+
+      ##
+      # Get the mobile-related link for the image. Designed for offline mobile apps.
+      #
+      # @example
+      #   artist = @sdk.connect.playback.artist
+      #   artist.images[0].spotify_uri # => "spoitfy:image:..."
+      #
+      # @return [String] spotify_uri The mobile-embeddable image for the item.
+      #
+      def spotify_uri
+        "spotify:image:%s" % id
+      end
+
+      ##
+      # Get the HTTP link for the image. Designed for web apps.
+      #
+      # @example
+      #   artist = @sdk.connect.playback.artist
+      #   artist.images[0].spotify_url # => "https://i.scdn.co/image/..."
+      #
+      # @return [String] spotify_url The web-embeddable HTTP image for the item.
+      #
+      alias_attribute :spotify_url, :url
+    end
+  end
+end

data/lib/spotify/sdk/item.rb

@@ -0,0 +1,134 @@
+# frozen_string_literal: true
+
+module Spotify
+  class SDK
+    class Item < Model
+      ##
+      # Get the album for this item.
+      #
+      # @example
+      #   @sdk.connect.playback.item.album
+      #
+      # @return [Spotify::SDK::Album] album The album object, wrapped in Spotify::SDK::Album
+      #
+      def album
+        Spotify::SDK::Album.new(super, parent)
+      end
+
+      ##
+      # Get the artists/creators for this item.
+      #
+      # @example
+      #   @sdk.connect.playback.item.artists
+      #
+      # @return [Array] artists A list of artists, wrapped in Spotify::SDK::Artist
+      #
+      def artists
+        super.map do |artist|
+          Spotify::SDK::Artist.new(artist, parent)
+        end
+      end
+
+      ##
+      # Get the primary artist/creator for this item.
+      #
+      # @example
+      #   @sdk.connect.playback.item.artist
+      #
+      # @return [Spotify::SDK::Artist] artist The primary artist, wrapped in Spotify::SDK::Artist
+      #
+      def artist
+        artists.first
+      end
+
+      ##
+      # Get the duration.
+      # Alias to self.duration_ms
+      #
+      # @example
+      #   @sdk.connect.playback.item.duration # => 10331
+      #
+      # @return [Integer] duration_ms In milliseconds, how long the item is.
+      #
+      alias_attribute :duration, :duration_ms
+
+      ##
+      # Is this track explicit?
+      # Alias to self.explicit
+      #
+      # @example
+      #   @sdk.connect.playback.item.explicit? # => true
+      #
+      # @return [TrueClass,FalseClass] is_explicit Returns true if item contains explicit content.
+      #
+      alias_attribute :explicit?, :explicit
+
+      ##
+      # Is this a local track, not a Spotify track?
+      # Alias to self.is_local
+      #
+      # @example
+      #   @sdk.connect.playback.item.local? # => false
+      #
+      # @return [TrueClass,FalseClass] is_local Returns true if item is local to the user.
+      #
+      alias_attribute :local?, :is_local
+
+      ##
+      # Is this a playable track?
+      # Alias to self.is_playable
+      #
+      # @example
+      #   @sdk.connect.playback.item.playable? # => false
+      #
+      # @return [TrueClass,FalseClass] is_playable Returns true if item is playable.
+      #
+      alias_attribute :playable?, :is_playable
+
+      ##
+      # Is this a track?
+      # Alias to self.type == "track"
+      #
+      # @example
+      #   @sdk.connect.playback.item.track? # => true
+      #
+      # @return [TrueClass,FalseClass] is_track Returns true if item is an music track.
+      #
+      def track?
+        type == "track"
+      end
+
+      ##
+      # Get the Spotify URI for this item.
+      # Alias to self.uri
+      #
+      # @example
+      #   @sdk.connect.playback.item.spotify_uri # => "spotify:track:..."
+      #
+      # @return [String] spotify_uri The direct URI to this Spotify resource.
+      #
+      alias_attribute :spotify_uri, :uri
+
+      ##
+      # Get the Spotify HTTP URL for this item.
+      # Alias to self.external_urls[:spotify]
+      #
+      # @example
+      #   @sdk.connect.playback.item.spotify_url # => "https://open.spotify.com/..."
+      #
+      # @return [String] spotify_url The direct HTTP URL to this Spotify resource.
+      #
+      alias_attribute :spotify_url, "external_urls.spotify"
+
+      ##
+      # Get the ISRC for this track.
+      #
+      # @example
+      #   @sdk.connect.playback.item.isrc # => "USUM00000000"
+      #
+      # @return [String] isrc The ISRC string for this track.
+      #
+      alias_attribute :isrc, "external_ids.isrc"
+    end
+  end
+end

data/lib/spotify/sdk/me.rb

@@ -0,0 +1,83 @@
+# frozen_string_literal: true
+
+module Spotify
+  class SDK
+    class Me < Base
+      ##
+      # Get the current user's information.
+      # Respective information requires the `user-read-private user-read-email user-read-birthdate` scopes.
+      # GET /v1/me
+      #
+      # @example
+      #   me = @sdk.me.info
+      #
+      # @see https://developer.spotify.com/console/get-current-user/
+      # @see https://developer.spotify.com/documentation/web-api/reference/users-profile/get-current-users-profile/
+      #
+      # @param [Hash] override_opts Custom options for HTTParty.
+      # @return [Spotify::SDK::Me::Info] user_info Return the user's information.
+      #
+      def info(override_opts={})
+        me_info = send_http_request(:get, "/v1/me", override_opts)
+        Spotify::SDK::Me::Info.new(me_info, self)
+      end
+
+      ##
+      # Check if the current user is following N users.
+      #
+      def following?(list, type=:artist, override_opts={})
+        raise "Must contain an array" unless list.is_a?(Array)
+        raise "Must contain an array of String or Spotify::SDK::Artist" if any_of?(list, [String, Spotify::SDK::Artist])
+        raise "type must be either 'artist' or 'user'" unless %i[artist user].include?(type)
+        send_is_following_http_requests(list.map {|id| id.try(:id) || id }, type, override_opts)
+      end
+
+      ##
+      # Get the current user's followed artists. Requires the `user-read-follow` scope.
+      # GET /v1/me/following
+      #
+      # @example
+      #   @sdk.me.following
+      #
+      # @param [Hash] override_opts Custom options for HTTParty.
+      # @return [Array] artists A list of followed artists, wrapped in Spotify::SDK::Artist
+      #
+      def following(override_opts={})
+        artists = send_following_http_requests("/v1/me/following?type=artist&limit=50", override_opts)
+        artists.map do |artist|
+          Spotify::SDK::Artist.new(artist, self)
+        end
+      end
+
+      private
+
+      def any_of?(array, klasses)
+        (array.map(&:class) - klasses).any?
+      end
+
+      def send_is_following_http_requests(list, type, override_opts) # :nodoc:
+        max_ids = list.first(50)
+        remaining_ids = list - max_ids
+
+        ids = max_ids.map {|id| {id.strip => nil} }.inject(&:merge)
+        following = send_http_request(
+          :get,
+          "/v1/me/following/contains?type=%s&ids=%s" % [type, ids.keys.join(",")],
+          override_opts
+        )
+        ids.each_key {|id| ids[id] = following.shift }
+
+        if remaining_ids.any?
+          ids.merge(send_is_following_http_requests(remaining_ids, type, override_opts))
+        end || ids
+      end
+
+      def send_following_http_requests(http_path, override_opts) # :nodoc:
+        request = send_http_request(:get, http_path, override_opts)[:artists]
+        artists = request[:items]
+        artists << send_following_http_requests(request[:next][23..-1], override_opts) if request[:next]
+        artists.flatten
+      end
+    end
+  end
+end

data/lib/spotify/sdk/me/info.rb

@@ -0,0 +1,108 @@
+# frozen_string_literal: true
+
+module Spotify
+  class SDK
+    class Me
+      class Info < Model
+        ##
+        # Is the user currently on Spotify Free?
+        #
+        # @example
+        #   @sdk.me.info.free?
+        #
+        # @return [TrueClass,FalseClass] is_free Return true if user is on Spotify Free.
+        #
+        def free?
+          product == "free"
+        end
+
+        ##
+        # Is the user currently on Spotify Premium?
+        #
+        # @example
+        #   @sdk.me.info.premium?
+        #
+        # @return [TrueClass,FalseClass] is_premium Return true if user is on Spotify Premium.
+        #
+        def premium?
+          product == "premium"
+        end
+
+        ##
+        # Get the user's birthdate.
+        # Requires the `user-read-birthdate` scope, otherwise it will return nil.
+        #
+        # @example
+        #   @sdk.me.info.birthdate # => Wed, 10 May 1985
+        #
+        # @return [Date,NilClass] birthdate Return the user's birthdate, otherwise return nil.
+        #
+        def birthdate
+          Date.parse(super) if super
+        end
+
+        ##
+        # Does the user have a valid display_name?
+        #
+        # @example
+        #   @sdk.me.info.display_name? # => false
+        #
+        # @return [TrueClass,FalseClass] has_display_name Return true if the user has a non-empty display name.
+        #
+        def display_name?
+          !display_name.to_s.empty?
+        end
+
+        ##
+        # Get the images for the user.
+        #
+        # @example
+        #   @sdk.me.info.images[0].spotify_uri # => "spotify:image:..."
+        #   @sdk.me.info.images[0].spotify_url # => "https://profile-images.scdn.co/..."
+        #
+        # @return [Array] images A list of all user photos wrapped in Spotify::SDK::Image
+        #
+        def images
+          super.map do |image|
+            Spotify::SDK::Image.new(image, parent)
+          end
+        end
+
+        ##
+        # Return the followers on Spotify for this user.
+        #
+        # @example
+        #   me = @sdk.me.info
+        #   me.followers # => 13913
+        #
+        # @return [Integer] followers The number of users following this user.
+        #
+        def followers
+          super[:total]
+        end
+
+        ##
+        # Get the Spotify URI for this user.
+        # Alias to self.uri
+        #
+        # @example
+        #   @sdk.me.info.spotify_uri # => "spotify:user:..."
+        #
+        # @return [String] spotify_uri The direct URI to this Spotify resource.
+        #
+        alias_attribute :spotify_uri, :uri
+
+        ##
+        # Get the Spotify HTTP URL for this user.
+        # Alias to self.external_urls[:spotify]
+        #
+        # @example
+        #   @sdk.me.info.spotify_url # => "https://open.spotify.com/..."
+        #
+        # @return [String] spotify_url The direct HTTP URL to this Spotify resource.
+        #
+        alias_attribute :spotify_url, "external_urls.spotify"
+      end
+    end
+  end
+end