rspotify 2.10.1 → 2.11.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: d19f6d23158c4ece9b8ede71d1b0ed2ed71598baad04895b62dc209f0147f556
-  data.tar.gz: 0c3b328c9b8f3ff4d87041c0d749fef09689bf922b4f7f4c9f5aa958a2d27587
+  metadata.gz: 0d9d7a49993e755934d77091d568c04862f676c0b52ffe14ab80355cf38c17c1
+  data.tar.gz: 13d0709271280fb895df8f8941915a3090e426d020013552fb0af50656e21f3d
 SHA512:
-  metadata.gz: 636252d2d8d95caf3f8b07187b97fcefe22f6e6a052400d48ab200c2db47451934e37e7c4b25aa08bfddf1c0c1daf6b61fc7b0f2af19e54f25edcc0836da8731
-  data.tar.gz: fed825f00b36af6c3c9e2df6a6312b09219ea6d68b8136085b13ddcfa0764b747b1489a7afb1d73236a769f2fe1571617c49d709e199f7e58f1990a9bb4272e9
+  metadata.gz: def7d61e7f73af6ff9f03bdfbe562c21b462a6820778d76437a6c660bbeb3d3e4f23f11e6ab6c349abb8458da6ad769545e2edc0de3caf563c653ff069c14ee0
+  data.tar.gz: d79c15a25e18878e3a27cba75e0e41a7fab88ecd430e25ae9183c97a88a6d6ff46d9001326d848fe16ed77094a7e8e4a680dd1e0ace6b6271684b728131fc4c4

data/.gitignore

@@ -1,4 +1,6 @@
 .bundle
+.idea
+.rakeTasks
 .yardoc
 doc
 pkg

data/README.md

