fanart_api 0.2.1 → 0.3.0

data/lib/fanart_api/tv.rb

@@ -1,18 +1,108 @@
-# documentation: http://fanart.tv/api-docs/tv-api
 class FanartApi::Tv < FanartApi::Base
-  def find(options = {})
+  include Ov
+
+  # Find specific tv data.
+  #
+  # access: FREE
+  # param:
+  #   find(1234)
+  # output: Faraday::Response instance with Hash body
+  # example: http://docs.fanarttv.apiary.io/#tv
+  let :find, Any do |id|
+    find(id: id)
+  end
+
+  # Find specific tv data.
+  #
+  # access: FREE
+  # param:
+  #   find(id: 1234)
+  # output: Faraday::Response instance with Hash body
+  # example: http://docs.fanarttv.apiary.io/#tv
+  let :find, Hash do |options|
     find_path_with_params(options).get
   end
 
-  def find_url(options = {})
+  # Find specific tv data - return only url.
+  #
+  # access: FREE
+  # param:
+  #   find_url(1234)
+  # output: url string
+  let :find_url, Any do |id|
+    find_url(id: id)
+  end
+
+  # Find specific tv data - return only url.
+  #
+  # access: FREE
+  # param:
+  #   find_url(id: 1234)
+  # output: url string
+  let :find_url, Hash do |options|
     find_path_with_params(options).url
   end
 
-  def latest(options = {})
+  # Get latest tv data.
+  #
+  # access: FREE
+  # param:
+  #   latest
+  # output: Faraday::Response instance with Array body
+  # example: http://docs.fanarttv.apiary.io/#tv
+  let :latest do |date|
+    latest({})
+  end
+
+  # Get latest tv data.
+  #
+  # access: FREE
+  # param:
+  #   latest(1234)
+  # output: Faraday::Response instance with Array body
+  # example: http://docs.fanarttv.apiary.io/#tv
+  let :latest, Any do |date|
+    latest(date: date)
+  end
+
+  # Get latest tv data.
+  #
+  # access: FREE
+  # param:
+  #   latest(date: 1234)
+  # output: Faraday::Response instance with Array body
+  # example: http://docs.fanarttv.apiary.io/#tv
+  let :latest, Hash do |options|
     latest_path_with_params(options).get
   end
 
-  def latest_url(options = {})
+  # Get latest tv data - return only url.
+  #
+  # access: FREE
+  # param:
+  #   latest_url
+  # output: url string
+  let :latest_url do |date|
+    latest_url({})
+  end
+
+  # Get latest tv data - return only url.
+  #
+  # access: FREE
+  # param:
+  #   latest_url(1234)
+  # output: url string
+  let :latest_url, Any do |date|
+    latest_url(date: date)
+  end
+
+  # Get latest tv data - return only url.
+  #
+  # access: FREE
+  # param:
+  #   latest_url(date: 1234)
+  # output: url string
+  let :latest_url, Hash do |options|
     latest_path_with_params(options).url
   end
 

data/lib/fanart_api/version.rb

@@ -1,3 +1,3 @@
 module FanartApi
-  VERSION = '0.2.1'
+  VERSION = '0.3.0'
 end

data/spec/functionals/movie_spec.rb

@@ -5,44 +5,101 @@ describe FanartApi::Movie do
   let(:model) { client.movie }
 
   let(:movies_data) { File.read('spec/fixtures/find_movies.json') }
-  let(:movies_data) { File.read('spec/fixtures/find_movies.json') }
+  let(:latest_movies_data) { File.read('spec/fixtures/latest_movies.json') }
 
   let(:faraday_stubs) do
     Faraday::Adapter::Test::Stubs.new do |stub|
       stub.get('/v3/movies/1234?api_key=123456789') { [200, { content_type: 'json' }, movies_data] }
-      stub.get('/v3/movies/latest?api_key=123456789&date=123') { [200, { content_type: 'json' }, {}] }
+      stub.get('/v3/movies/latest?api_key=123456789&date=123') { [200, { content_type: 'json' }, latest_movies_data] }
+      stub.get('/v3/movies/latest?api_key=123456789') { [200, { content_type: 'json' }, latest_movies_data] }
     end
   end
 
   describe '.find' do
-    it 'should return Faraday::Response class' do
-      model.find(id: 1234).class.should == Faraday::Response
+    context 'hash attributes' do
+      it 'should return Faraday::Response class' do
+        expect(model.find(id: 1234)).to be_a(Faraday::Response)
+      end
+
+      it 'should return Hash class for body reponse' do
+        expect(model.find(id: 1234).body).to be_a(Hash)
+      end
     end
 
