Class: RSpotify::Base

Inherits:
Object
  • Object
show all
Defined in:
lib/rspotify/base.rb

Direct Known Subclasses

Album, Artist, Playlist, Track, User

Instance Attribute Summary collapse

Class Method Summary collapse

Instance Method Summary collapse

Constructor Details

#initialize(options = {}) ⇒ Base

Returns a new instance of Base.



91
92
93
94
95
96
97
 
# File 'lib/rspotify/base.rb', line 91

def initialize(options = {})
  @external_urls = options['external_urls']
  @href          = options['href']
  @id            = options['id']
  @type          = options['type']
  @uri           = options['uri']
end

Dynamic Method Handling

This class handles dynamic methods through the method_missing method

#method_missing(method_name, *args) ⇒ Object

Used internally to retrieve an object’s instance variable. If instance variable equals nil, calls #complete! on object and retrieve it again.

Examples:

user.id #=> "wizzler"

track = artist.tracks.first
track.instance_variable_get("@popularity") #=> nil
track.popularity #=> 62
track.instance_variable_get("@popularity") #=> 62


123
124
125
126
127
128
129
130
131
132
 
# File 'lib/rspotify/base.rb', line 123

def method_missing(method_name, *args)
  attr = "@#{method_name}"
  super unless instance_variable_defined? attr

  attr_value = instance_variable_get attr
  return attr_value if !attr_value.nil? || @id.nil?

  complete!
  instance_variable_get attr
end

Instance Attribute Details

#external_urls ⇒ Hash

Known external URLs for object

Returns:

  • (Hash) —

    the current value of external_urls



8
9
10
 
# File 'lib/rspotify/base.rb', line 8

def external_urls
  @external_urls
end

#href ⇒ String

A link to the Web API endpoint

Returns:

  • (String) —

    the current value of href



8
9
10
 
# File 'lib/rspotify/base.rb', line 8

def href
  @href
end

#id ⇒ String

The Spotify ID for the object

Returns:

  • (String) —

    the current value of id



8
9
10
 
# File 'lib/rspotify/base.rb', line 8

def id
  @id
end

#type ⇒ String

The object type (artist, album, etc.)

Returns:

  • (String) —

    the current value of type



8
9
10
 
# File 'lib/rspotify/base.rb', line 8

def type
  @type
end

#uri ⇒ String

The Spotify URI for the object

Returns:

  • (String) —

    the current value of uri



8
9
10
 
# File 'lib/rspotify/base.rb', line 8

def uri
  @uri
end

Class Method Details

.find(ids, type) ⇒ Album, ...

Returns RSpotify object(s) with id(s) and type provided

Examples:

user = RSpotify::Base.find('wizzler', 'user')
user.class #=> RSpotify::User
user.id    #=> "wizzler"

ids = %w(2UzMpPKPhbcC8RbsmuURAZ 7Jzsc04YpkRwB1zeyM39wE)
tracks = RSpotify::Base.find(ids, 'track')
tracks.class       #=> Array
tracks.first.class #=> RSpotify::Track

Parameters:

  • ids (String, Array)
  • type (String)

Returns:



25
26
27
28
29
30
31
32
33
34
35
36
37
38
 
# File 'lib/rspotify/base.rb', line 25

def self.find(ids, type)
  case ids
  when Array
    if type == 'user'
      warn 'Spotify API does not support finding several users simultaneously'
      return false
    end
    limit = (type == 'album' ? 20 : 50)
    find_many(ids, type)
  when String
    id = ids
    find_one(id, type)
  end
end

.search(query, types, limit: 20, offset: 0, market: nil) ⇒ Array<Album>, ...

Returns array of RSpotify objects matching the query, ordered by popularity

Examples:

artists = RSpotify::Base.search('Arctic', 'artist')
albums  = RSpotify::Base.search('AM', 'album', limit: 10, market: 'US')
mixed   = RSpotify::Base.search('Arctic', 'artist, album, track')
albums  = RSpotify::Base.search('AM', 'album', market: { from: user })

Parameters:

  • query (String) —

    The search query’s keywords. For details access here and look for the q parameter description.

  • types (String) —

    Valid types are: album, artist, track and playlist. Separate multiple types with commas.

  • limit (Integer) (defaults to: 20) —

    Maximum number of objects to return. Maximum: 50. Default: 20.

  • offset (Integer) (defaults to: 0) —

    The index of the first object to return. Use with limit to get the next set of objects. Default: 0.

  • market (String, Hash) (defaults to: nil) —

    Optional. An ISO 3166-1 alpha-2 country code or the hash { from: user }, where user is a RSpotify user authenticated using OAuth with scope user-read-private. This will take the user’s country as the market value. (Playlist results are not affected by the market parameter.) For details access here and look for the market parameter description.

Returns:



70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
 
# File 'lib/rspotify/base.rb', line 70

def self.search(query, types, limit: 20, offset: 0, market: nil)
  query = URI::encode query
  types.gsub!(/\s+/, '')

  url = "search?q=#{query}&type=#{types}"\
        "&limit=#{limit}&offset=#{offset}"

  json = if market.is_a? Hash
    url << '&market=from_token'
    User.oauth_get(market[:from].id, url)
  else
    url << "&market=#{market}" if market
    RSpotify.get(url)
  end

  types.split(',').flat_map do |type|
    type_class = RSpotify.const_get(type.capitalize)
    json["#{type}s"]['items'].map { |i| type_class.new i }
  end
end

Instance Method Details

#complete! ⇒ Object

Note:

It is seldom necessary to use this method explicitly, since RSpotify takes care of it automatically when needed (see #method_missing)

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.

Examples:

track = artist.tracks.first
track.instance_variable_get("@popularity") #=> nil
track.complete!
track.instance_variable_get("@popularity") #=> 62


109
110
111
 
# File 'lib/rspotify/base.rb', line 109

def complete!
  initialize RSpotify.get("#{type}s/#{@id}")
end

#respond_to?(method_name, include_private_methods = false) ⇒ Boolean

Overrides Object#respond_to? to also consider methods dynamically generated by #method_missing

Returns:

  • (Boolean) 


135
136
137
138
139
 
# File 'lib/rspotify/base.rb', line 135

def respond_to?(method_name, include_private_methods = false)
  attr = "@#{method_name}"
  return true if instance_variable_defined? attr
  super
end