@@ -155,7 +155,7 @@ Rails.application.config.middleware.use OmniAuth::Builder do
 end
 ```
 
-You should replace the scope values for the ones your own app will require from the user. You can see the list of available scopes in [here](https://developer.spotify.com/web-api/using-scopes).
+You should replace the scope values for the ones your own app will require from the user. You can see the list of available scopes in [here](https://developer.spotify.com/documentation/general/guides/authorization/scopes/).
 
 Next, make a link so the user can log in with his Spotify account:
 

data/lib/rspotify/episode.rb

@@ -0,0 +1,84 @@
+module RSpotify
+
+  # @attr [String]        audio_preview_url    A URL to a 30 second preview (MP3 format) of the episode. null if not available.
+  # @attr [String]        description          A description of the episode. HTML tags are stripped away from this field, use html_description field in case HTML tags are needed.
+  # @attr [Integer]       duration_ms          The episode length in milliseconds.
+  # @attr [Boolean]       explicit             Whether or not the episode has explicit content (true = yes it does; false = no it does not OR unknown).
+  # @attr [String]        href                 A link to the Web API endpoint providing full details of the episode.  
+  # @attr [String]        html_description     A description of the episode. This field may contain HTML tags.  
+  # @attr [Array<Hash>]   images               The cover art for the episode in various sizes, widest first.
+  # @attr [Boolean]       is_externally_hosted True if the episode is hosted outside of Spotify’s CDN.
+  # @attr [Boolean]       is_playable          True if the episode is playable in the given market. Otherwise false.
+  # @attr [String]        language             The language used in the episode, identified by a ISO 639 code. This field is deprecated and might be removed in the future. Please use the languages field instead.
+  # @attr [Array<String>] languages            A list of the languages used in the episode, identified by their ISO 639-1 code.
+  # @attr [String]        name                 The name of the episode.
+  # @attr [String]        release_date         The date the episode was first released, for example "1981-12-15". Depending on the precision, it might be shown as "1981" or "1981-12".
+  # @attr [String]        release_date_precision         The precision with which release_date value is known.
+  # @attr [Hash]          restrictions         Included in the response when a content restriction is applied.
+  # @attr [Hash]          resume_point         The user’s most recent position in the episode. Set if the supplied access token is a user token and has the scope ‘user-read-playback-position’.
+  class Episode < Base
+
+    # Returns Episode object(s) with id(s) provided
+    #
+    # @param ids [String, Array] Maximum: 50 IDs
+    # @param market [String] Optional. An {http://en.wikipedia.org/wiki/ISO_3166-1_alpha-2 ISO 3166-1 alpha-2 country code}.
+    # @return [Episode, Array<Episode>]
+    #
+    # @example
+    #           episode = RSpotify::Episode.find('512ojhOuo1ktJprKbVcKyQ')
+    #           episode.class #=> RSpotify::Episode
+    #           episode.name  #=> "Do I Wanna Know?"
+    #           
+    #           ids = %w(512ojhOuo1ktJprKbVcKyQ 15tHEpY9pwbKC0QjpYCRB1)
+    #           episodes = RSpotify::Base.find(ids, 'episode')
+    #           episodes.class       #=> Array
+    #           episodes.first.class #=> RSpotify::Episode
+    def self.find(ids, market: nil)
+      super(ids, 'episode', market: market)
+    end
+
+    # Returns array of Episode objects matching the query. It's also possible to find the total number of search results for the query
+    #
+    # @param query  [String]       The search query's keywords. For details access {https://developer.spotify.com/web-api/search-item here} and look for the q parameter description.
+    # @param limit  [Integer]      Maximum number of episodes to return. Maximum: 50. Default: 20.
+    # @param offset [Integer]      The index of the first episode to return. Use with limit to get the next set of episodes. Default: 0.
+    # @param market [String, Hash] Optional. An {http://en.wikipedia.org/wiki/ISO_3166-1_alpha-2 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. For details access {https://developer.spotify.com/web-api/search-item here} and look for the market parameter description.
+    # @return [Array<Episode>]
+    #
+    # @example
+    #           episodes = RSpotify::Episode.search('Vetenskapsradion Historia')
+    #           episodes = RSpotify::Episode.search('Vetenskapsradion Historia', limit: 10, market: 'US')
+    #           episodes = RSpotify::Episode.search('Vetenskapsradion Historia', market: { from: user })
+    #
+    #           RSpotify::Episode.search('Vetenskapsradion Historia').total #=> 711
+    def self.search(query, limit: 20, offset: 0, market: nil )
+      super(query, 'episode', limit: limit, offset: offset, market: market)
+    end
+
+    def initialize(options = {})
+      @audio_preview_url = options['audio_preview_url']
+      @description       = options['description']
+      @duration_ms       = options['duration_ms']
+      @explicit          = options['explicit']
+      @href              = options['href']
+      @html_description  = options['html_description']
+      @images            = options['images']
+      @is_externally_hosted = options['is_externally_hosted']
+      @is_playable       = options['is_playable']
+      @language          = options['language']
+      @languages         = options['languages']
+      @name              = options['name']
+      @release_date      = options['release_date']
+      @release_date_precision = options['release_date_precision']
+      @restrictions      = options['restrictions'] || {}
+      @resume_point      = options['resume_point'] || {}
+      @uri               = options['uri']
+
+      @show = if options['show']
+        Show.new options['show']
+      end
+
+      super(options)
+    end
+  end
+end

data/lib/rspotify/oauth.rb

@@ -18,6 +18,11 @@ module OmniAuth
       def raw_info
         @raw_info ||= access_token.get('me').parsed
       end
+      
+      # Fix for: https://github.com/guilhermesad/rspotify/issues/189
+      def callback_url
+        full_host + script_name + callback_path
+      end
     end
   end
 end

data/lib/rspotify/playlist.rb

@@ -315,7 +315,7 @@ module RSpotify
 
       params = {
         method: :delete,
-        url: URI::encode(RSpotify::API_URI + @path + '/tracks'),
+        url: Addressable::URI.encode(RSpotify::API_URI + @path + '/tracks'),
         headers: User.send(:oauth_header, @owner.id),
         payload: positions ? { positions: positions } : { tracks: tracks }
       }

data/lib/rspotify/show.rb

@@ -0,0 +1,100 @@
+module RSpotify
+
+  # @attr [Array<String>] available_markets   A list of the countries in which the show can be played, identified by their ISO 3166-1 alpha-2 code.
+  # @attr [Array<Hash>]   copyrights          The copyright statements of the show.
+  # @attr [String]        description         A description of the show. HTML tags are stripped away from this field, use html_description field in case HTML tags are needed.
+  # @attr [Boolean]       explicit            Whether or not the show has explicit content (true = yes it does; false = no it does not OR unknown).
+  # @attr [String]        html_description    A description of the show. This field may contain HTML tags.
+  # @attr [Array<Hash>]   images              The cover art for the show in various sizes, widest first.
+  # @attr [Boolean]       is_externally_hosted    True if all of the show’s episodes are hosted outside of Spotify’s CDN. This field might be null in some cases.
+  # @attr [Array<String>] languages           A list of the languages used in the show, identified by their ISO 639 code.
+  # @attr [String]        media_type          The media type of the show.
+  # @attr [String]        name                The name of the show.
+  # @attr [String]        publisher           The publisher of the show.
+class Show < Base
+
+    # Returns Show object(s) with id(s) provided
+    #
+    # @param id [String, Array] Maximum: 50 IDs
+    # @param market [String] An {https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2 ISO 3166-1 alpha-2 country code}.
+    # @return [Show, Array<Show>]
+    #
+    # @example
+    #           show = RSpotify::Show.find('3Z6JdCS2d0eFEpXHKI6WqH')
+    #           show.class #=> RSpotify::Show
+    #           show.name  #=> "Consider This from NPR"
+    def self.find(ids, market: nil )
+      super(ids, 'show', market: market)
+    end
+    
+    # Returns array of Show objects matching the query. It's also possible to find the total number of search results for the query
+    #
+    # @param query  [String]  The search query's keywords. See the q description in {https://developer.spotify.com/web-api/search-item here} for details.
+    # @param limit  [Integer] Maximum number of shows to return. Maximum: 50. Default: 20.
+    # @param offset [Integer] The index of the first show to return. Use with limit to get the next set of shows. Default: 0.
+    # @param market [String] An {https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2 ISO 3166-1 alpha-2 country code}.
+    # @return [Array<Show>]
+    #
+    # @example
+    #           shows = RSpotify::Show.search('NPR')
+    #           shows = RSpotify::Show.search('NPR', market: 'US', limit: 10)
+    #
+    #           RSpotify::Show.search('NPR').total #=> 357
+    def self.search(query, limit: 20, offset: 0, market: nil)
+      super(query, 'show', limit: limit, offset: offset, market: market)
+    end
+
+    def initialize(options = {})
+      @available_markets = options['available_markets']
+      @copyrights        = options['copyrights']
+      @description       = options['description']
+      @explicit          = options['explicit']
+      @html_description  = options['html_description']
+      @images            = options['images']
+      @is_externally_hosted = options['is_externally_hosted']
+      @languages         = options['languages']
+      @media_type        = options['media_type']
+      @name              = options['name']
+      @publisher         = options['publisher']
+
+      episodes = options['episodes']['items'] if options['episodes']
+
+      @episodes_cache = if episodes
+        episodes.map { |e| Episode.new e }
+      end
+
+      super(options)
+    end
+
+    # Returns array of episodes from the show
+    #
+    # @param limit  [Integer] Maximum number of episodes to return. Maximum: 50. Default: 20.
+    # @param offset [Integer] The index of the first track to return. Use with limit to get the next set of objects. Default: 0.
+    # @param market [String]  An {https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2 ISO 3166-1 alpha-2 country code}.
+    # @return [Array<Episode>]
+    #
+    # @example
+    #           show = RSpotify::Show.find('3Z6JdCS2d0eFEpXHKI6WqH')
+    #           show.episodes.first.name #=> "Colin Powell's Complicated Legacy"
+    def episodes(limit: 20, offset: 0, market: nil )
+      last_episode = offset + limit - 1
+      if @episodes_cache && last_episode < 20 && !RSpotify.raw_response
+        return @episodes_cache[offset..last_episode]
+      end
+
+      url = "#{@href}/episodes?limit=#{limit}&offset=#{offset}"
+      url << "&market=#{market}" if market
+
+      response = RSpotify.get url
+
+      json = RSpotify.raw_response ? JSON.parse(response) : response
+      episodes = json['items']
+
+      episodes.map! { |e| Episode.new e }
+      @episodes_cache = episodes if limit == 20 && offset == 0
+      return response if RSpotify.raw_response
+      episodes
+    end
+
+  end
+end

data/lib/rspotify/version.rb

@@ -1,3 +1,3 @@
 module RSpotify
-  VERSION = '2.10.1'.freeze
+  VERSION = '2.11.1'.freeze
 end

data/lib/rspotify.rb

@@ -8,10 +8,12 @@ module RSpotify
   autoload :Base,               'rspotify/base'
   autoload :Category,           'rspotify/category'
   autoload :Device,             'rspotify/device'
+  autoload :Episode,            'rspotify/episode'
   autoload :Player,             'rspotify/player'
   autoload :Playlist,           'rspotify/playlist'
   autoload :Recommendations,    'rspotify/recommendations'
   autoload :RecommendationSeed, 'rspotify/recommendation_seed'
+  autoload :Show,               'rspotify/show'
   autoload :Track,              'rspotify/track'
   autoload :TrackLink,          'rspotify/track_link'
   autoload :User,               'rspotify/user'

data/rspotify.gemspec

@@ -18,7 +18,7 @@ Gem::Specification.new do |spec|
 
   spec.add_dependency 'omniauth-oauth2', '>= 1.6'
   spec.add_dependency 'rest-client', '~> 2.0.2'
-  spec.add_dependency 'addressable', '~> 2.5.2'
+  spec.add_dependency 'addressable', '~> 2.8.0'
 
   spec.add_development_dependency 'bundler'
   spec.add_development_dependency 'webmock'

data/spec/lib/rspotify/episode_spec.rb

@@ -0,0 +1,118 @@
+describe RSpotify::Episode do
+  describe 'Episode::find receiving id as a string' do
+    before(:each) do
+      @episode = VCR.use_cassette('episode:find:512ojhOuo1ktJprKbVcKyQ') do
+        RSpotify::Episode.find('512ojhOuo1ktJprKbVcKyQ')
+      end
+    end
+
+    it 'should find track with correct attributes' do
+      expect(@episode.audio_preview_url)        .to eq "https://p.scdn.co/mp3-preview/566fcc94708f39bcddc09e4ce84a8e5db8f07d4d"
+      expect(@episode.description)              .to start_with "En ny tysk bok granskar för första gången Tredje rikets drogberoende"
+      expect(@episode.duration_ms)              .to eq 1_502_795
+      expect(@episode.explicit)                 .to eq false
+      expect(@episode.href)                     .to eq 'https://api.spotify.com/v1/episodes/512ojhOuo1ktJprKbVcKyQ'
+      expect(@episode.html_description)         .to start_with "En ny tysk bok granskar för första gången Tredje rikets drogberoende"
+      expect(@episode.id)                       .to eq '512ojhOuo1ktJprKbVcKyQ'
+      expect(@episode.images.first["url"])      .to eq "https://i.scdn.co/image/de4a5f115ac6f6ca4cae4fb7aaf27bacac7a0b8a"
+      expect(@episode.images.size)              .to eq 3
+      expect(@episode.is_externally_hosted)     .to eq false
+      expect(@episode.is_playable)              .to eq true
+      expect(@episode.language)                 .to eq 'sv'
+      expect(@episode.languages)                .to eq ["sv"]
+      expect(@episode.name)                     .to eq 'Tredje rikets knarkande granskas'
+      expect(@episode.release_date_precision)   .to eq 'day'
+      expect(@episode.release_date)             .to eq '2015-10-01'
+      expect(@episode.restrictions)             .to eq Hash.new
+      expect(@episode.resume_point)             .to eq({"fully_played"=>false, "resume_position_ms"=>0})
+      expect(@episode.uri)                      .to eq 'spotify:episode:512ojhOuo1ktJprKbVcKyQ'
+    end
+
+    it 'should find the episode with correct show' do
+      show = @episode.show
+      expect(show)      .to be_an RSpotify::Show
+      expect(show.id)   .to eq '38bS44xjbVVZ3No3ByF1dJ'
+      expect(show.name) .to eq 'Vetenskapsradion Historia'
+    end
+
+    it 'should find an episode which is available in the given market' do
+      episode = VCR.use_cassette('episode:find:5NxzDE5TmviUV8te2eZjMP:market:ES') do
+        RSpotify::Episode.find('5NxzDE5TmviUV8te2eZjMP', market: 'ES')
+      end
+
+      expect(episode.id).to eq '5NxzDE5TmviUV8te2eZjMP'
+      expect(episode.is_playable). to eq true
+    end
+
+    it 'should not find an episode which is unavailable in the given market' do
+      episode = VCR.use_cassette('episode:find:5NxzDE5TmviUV8te2eZjMP:market:KG') do
+        RSpotify::Episode.find('5NxzDE5TmviUV8te2eZjMP', market: 'KG')
+      end
+
+      expect(episode.id).to eq '5NxzDE5TmviUV8te2eZjMP'
+      expect(episode.is_playable). to eq false
+    end
+  end
+
+  describe 'Episode::find receiving array of ids' do
+    it 'should find the right episodes' do
+      ids = ['512ojhOuo1ktJprKbVcKyQ']
+      episodes = VCR.use_cassette('episode:find_array:512ojhOuo1ktJprKbVcKyQ') do
+        RSpotify::Episode.find(ids)
+      end
+      expect(episodes)            .to be_an Array
+      expect(episodes.size)       .to eq 1
+      expect(episodes.first.name) .to eq 'Tredje rikets knarkande granskas'
+
+      ids << '18RPZgmvEGKtEC2WMTHghd'
+      episodes = VCR.use_cassette('episode:find_array:18RPZgmvEGKtEC2WMTHghd') do
+        RSpotify::Episode.find(ids)
+      end
+      expect(episodes)            .to be_an Array
+      expect(episodes.size)       .to eq 2
+      expect(episodes.first.name) .to eq 'Tredje rikets knarkande granskas'
+      expect(episodes.last.name)  .to eq 'Han upptäckte vikingastaden Birka'
+    end
+  end
+
+  describe 'Episode::search' do
+    it 'should search for the right episodes' do
+      episodes = VCR.use_cassette('episode:search:Tredje rikets knarkande granskas') do
+        RSpotify::Episode.search('Tredje rikets knarkande granskas')
+      end
+
+      expect(episodes)             .to be_an Array
+      expect(episodes.size)        .to eq 20
+      expect(episodes.total)       .to eq 527
+      expect(episodes.first)       .to be_an RSpotify::Episode
+      expect(episodes.map(&:name)) .to include('Tredje rikets knarkande granskas', '"Tre skadade i grovt våldsbrott i Lycksele"')
+    end
+
+    it 'should accept additional options' do
+      episodes = VCR.use_cassette('episode:search:Tredje rikets knarkande granskas:limit:10') do
+        RSpotify::Episode.search('Tredje rikets knarkande granskas', limit: 10)
+      end
+      expect(episodes.size)        .to eq 10
+      expect(episodes.map(&:name)) .to include('Tredje rikets knarkande granskas', '14. Första världskrigets BÄSTA generaler ... och Conrad')
+
+      episodes = VCR.use_cassette('episode:search:Tredje rikets knarkande granskas:offset:10') do
+        RSpotify::Episode.search('Tredje rikets knarkande granskas', offset: 10)
+      end
+      expect(episodes.size)        .to eq 20
+      expect(episodes.map(&:name)) .to include('GIIA-avsnitt 2: Stefan Kronanders avsnitt – tyska underrättelse-fuckups')
+
+      episodes = VCR.use_cassette('episode:search:Tredje rikets knarkande granskas:limit:10:offset:10') do
+        RSpotify::Episode.search('Tredje rikets knarkande granskas', limit: 10, offset: 10)
+      end
+      expect(episodes.size)        .to eq 10
+      expect(episodes.map(&:name)) .to include('GIIA-avsnitt 2: Stefan Kronanders avsnitt – tyska underrättelse-fuckups')
+
+      episodes = VCR.use_cassette('episode:search:Tredje rikets knarkande granskas:market:CA') do
+        RSpotify::Episode.search('Tredje rikets knarkande granskas', market: 'CA')
+        CA_episodes = episodes.map { |e| e.show.available_markets == 'CA'}
+      end
+
+      expect(CA_episodes.length).to eq(episodes.length)
+    end
+  end
+end

data/spec/lib/rspotify/show_spec.rb

@@ -0,0 +1,138 @@
+describe RSpotify::Show do
+  describe 'Show::find receiving id as a string' do
+
+    before(:each) do
+      @show = VCR.use_cassette('show:find:5CfCWKI5pZ28U0uOzXkDHe') do
+        RSpotify::Show.find('5CfCWKI5pZ28U0uOzXkDHe')
+      end
+    end
+
+    it 'should find show with correct attributes' do
+      expect(@show.available_markets)        .to be_an   Array
+      expect(@show.copyrights)               .to eq []
+      expect(@show.external_urls['spotify']) .to eq      'https://open.spotify.com/show/5CfCWKI5pZ28U0uOzXkDHe'
+      expect(@show.description)              .to eq      'Candid conversations with entrepreneurs, artists, athletes, visionaries of all kinds—about their successes, and their failures, and what they learned from both. Hosted by Alex Blumberg, from Gimlet Media.'
+      expect(@show.explicit)                 .to eq      true
+      expect(@show.html_description)         .to eq      '<p>Candid conversations with entrepreneurs, artists, athletes, visionaries of all kinds—about their successes, and their failures, and what they learned from both. Hosted by Alex Blumberg, from Gimlet Media.</p>'
+      expect(@show.href)                     .to eq      'https://api.spotify.com/v1/shows/5CfCWKI5pZ28U0uOzXkDHe'
+      expect(@show.id)                       .to eq      '5CfCWKI5pZ28U0uOzXkDHe'
+      expect(@show.images)                   .to include ({'height' => 640, 'width' => 640, 'url' => 'https://i.scdn.co/image/ab6765630000ba8a9d827f6e7e311b5947cce059'})
+      expect(@show.is_externally_hosted)     .to eq      false
+      expect(@show.languages)                .to eq      ["en"]
+      expect(@show.media_type)               .to eq      "audio"
+      expect(@show.name)                     .to eq      "Without Fail"
+      expect(@show.publisher)                .to eq      "Gimlet"
+      expect(@show.type)                     .to eq      'show'
+      expect(@show.uri)                      .to eq      'spotify:show:5CfCWKI5pZ28U0uOzXkDHe'
+    end
+
+    it 'should find show with correct episodes' do
+      episodes = @show.episodes
+      expect(episodes)             .to be_an Array
+      expect(episodes.size)        .to eq 20
+      expect(episodes.first)       .to be_an RSpotify::Episode
+      expect(episodes.map(&:name)) .to include("Introducing Michelle Obama and Her Mentees")
+    end
+  end
+
+  describe 'Show::find receiving array of ids' do
+    it 'should find the right shows' do
+      ids = ['5CfCWKI5pZ28U0uOzXkDHe']
+      shows = VCR.use_cassette('show:find_many:5CfCWKI5pZ28U0uOzXkDHe') do
+        RSpotify::Show.find(ids)
+      end
+      expect(shows)             .to be_an Array
+      expect(shows.size)        .to eq 1
+      expect(shows.first)       .to be_an RSpotify::Show
+      expect(shows.map(&:name)) .to include("Without Fail")
+
+      ids << '5as3aKmN2k11yfDDDSrvaZ'
+      shows = VCR.use_cassette('show:find_many:5CfCWKI5pZ28U0uOzXkDHe:5as3aKmN2k11yfDDDSrvaZ') do
+        RSpotify::Show.find(ids)
+      end
+      expect(shows)             .to be_an Array
+      expect(shows.size)        .to eq 2
+      expect(shows.first)       .to be_an RSpotify::Show
+      expect(shows.map(&:name)) .to include("Giant Bombcast")
+    end
+
+    it 'should find shows available in the given market' do
+      ids = ['5CfCWKI5pZ28U0uOzXkDHe', '5as3aKmN2k11yfDDDSrvaZ']
+      shows = VCR.use_cassette('show:find_many:5CfCWKI5pZ28U0uOzXkDHe:5as3aKmN2k11yfDDDSrvaZ:market:CA') do
+        RSpotify::Show.find(ids, market: 'CA')
+      end
+
+      expect(shows)             .to be_an Array
+      expect(shows.map(&:id))   .to include '5CfCWKI5pZ28U0uOzXkDHe'
+    end
+  end
+
+  describe 'Show::search' do
+    it 'should search for the right shows' do
+      shows = VCR.use_cassette('show:search:without fail') do
+        RSpotify::Show.search('Without Fail')
+      end
+      expect(shows)             .to be_an Array
+      expect(shows.size)        .to eq 20
+      expect(shows.total)       .to eq 233
+      expect(shows.first)       .to be_an RSpotify::Show
+      expect(shows.map(&:name)) .to include('Without Fail', 'Teach Without a Burden')
+    end
+
+    it 'should accept additional options' do
+      shows = VCR.use_cassette('show:search:without fail:limit:10') do
+        RSpotify::Show.search('Without Fail', limit: 10)
+      end
+      expect(shows.size)        .to eq 10
+      expect(shows.map(&:name)) .to include('Without Fail', 'Teach Without a Burden')
+
+      shows = VCR.use_cassette('show:search:without fail:offset:10') do
+        RSpotify::Show.search('Without Fail', offset: 10)
+      end
+      expect(shows.size)        .to eq 20
+      expect(shows.map(&:name)) .to include('Weight Loss Mindset', 'Two In The Think Tank')
+
+      shows = VCR.use_cassette('show:search:without fail:offset:10:limit:10') do
+        RSpotify::Show.search('Without Fail', limit: 10, offset: 10)
+      end
+      expect(shows.size)        .to eq 10
+      expect(shows.map(&:name)) .to include('Two In The Think Tank')
+
+      shows = VCR.use_cassette('show:search:without fail:market:ES') do
+        RSpotify::Show.search('Without Fail', market: 'ES')
+      end
+      ES_shows = shows.select { |a| a.available_markets.include?('ES') }
+      expect(ES_shows.length).to eq(shows.length)
+    end
+  end
+
+  describe '#episodes' do
+    it 'should fetch more episodes' do
+      show = VCR.use_cassette('show:find:5CfCWKI5pZ28U0uOzXkDHe') do
+        RSpotify::Show.find('5CfCWKI5pZ28U0uOzXkDHe')
+      end
+
+      episodes = VCR.use_cassette('show:find:5CfCWKI5pZ28U0uOzXkDHe:episodes') do
+        show.episodes(offset: 20, limit: 20)
+      end
+
+      expect(episodes)            .to be_an Array
+      expect(episodes.size)       .to eq 20
+      expect(episodes.first.name) .to eq 'Being an A$$hole: The Final Frontier for Women on the Screen'
+      expect(episodes.first.id)   .to eq '0DD6d3lmUjkIHzC13Z6fbs'
+    end
+
+    it "should find episodes available in the given market" do
+      show = VCR.use_cassette('show:find:5CfCWKI5pZ28U0uOzXkDHe') do
+        RSpotify::Show.find('5CfCWKI5pZ28U0uOzXkDHe')
+      end
+
+      episodes = VCR.use_cassette('show:find:5CfCWKI5pZ28U0uOzXkDHe:episodes:market:ES') do
+        show.episodes(offset: 20, limit: 20, market: 'ES')
+      end
+
+      expect(episodes.first.name) .to eq 'Being an A$$hole: The Final Frontier for Women on the Screen'
+      expect(episodes.first.id)   .to eq '0DD6d3lmUjkIHzC13Z6fbs'
+    end
+  end
+end

data/spec/vcr_cassettes/episode_find_512ojhOuo1ktJprKbVcKyQ.yml

@@ -0,0 +1,66 @@
+---
+http_interactions:
+- request:
+    method: get
+    uri: https://api.spotify.com/v1/episodes/512ojhOuo1ktJprKbVcKyQ
+    body:
+      encoding: US-ASCII
+      string: ''
+    headers:
+      Accept:
+      - "*/*"
+      Accept-Encoding:
+      - gzip, deflate
+      User-Agent:
+      - rest-client/2.0.2 (darwin20 x86_64) ruby/3.0.2p107
+      Authorization:
+      - Bearer BQBj_AiSFlKCkNIMbCWEYjuJLl6n76QmVsHU6MGDgTUBLZqNiKZ4ALs6Kvm6ulbsW9O81JDdIHyXBndXyhUOxg
+      Host:
+      - api.spotify.com
+  response:
+    status:
+      code: 200
+      message: OK
+    headers:
+      Content-Type:
+      - application/json; charset=utf-8
+      Cache-Control:
+      - public, max-age=60
+      Etag:
+      - '"MC-IjA4NWQ2NDMxNjBiYjVmZjBiZmU1NTQxMGNmZjc3Y2Y3Ig=="'
+      X-Robots-Tag:
+      - noindex, nofollow
+      Access-Control-Allow-Origin:
+      - "*"
+      Access-Control-Allow-Headers:
+      - Accept, App-Platform, Authorization, Content-Type, Origin, Retry-After, Spotify-App-Version,
+        X-Cloud-Trace-Context, client-token, content-access-token
+      Access-Control-Allow-Methods:
+      - GET, POST, OPTIONS, PUT, DELETE, PATCH
+      Access-Control-Allow-Credentials:
+      - 'true'
+      Access-Control-Max-Age:
+      - '604800'
+      Content-Encoding:
+      - gzip
+      Strict-Transport-Security:
+      - max-age=31536000
+      X-Content-Type-Options:
+      - nosniff
+      Date:
+      - Wed, 20 Oct 2021 22:38:08 GMT
+      Server:
+      - envoy
+      Via:
+      - HTTP/2 edgeproxy, 1.1 google
+      Alt-Svc:
+      - clear
+      Transfer-Encoding:
+      - chunked
+    body:
+      encoding: ASCII-8BIT
+      string: !binary |-
+        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
+    http_version:
+  recorded_at: Wed, 20 Oct 2021 22:38:08 GMT
+recorded_with: VCR 3.0.3