-    it 'should return Hash class for body reponse' do
-      model.find(id: 1234).body == Hash
+    context 'normal attributes' do
+      it 'should return Faraday::Response class' do
+        expect(model.find(1234)).to be_a(Faraday::Response)
+      end
+
+      it 'should return Hash class for body reponse' do
+        expect(model.find(1234).body).to be_a(Hash)
+      end
     end
   end
 
   describe '.find_url' do
-    it 'should return correct url' do
-      model.find_url(id: 1234).should == 'http://fanarttv.apiary-proxy.com/v3/movies/1234?api_key=123456789'
+    context 'hash attributes' do
+      it 'should return correct url' do
+        expect(model.find_url(id: 1234)).to eq('http://webservice.fanart.tv/v3/movies/1234?api_key=123456789')
+      end
+    end
+
+    context 'normal attributes' do
+      it 'should return correct url' do
+        expect(model.find_url(1234)).to eq('http://webservice.fanart.tv/v3/movies/1234?api_key=123456789')
+      end
     end
   end
 
   describe '.latest' do
-    it 'should return Faraday::Response class' do
-      model.latest(date: 123).class.should == Faraday::Response
+    context 'hash attributes' do
+      it 'should return Faraday::Response class' do
+        expect(model.latest(date: 123)).to be_a(Faraday::Response)
+      end
+
+      it 'should return Hash class for body reponse' do
+        expect(model.latest(date: 123).body).to be_a(Array)
+      end
+    end
+
+    context 'normal attributes' do
+      it 'should return Faraday::Response class' do
+        expect(model.latest(123)).to be_a(Faraday::Response)
+      end
+
+      it 'should return Hash class for body reponse' do
+        expect(model.latest(123).body).to be_a(Array)
+      end
     end
 
-    it 'should return Hash class for body reponse' do
-      model.latest(date: 123).body == Hash
+    context 'without attributes' do
+      it 'should return Faraday::Response class' do
+        expect(model.latest).to be_a(Faraday::Response)
+      end
+
+      it 'should return Hash class for body reponse' do
+        expect(model.latest.body).to be_a(Array)
+      end
     end
   end
 
   describe '.latest_url' do
-    it 'should return correct url' do
-      model.latest_url(date: 123).should == 'http://fanarttv.apiary-proxy.com/v3/movies/latest?api_key=123456789&date=123'
+    context 'hash attributes' do
+      it 'should return correct url' do
+        expect(model.latest_url(date: 123)).to eq('http://webservice.fanart.tv/v3/movies/latest?api_key=123456789&date=123')
+      end
+    end
+
+    context 'normal attributes' do
+      it 'should return correct url' do
+        expect(model.latest_url(123)).to eq('http://webservice.fanart.tv/v3/movies/latest?api_key=123456789&date=123')
+      end
+    end
+
+    context 'without attributes' do
+      it 'should return correct url' do
+        expect(model.latest_url).to eq('http://webservice.fanart.tv/v3/movies/latest?api_key=123456789')
+      end
     end
   end
 end

data/spec/functionals/music_spec.rb

@@ -13,70 +13,167 @@ describe FanartApi::Music do
       stub.get('/v3/music/albums/1234?api_key=123456789') { [200, { content_type: 'json' }, music_data] }
       stub.get('/v3/music/labels/1234?api_key=123456789') { [200, { content_type: 'json' }, music_data] }
       stub.get('/v3/music/latest?api_key=123456789&date=123') { [200, { content_type: 'json' }, latest_music_data] }
+      stub.get('/v3/music/latest?api_key=123456789') { [200, { content_type: 'json' }, latest_music_data] }
     end
   end
 
   describe '.artist' do
-    it 'should return Faraday::Response class' do
-      model.artist(id: 1234).class.should == Faraday::Response
+    context 'hash attributes' do
+      it 'should return Faraday::Response class' do
+        expect(model.artist(id: 1234)).to be_a(Faraday::Response)
+      end
+
+      it 'should return Hash class for body reponse' do
+        expect(model.artist(id: 1234).body).to be_a(Hash)
+      end
     end
 
-    it 'should return Hash class for body reponse' do
-      model.artist(id: 1234).body == Hash
+    context 'normal attributes' do
+      it 'should return Faraday::Response class' do
+        expect(model.artist(1234)).to be_a(Faraday::Response)
+      end
+
+      it 'should return Hash class for body reponse' do
+        expect(model.artist(1234).body).to be_a(Hash)
+      end
     end
   end
 
   describe '.artist_url' do
