itunes_api 0.3.1 → 0.4.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: 3ade50c409cdf0919ad1b4377fc7a962e7f190fa
-  data.tar.gz: '011542190e9a595871c45698957e2246338a34ba'
+  metadata.gz: e9c62e5baa4d01dbfeb1e0b56e8676cd46239498
+  data.tar.gz: a6c357e85297545feb54cfbb6cc2147fd1b166eb
 SHA512:
-  metadata.gz: 8172f7254df1f1ba51f78af992d3cb3e5b3ccbe6df5ca411dbc4f35eaa2dcaa047f045b9067cb12c4d92bf49071dd41d1cbb7f01f8ec6f448097b748654d3bc1
-  data.tar.gz: 19ae0271c627eed19c32d4d99d369e1572a306c488ba9d5b3341b9f4fd5e3e436cb8c5d645fba316c9be96643cdb1da0b6926d0caa145df1d080d5df46f8e55a
+  metadata.gz: 1c7f150941a05bd2f64c6f75993d1892e8add4f903dcea363173271055b6e6011d337b33437a1c2b8828a168f8dc584ca29584cd09e079f35e4b31109ada11c2
+  data.tar.gz: 6c279bf3e2f3c57a01fea4390c61dc6f6b32c122d121cfe797a146e3bf6bff790e6eb5c37d43677006f897a1825731f28213c67f7ca22952201e720dea5d5736

data/README.md

@@ -32,7 +32,12 @@ To return all the AMG ids associated with a search term.
 ItunesApi.artist_ids('Pink Floyd')
 ```
 
-To return structured information abut artists and albums associated with a search term.
+To return a specific artist with albums, based on the AMG id.
+```ruby
+ItunesApi.artist_lookup(12345)
+```
+
+To get all artists returning from a search term, and their albums.
 ```ruby
 ItunesApi.artist_search('Pink Floyd')
 ```

data/itunes_api.gemspec

@@ -37,4 +37,6 @@ Gem::Specification.new do |spec|
   spec.add_development_dependency 'rake'
   spec.add_development_dependency 'rspec'
   spec.add_development_dependency 'rubocop'
+  spec.add_development_dependency 'vcr'
+  spec.add_development_dependency 'webmock'
 end

data/lib/itunes_api/music/album.rb

@@ -2,17 +2,29 @@ module ItunesApi
   module Music
     # Wrapper for album results.
     class Album
-      attr_reader :name, :artwork, :released
-
       def initialize(data)
-        @name = data['collectionName']
-        @artwork = data['artworkUrl100']
-        @released = Date.parse(data['releaseDate'])
+        @data = data
       end
 
       def self.build(albums_data)
         albums_data.map { |data| new(data) }
       end
+
+      def artwork
+        @artwork ||= data['artworkUrl100']
+      end
+
+      def name
+        @name ||= data['collectionName']
+      end
+
+      def released
+        @released ||= Date.parse(data['releaseDate'])
+      end
+
+      private
+
+      attr_reader :data
     end
   end
 end

data/lib/itunes_api/music/artist.rb

@@ -2,13 +2,25 @@ module ItunesApi
   module Music
     # Artist or Band from the Apple catalog
     class Artist
-      attr_reader :name, :artist_id, :albums
-
       def initialize(data)
-        @name = data['artistName']
-        @artist_id = data['amgArtistId']
-        @albums = Album.build(data[:albums])
+        @data = data
+      end
+
+      def albums
+        @albums ||= Album.build(data[:albums])
+      end
+
+      def artist_id
+        @artist_id ||= data['amgArtistId']
       end
+
+      def name
+        @name ||= data['artistName']
+      end
+
+      private
+
+      attr_reader :data
     end
   end
 end

data/lib/itunes_api/music/artist_lookup.rb

@@ -0,0 +1,28 @@
+module ItunesApi
+  module Music
+    # Artist or Band resulting from a specific lookup
+    class ArtistLookup
+      def initialize(artist_id)
+        @artist_id = artist_id
+      end
+
+      def self.artist(artist_id)
+        new(artist_id).artist
+      end
+
+      def artist
+        @artist ||= build_artist(artist_id)
+      end
+
+      private
+
+      attr_reader :artist_id
+
+      def build_artist(id)
+        Artist.new(
+          Requests::Lookup.artist_with_albums(id)
+        )
+      end
+    end
+  end
+end

data/lib/itunes_api/music/artist_search.rb

@@ -16,8 +16,10 @@ module ItunesApi
 
       private
 
+      attr_reader :name
+
       def artist_ids
-        @search ||= ItunesApi.artist_ids(@name)
+        @search ||= ItunesApi.artist_ids(name)
       end
 
       def build_artist(id)

data/lib/itunes_api/requests/lookup.rb

@@ -37,13 +37,9 @@ module ItunesApi
       end
 
       def artist_data
-        symbolize_keys(
-          unwrapped(
-            results.find do |wrappers|
-              wrappers['wrapperType'] == 'artist'
-            end
-          )
-        )
+        results.find do |wrappers|
+          wrappers['wrapperType'] == 'artist'
+        end
       end
 
       def query_values

data/lib/itunes_api/version.rb

@@ -1,3 +1,3 @@
 module ItunesApi
-  VERSION = '0.3.1'.freeze
+  VERSION = '0.4.0'.freeze
 end

data/lib/itunes_api.rb

@@ -3,6 +3,7 @@ require 'itunes_api/requests/lookup'
 require 'itunes_api/requests/search'
 require 'itunes_api/music/album'
 require 'itunes_api/music/artist'
+require 'itunes_api/music/artist_lookup'
 require 'itunes_api/music/artist_search'
 
 # Interface to the Itunes Api
@@ -15,6 +16,10 @@ module ItunesApi
     Requests::Search.artist_ids(name)
   end
 
+  def self.artist_lookup(artist_id)
+    Music::ArtistLookup.artist(artist_id)
+  end
+
   def self.artist_search(name)
     Music::ArtistSearch.artists(name)
   end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: itunes_api
 version: !ruby/object:Gem::Version
-  version: 0.3.1
+  version: 0.4.0
 platform: ruby
 authors:
 - Mario D’Arco
 autorequire: 
 bindir: exe
 cert_chain: []
-date: 2017-05-18 00:00:00.000000000 Z
+date: 2017-05-19 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: addressable
@@ -80,6 +80,34 @@ dependencies:
     - - ">="
       - !ruby/object:Gem::Version
         version: '0'
+- !ruby/object:Gem::Dependency
+  name: vcr
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: webmock
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
 description: An interface to the iTunes Api
 email:
 - mariodarco78@icloud.com
@@ -100,6 +128,7 @@ files:
 - lib/itunes_api.rb
 - lib/itunes_api/music/album.rb
 - lib/itunes_api/music/artist.rb
+- lib/itunes_api/music/artist_lookup.rb
 - lib/itunes_api/music/artist_search.rb
 - lib/itunes_api/requests/base.rb
 - lib/itunes_api/requests/lookup.rb