-    it 'should return correct url' do
-      model.artist_url(id: 1234).should == 'http://fanarttv.apiary-proxy.com/v3/music/1234?api_key=123456789'
+    context 'hash attributes' do
+      it 'should return correct url' do
+        expect(model.artist_url(id: 1234)).to eq('http://webservice.fanart.tv/v3/music/1234?api_key=123456789')
+      end
+    end
+
+    context 'normal attributes' do
+      it 'should return correct url' do
+        expect(model.artist_url(1234)).to eq('http://webservice.fanart.tv/v3/music/1234?api_key=123456789')
+      end
     end
   end
 
   describe '.album' do
-    it 'should return Faraday::Response class' do
-      model.album(id: 1234).class.should == Faraday::Response
+    context 'hash attributes' do
+      it 'should return Faraday::Response class' do
+        expect(model.album(id: 1234)).to be_a(Faraday::Response)
+      end
+
+      it 'should return Hash class for body reponse' do
+        expect(model.album(id: 1234).body).to be_a(Hash)
+      end
     end
 
-    it 'should return Hash class for body reponse' do
-      model.album(id: 1234).body == Hash
+    context 'normal attributes' do
+      it 'should return Faraday::Response class' do
+        expect(model.album(1234)).to be_a(Faraday::Response)
+      end
+
+      it 'should return Hash class for body reponse' do
+        expect(model.album(1234).body).to be_a(Hash)
+      end
     end
   end
 
   describe '.album_url' do
-    it 'should return correct url' do
-      model.album_url(id: 1234).should == 'http://fanarttv.apiary-proxy.com/v3/music/albums/1234?api_key=123456789'
+    context 'hash attributes' do
+      it 'should return correct url' do
+        expect(model.album_url(id: 1234)).to eq('http://webservice.fanart.tv/v3/music/albums/1234?api_key=123456789')
+      end
+    end
+
+    context 'normal attributes' do
+      it 'should return correct url' do
+        expect(model.album_url(1234)).to eq('http://webservice.fanart.tv/v3/music/albums/1234?api_key=123456789')
+      end
     end
   end
 
   describe '.label' do
-    it 'should return Faraday::Response class' do
-      model.label(id: 1234).class.should == Faraday::Response
+    context 'hash attributes' do
+      it 'should return Faraday::Response class' do
+        expect(model.label(id: 1234)).to be_a(Faraday::Response)
+      end
+
+      it 'should return Hash class for body reponse' do
+        expect(model.label(id: 1234).body).to be_a(Hash)
+      end
     end
 
-    it 'should return Hash class for body reponse' do
-      model.label(id: 1234).body == Hash
+    context 'normal attributes' do
+      it 'should return Faraday::Response class' do
+        expect(model.label(1234)).to be_a(Faraday::Response)
+      end
+
+      it 'should return Hash class for body reponse' do
+        expect(model.label(1234).body).to be_a(Hash)
+      end
     end
   end
 
   describe '.label_url' do
-    it 'should return correct url' do
-      model.label_url(id: 1234).should == 'http://fanarttv.apiary-proxy.com/v3/music/labels/1234?api_key=123456789'
+    context 'hash attributes' do
+      it 'should return correct url' do
+        expect(model.label_url(id: 1234)).to eq('http://webservice.fanart.tv/v3/music/labels/1234?api_key=123456789')
+      end
+    end
+
+    context 'normal attributes' do
+      it 'should return correct url' do
+        expect(model.label_url(1234)).to eq('http://webservice.fanart.tv/v3/music/labels/1234?api_key=123456789')
+      end
     end
   end
 
   describe '.latest' do
-    it 'should return Faraday::Response class' do
-      model.latest(date: 123).class.should == Faraday::Response
+    context 'hash attributes' do
+      it 'should return Faraday::Response class' do
+        expect(model.latest(date: 123)).to be_a(Faraday::Response)
+      end
+
+      it 'should return Hash class for body reponse' do
+        expect(model.latest(date: 123).body).to be_a(Array)
+      end
+    end
+
+    context 'normal attributes' do
+      it 'should return Faraday::Response class' do
+        expect(model.latest(123)).to be_a(Faraday::Response)
+      end
+
+      it 'should return Hash class for body reponse' do
+        expect(model.latest(123).body).to be_a(Array)
+      end
     end
 
-    it 'should return Hash class for body reponse' do
-      model.latest(date: 123).body == Hash
+    context 'without attributes' do
+      it 'should return Faraday::Response class' do
+        expect(model.latest).to be_a(Faraday::Response)
+      end
+
+      it 'should return Hash class for body reponse' do
+        expect(model.latest.body).to be_a(Array)
+      end
     end
   end
 
   describe '.latest_url' do
-    it 'should return correct url' do
-      model.latest_url(date: 123).should == 'http://fanarttv.apiary-proxy.com/v3/music/latest?api_key=123456789&date=123'
+    context 'hash attributes' do
+      it 'should return correct url' do
+        expect(model.latest_url(date: 123)).to eq('http://webservice.fanart.tv/v3/music/latest?api_key=123456789&date=123')
+      end
+    end
+
+    context 'normal attributes' do
+      it 'should return correct url' do
+        expect(model.latest_url(123)).to eq('http://webservice.fanart.tv/v3/music/latest?api_key=123456789&date=123')
+      end
+    end
+
+    context 'without attributes' do
+      it 'should return correct url' do
+        expect(model.latest_url).to eq('http://webservice.fanart.tv/v3/music/latest?api_key=123456789')
+      end
     end
   end
 end

data/spec/functionals/tv_spec.rb

@@ -11,38 +11,95 @@ describe FanartApi::Tv do
     Faraday::Adapter::Test::Stubs.new do |stub|
       stub.get('/v3/tv/1234?api_key=123456789') { [200, { content_type: 'json' }, tv_data] }
       stub.get('/v3/tv/latest?api_key=123456789&date=123') { [200, { content_type: 'json' }, latest_tv_data] }
+      stub.get('/v3/tv/latest?api_key=123456789') { [200, { content_type: 'json' }, latest_tv_data] }
     end
   end
 
   describe '.find' do
-    it 'should return Faraday::Response class' do
-      model.find(id: 1234).class.should == Faraday::Response
+    context 'hash attributes' do
+      it 'should return Faraday::Response class' do
+        expect(model.find(id: 1234)).to be_a(Faraday::Response)
+      end
+
+      it 'should return Hash class for body reponse' do
+        expect(model.find(id: 1234).body).to be_a(Hash)
+      end
     end
 
-    it 'should return Hash class for body reponse' do
-      model.find(id: 1234).body == Hash
+    context 'normal attributes' do
+      it 'should return Faraday::Response class' do
+        expect(model.find(1234)).to be_a(Faraday::Response)
+      end
+
+      it 'should return Hash class for body reponse' do
+        expect(model.find(1234).body).to be_a(Hash)
+      end
     end
   end
 
   describe '.find_url' do
-    it 'should return correct url' do
-      model.find_url(id: 1234).should == 'http://fanarttv.apiary-proxy.com/v3/tv/1234?api_key=123456789'
+    context 'hash attributes' do
+      it 'should return correct url' do
+        expect(model.find_url(id: 1234)).to eq('http://webservice.fanart.tv/v3/tv/1234?api_key=123456789')
+      end
+    end
+
+    context 'normal attributes' do
+      it 'should return correct url' do
+        expect(model.find_url(1234)).to eq('http://webservice.fanart.tv/v3/tv/1234?api_key=123456789')
+      end
     end
   end
 
   describe '.latest' do
-    it 'should return Faraday::Response class' do
-      model.latest(date: 123).class.should == Faraday::Response
+    context 'hash attributes' do
+      it 'should return Faraday::Response class' do
+        expect(model.latest(date: 123)).to be_a(Faraday::Response)
+      end
+
+      it 'should return Hash class for body reponse' do
+        expect(model.latest(date: 123).body).to be_a(Array)
+      end
     end
 
-    it 'should return Hash class for body reponse' do
-      model.latest(date: 123).body == Array
+    context 'normal attributes' do
+      it 'should return Faraday::Response class' do
+        expect(model.latest(123)).to be_a(Faraday::Response)
+      end
+
+      it 'should return Hash class for body reponse' do
+        expect(model.latest(123).body).to be_a(Array)
+      end
+    end
+
+    context 'without attributes' do
+      it 'should return Faraday::Response class' do
+        expect(model.latest).to be_a(Faraday::Response)
+      end
+
+      it 'should return Hash class for body reponse' do
+        expect(model.latest.body).to be_a(Array)
+      end
     end
   end
 
   describe '.latest_url' do
-    it 'should return correct url' do
-      model.latest_url(date: 123).should == 'http://fanarttv.apiary-proxy.com/v3/tv/latest?api_key=123456789&date=123'
+    context 'hash attributes' do
+      it 'should return correct url' do
+        expect(model.latest_url(date: 123)).to eq('http://webservice.fanart.tv/v3/tv/latest?api_key=123456789&date=123')
+      end
+    end
+
+    context 'normal attributes' do
+      it 'should return correct url' do
+        expect(model.latest_url(123)).to eq('http://webservice.fanart.tv/v3/tv/latest?api_key=123456789&date=123')
+      end
+    end
+
+    context 'without attributes' do
+      it 'should return correct url' do
+        expect(model.latest_url).to eq('http://webservice.fanart.tv/v3/tv/latest?api_key=123456789')
+      end
     end
   end
 end