itunes_api 1.4.1 → 2.0.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: 7d9d1bb43f0c302f38b5f6b1a39250a0b353b46e
-  data.tar.gz: da5322824332f88448a44ffd0951719cb261bfe3
+  metadata.gz: b59950a6d1529d61e387ac0ef1306324959bc43d
+  data.tar.gz: d5bb63b84da411992c53a7178224e34023d2f02a
 SHA512:
-  metadata.gz: 67350e54f9d59ac5545fcfc01f004aae3a46368da8c35213b35a1fcc28d5646182eaed7b9733597df78b33f65f10d76046dd83bc5dc6c3544faa4708f806088f
-  data.tar.gz: 163f60f34e6995f5bd11c083956f85ffdbf28caa27db5251a9c3a60196d0ada629d64a5006317eab7e53839917af92b30feb673dbb06451c655ec6913590a6dc
+  metadata.gz: 4cabff1c9f4a1d757231f46d1623ed2d5506efee42e289ae92e63aa979bff1a3a6944e8170c885d468d2a0f314715192b5108385609d8a91e50317b0b802ee33
+  data.tar.gz: 63d044a01c39946370f2133a0190a0fad390db937fca70d43ac4b1885134154bff678ddccb489906602144e3dea5b66815b87a39115af2f795c904a9236d9ec6

data/.gitignore

@@ -1,9 +1,8 @@
 /.bundle/
 /.yardoc
-/Gemfile.lock
 /_yardoc/
-/coverage/
 /doc/
+/Gemfile.lock
 /pkg/
 /spec/reports/
 /tmp/

data/.rspec

@@ -1,2 +1,4 @@
---format documentation
 --color
+--fail-fast
+--format documentation
+--warning

data/Gemfile

@@ -1,5 +1,4 @@
 source 'https://rubygems.org'
 ruby '2.4.1'
 
-# Specify your gem's dependencies in itunes_api.gemspec
 gemspec

data/LICENSE.txt

@@ -1,6 +1,6 @@
 The MIT License (MIT)
 
-Copyright (c) 2016 Mario D’Arco
+Copyright (c) 2017 Mario D’Arco
 
 Permission is hereby granted, free of charge, to any person obtaining a copy
 of this software and associated documentation files (the "Software"), to deal

data/README.md

@@ -1,6 +1,6 @@
 # ItunesApi
 
-[![Gem Version](https://badge.fury.io/rb/itunes_api.svg)](https://badge.fury.io/rb/itunes_api) [![Dependency Status](https://gemnasium.com/badges/github.com/mariodarco/itunes-api.svg)](https://gemnasium.com/github.com/mariodarco/itunes-api) [![CircleCI](https://circleci.com/gh/mariodarco/itunes-api/tree/master.svg?style=shield)](https://circleci.com/gh/mariodarco/itunes-api/tree/master) [![Coverage Status](https://coveralls.io/repos/github/mariodarco/itunes-api/badge.svg?branch=master)](https://coveralls.io/github/mariodarco/itunes-api?branch=master)
+[![Gem Version](https://badge.fury.io/rb/itunes_api.svg)](https://badge.fury.io/rb/itunes_api) [![Dependency Status](https://gemnasium.com/badges/github.com/mariodarco/itunes-api.svg)](https://gemnasium.com/github.com/mariodarco/itunes-api) [![CircleCI](https://circleci.com/gh/mariodarco/itunes-api/tree/master.svg?style=shield)](https://circleci.com/gh/mariodarco/itunes-api/tree/master)
 
 A simple interface for the Itunes Api.
 
@@ -37,37 +37,40 @@ end
 
 ## Usage
 
-To return all the Apple ids associated with the search for a Artist name.
+To return all the Apple ids associated with the search for a Artist name
 
 ```ruby
-ItunesApi.artist_ids('Pink Floyd')
+ItunesApi::Music.all_apple_ids('Pink Floyd')
 ```
 
-To get all artists returning from a search term, and their albums.
+To get all artists returning from a search term
 
 ```ruby
-ItunesApi.artist_search('Led Zeppelin')
+ItunesApi::Music.all_artists_by_name('Led Zeppelin')
 ```
 
-To return a specific artist with albums, based on the Apple id.
+To return a specific artist, based on the artist's Apple id
 
 ```ruby
-ItunesApi.artist_lookup(265766061)
+ItunesApi::Music.find_by_apple_id(265766061)
 ```
 
-To return the tracklist for a specific albums, based on the Apple collection id.
+Note that each request that returns artists does not automatically return albums.
+They are lazily fetched when calling artist.albums.
+
+To return only the albums for a specific artist, based on the artist's Apple id
 
 ```ruby
-ItunesApi.album_lookup(286930912)
+ItunesApi::Music.albums_for_artist(265766061)
 ```
 
-An argument holding the country code can be used to look into different stores than the default one.
+An argument holding the country code can be used to look into different stores than the default one
 
 ```ruby
-ItunesApi.artist_ids('Pink Floyd', :it)
-ItunesApi.artist_search('Led Zeppelin', :fr)
-ItunesApi.artist_lookup(265766061, :us)
-ItunesApi.album_lookup(286930912, :gb)
+ItunesApi::Music.all_apple_ids('Pink Floyd', :it)
+ItunesApi::Music.all_artists_by_name('Led Zeppelin', :fr)
+ItunesApi::Music.find_by_apple_id(265766061, :us)
+ItunesApi::Music.albums_for_artist(265766061, :es)
 ```
 
 ## Development

data/Rakefile

@@ -2,5 +2,4 @@ require 'bundler/gem_tasks'
 require 'rspec/core/rake_task'
 
 RSpec::Core::RakeTask.new(:spec)
-
 task default: :spec

data/bin/console

@@ -2,13 +2,6 @@
 
 require 'bundler/setup'
 require 'itunes_api'
-
-# You can add fixtures and/or initialization code here to make experimenting
-# with your gem easier. You can also use a different console, if you like.
-
-# (If you use this, don't forget to add pry to your Gemfile!)
-# require "pry"
-# Pry.start
-
 require 'irb'
+
 IRB.start

data/bin/setup

@@ -1,8 +1,7 @@
 #!/usr/bin/env bash
+
 set -euo pipefail
 IFS=$'\n\t'
 set -vx
 
 bundle install
-
-# Do any other automated setup that you need to do here

data/itunes_api.gemspec

@@ -27,10 +27,8 @@ Gem::Specification.new do |spec|
   spec.add_dependency 'selfies'
 
   spec.add_development_dependency 'bundler'
-  spec.add_development_dependency 'coveralls'
   spec.add_development_dependency 'rake'
   spec.add_development_dependency 'rspec'
-  spec.add_development_dependency 'simplecov'
   spec.add_development_dependency 'rubocop'
   spec.add_development_dependency 'vcr'
 end

data/lib/itunes_api/music/album.rb

@@ -3,64 +3,57 @@ module ItunesApi
   module Music
     # Wrapper for album results.
     class Album
-      attr_reader_init :data, :store
-      private :data
+      attr_reader_init :artwork, :collection_id, :genre, :name, :release_on, :store
 
-      def self.build(albums_data, store)
-        albums_data.map { |data| new(data, store) }
-                   .sort_by(&:released)
-                   .reverse
-      end
-
-      def artwork
-        @artwork ||= data[:artworkUrl100]
-      end
-
-      def availability
-        prefix = pre_release? ? 'pre_release_' : ''
-
-        if apple_music?
-          "#{prefix}streaming".to_sym
-        else
-          "#{prefix}sale".to_sym
+      class << self
+        def for_artist(apple_id, store)
+          albums(apple_id, store).map { |album| new(*album.attributes) }
         end
-      end
 
-      def collection_id
-        @collection_id ||= data[:collectionId]
-      end
+        private
 
-      def name
-        @name ||= data[:collectionName]
+        def albums(apple_id, store)
+          Requests::Albums.find_by_apple_id(apple_id, store)
+        end
       end
 
-      def released
-        @released ||= Date.parse(data[:releaseDate])
+      def availability
+        @availability ||= build_availability
       end
 
       def to_hash
         {
           artwork: artwork,
+          availability: availability,
           collection_id: collection_id,
           name: name,
-          released: released,
-          availability: availability,
+          release_on: release_on,
           store: store
         }
       end
 
+      def tracklist
+        @tracklist ||= songs.map { |song| Song.new(*song.attributes) }
+      end
+
       private
 
       def apple_music?
         tracklist.any?(&:streamable?)
       end
 
+      def build_availability
+        prefix = pre_release? ? 'pre_release_' : ''
+        suffix = apple_music? ? 'streaming' : 'sale'
+        "#{prefix}#{suffix}".to_sym
+      end
+
       def pre_release?
-        released > Date.today
+        release_on > Date.today
       end
 
-      def tracklist
-        @tracklist ||= AlbumLookup.tracklist(collection_id, store)
+      def songs
+        @songs ||= Requests::Songs.find_by_collection_id(collection_id, store)
       end
     end
   end

data/lib/itunes_api/music/artist.rb

@@ -2,19 +2,33 @@ module ItunesApi
   module Music
     # Artist or Band from the Apple catalog
     class Artist
-      attr_reader_init :data, :store
-      private :data
+      attr_reader_init :apple_id, :genre, :name, :store
 
-      def albums
-        @albums ||= Album.build(data[:albums], store)
-      end
+      class << self
+        def all_apple_ids(name, store)
+          find_all_by_name(name, store).map(&:apple_id)
+        end
+
+        def find_all_by_name(name, store)
+          Requests::Search.artists(name, store).map do |result|
+            new(*result.attributes)
+          end
+        end
 
-      def apple_id
-        @apple_id ||= data[:artistId]
+        def find_by_apple_id(apple_id, store)
+          artist = artist(apple_id, store)
+          artist ? new(*artist.attributes) : nil
+        end
+
+        private
+
+        def artist(apple_id, store)
+          Requests::Artist.find_by_apple_id(apple_id, store)
+        end
       end
 
-      def name
-        @name ||= data[:artistName]
+      def albums
+        @albums ||= Album.for_artist(apple_id, store)
       end
 
       def to_hash

data/lib/itunes_api/music/requests/albums.rb

@@ -0,0 +1,41 @@
+module ItunesApi
+  module Music
+    module Requests
+      # Allows querying the API via lookup for albums.
+      class Albums
+        include Request
+        attr_reader_init :apple_id, :store
+        selfie :find_by_apple_id
+
+        def find_by_apple_id
+          unwrapped_results.map do |result|
+            Results::Album.new(result, store)
+          end
+        end
+
+        private
+
+        def action
+          'lookup'
+        end
+
+        def query
+          {
+            id: apple_id,
+            country: store.to_s.upcase,
+            entity: :album,
+            limit: LIMIT
+          }
+        end
+
+        def unwrapped_results
+          return [] unless results.any?
+
+          results.find_all do |wrappers|
+            wrappers['wrapperType'] == 'collection'
+          end
+        end
+      end
+    end
+  end
+end

data/lib/itunes_api/music/requests/artist.rb

@@ -0,0 +1,32 @@
+module ItunesApi
+  module Music
+    module Requests
+      # Allows querying the API via lookup for artists.
+      class Artist
+        include Request
+        attr_reader_init :apple_id, :store
+        selfie :find_by_apple_id
+
+        def find_by_apple_id
+          return nil unless results.any?
+
+          Results::Artist.new(results.first, store)
+        end
+
+        private
+
+        def action
+          'lookup'
+        end
+
+        def query
+          {
+            id: apple_id,
+            country: store.to_s.upcase,
+            limit: LIMIT
+          }
+        end
+      end
+    end
+  end
+end

data/lib/itunes_api/music/requests/search.rb

@@ -0,0 +1,39 @@
+module ItunesApi
+  module Music
+    module Requests
+      # Allows querying the API via search for artists.
+      class Search
+        include Request
+        attr_reader_init :artist_name, :store
+        selfie :artists
+
+        def artists
+          @artists ||= decorated_results.find_all(&:relevant?)
+        end
+
+        private
+
+        def action
+          'search'
+        end
+
+        def decorated_results
+          results.map do |result|
+            Results::Artist.new(result, store, artist_name)
+          end
+        end
+
+        def query
+          {
+            attribute: 'artistTerm',
+            country: store.to_s.upcase,
+            entity: 'musicArtist',
+            limit: LIMIT,
+            media: 'music',
+            term: artist_name
+          }
+        end
+      end
+    end
+  end
+end

data/lib/itunes_api/music/requests/songs.rb

@@ -0,0 +1,42 @@
+module ItunesApi
+  module Music
+    module Requests
+      # Allows querying the API via lookup for album songs.
+      class Songs
+        include Request
+        attr_reader_init :collection_id, :store
+        selfie :find_by_collection_id
+
+        def find_by_collection_id
+          unwrapped_results.map do |result|
+            Results::Song.new(result)
+          end
+        end
+
+        private
+
+        def action
+          'lookup'
+        end
+
+        def query
+          {
+            entity: 'song',
+            id: collection_id,
+            country: store.to_s.upcase,
+            limit: LIMIT,
+            sort: 'trackNumber'
+          }
+        end
+
+        def unwrapped_results
+          return [] unless results.any?
+
+          results.find_all do |wrappers|
+            wrappers['wrapperType'] == 'track'
+          end
+        end
+      end
+    end
+  end
+end

data/lib/itunes_api/music/requests.rb

@@ -0,0 +1,12 @@
+require_relative 'requests/albums'
+require_relative 'requests/artist'
+require_relative 'requests/search'
+require_relative 'requests/songs'
+
+module ItunesApi
+  module Music
+    # Starting module for request wrappers
+    module Requests
+    end
+  end
+end

data/lib/itunes_api/music/results/album.rb

@@ -0,0 +1,35 @@
+module ItunesApi
+  module Music
+    module Results
+      # Wrapper for album search results.
+      class Album
+        attr_reader_init :data, :store
+        private :data
+
+        def artwork
+          @artwork ||= data['artworkUrl100']
+        end
+
+        def attributes
+          [artwork, collection_id, genre, name, release_on, store]
+        end
+
+        def collection_id
+          @collection_id ||= data['collectionId']
+        end
+
+        def genre
+          @genre ||= data['primaryGenreName']
+        end
+
+        def name
+          @name ||= data['collectionName']
+        end
+
+        def release_on
+          @release_on ||= Date.parse(data['releaseDate'])
+        end
+      end
+    end
+  end
+end

data/lib/itunes_api/music/results/artist.rb

@@ -0,0 +1,33 @@
+module ItunesApi
+  module Music
+    module Results
+      # Wrapper for artist search results.
+      class Artist
+        attr_reader_init :data, :store, search_term: nil
+        private :data, :search_term
+
+        def apple_id
+          @apple_id ||= data['artistId']
+        end
+
+        def attributes
+          [apple_id, genre, name, store]
+        end
+
+        def genre
+          @genre ||= data['primaryGenreName']
+        end
+
+        def name
+          @name ||= data['artistName']
+        end
+
+        def relevant?
+          return true unless search_term
+
+          name.downcase.include?(search_term.downcase)
+        end
+      end
+    end
+  end
+end

data/lib/itunes_api/music/results/song.rb

@@ -0,0 +1,39 @@
+module ItunesApi
+  module Music
+    module Results
+      # Wrapper for song search results.
+      class Song
+        attr_reader_init :data
+        private :data
+
+        def duration
+          @duration ||= track_lenght(data['trackTimeMillis'])
+        end
+
+        def attributes
+          [duration, name, number, streamable]
+        end
+
+        def name
+          @name ||= data['trackName']
+        end
+
+        def number
+          @number ||= data['trackNumber']
+        end
+
+        def streamable
+          @streamable ||= data['isStreamable']
+        end
+
+        private
+
+        def track_lenght(milliseconds)
+          minutes, milliseconds = milliseconds.divmod(1000 * 60)
+          seconds = milliseconds / 1000
+          "#{minutes}:#{seconds}"
+        end
+      end
+    end
+  end
+end

data/lib/itunes_api/music/results.rb

@@ -0,0 +1,11 @@
+require_relative 'results/album'
+require_relative 'results/artist'
+require_relative 'results/song'
+
+module ItunesApi
+  module Music
+    # Starting module for result wrappers
+    module Results
+    end
+  end
+end

data/lib/itunes_api/music/song.rb

@@ -0,0 +1,18 @@
+module ItunesApi
+  module Music
+    # Wrapper for song results.
+    class Song
+      attr_reader_init :duration, :name, :number, :streamable
+      alias streamable? streamable
+
+      def to_hash
+        {
+          duration: duration,
+          name: name,
+          number: number,
+          stremable: streamable?,
+        }
+      end
+    end
+  end
+end

data/lib/itunes_api/music.rb

@@ -0,0 +1,35 @@
+require_relative 'request'
+require_relative 'music/requests'
+require_relative 'music/results'
+require_relative 'music/album'
+require_relative 'music/artist'
+require_relative 'music/song'
+
+module ItunesApi
+  # Public interface for the Music Api
+  module Music
+    class << self
+      def all_apple_ids(name, store = default_store)
+        Artist.all_apple_ids(name, store)
+      end
+
+      def all_artists_by_name(name, store = default_store)
+        Artist.find_all_by_name(name, store)
+      end
+
+      def find_by_apple_id(apple_id, store = default_store)
+        Music::Artist.find_by_apple_id(apple_id, store)
+      end
+
+      def albums_for_artist(apple_id, store = default_store)
+        Music::Album.for_artist(apple_id, store)
+      end
+
+      private
+
+      def default_store
+        ItunesApi::Configuration.instance.country_code || :gb
+      end
+    end
+  end
+end

data/lib/itunes_api/request.rb

@@ -0,0 +1,24 @@
+require 'faraday'
+require 'json'
+module ItunesApi
+  # Allow requests to the iTunes API.
+  module Request
+    def results
+      @results ||= parsed_response.fetch('results') { [] }
+    end
+
+    private
+
+    def parsed_response
+      JSON.parse(response.body)
+    end
+
+    def connection
+      Faraday.new(url: BASE_URL)
+    end
+
+    def response
+      connection.get(action, query)
+    end
+  end
+end

data/lib/itunes_api/version.rb

@@ -1,3 +1,3 @@
 module ItunesApi
-  VERSION = '1.4.1'.freeze
+  VERSION = '2.0.0'.freeze
 end

data/lib/itunes_api.rb

@@ -1,36 +1,13 @@
 require 'selfies'
 require 'itunes_api/configuration'
-require 'itunes_api/requests/all'
-require 'itunes_api/music/all'
+require 'itunes_api/music'
 
 # Interface to the Itunes Api
 module ItunesApi
   BASE_URL = 'https://itunes.apple.com'.freeze
   LIMIT = 200
 
-  def self.artist_ids(name, store = default_store)
-    Requests::Search.artist_ids(name, store)
-  end
-
-  def self.album_lookup(album_id, store = default_store)
-    Music::AlbumLookup.tracklist(album_id, store)
-  end
-
-  def self.artist_lookup(artist_id, store = default_store)
-    Music::ArtistLookup.artist(artist_id, store)
-  end
-
-  def self.artist_search(name, store = default_store)
-    Music::ArtistSearch.artists(name, store)
-  end
-
   def self.configure
     yield(Configuration.instance)
   end
-
-  private
-
-  def self.default_store
-    Configuration.instance.country_code rescue :gb
-  end
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: itunes_api
 version: !ruby/object:Gem::Version
-  version: 1.4.1
+  version: 2.0.0
 platform: ruby
 authors:
 - Mario D’Arco
 autorequire: 
 bindir: exe
 cert_chain: []
-date: 2017-08-03 00:00:00.000000000 Z
+date: 2017-08-04 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: faraday
@@ -52,20 +52,6 @@ dependencies:
     - - ">="
       - !ruby/object:Gem::Version
         version: '0'
-- !ruby/object:Gem::Dependency
-  name: coveralls
-  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: rake
   requirement: !ruby/object:Gem::Requirement
@@ -94,20 +80,6 @@ dependencies:
     - - ">="
       - !ruby/object:Gem::Version
         version: '0'
-- !ruby/object:Gem::Dependency
-  name: simplecov
-  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: rubocop
   requirement: !ruby/object:Gem::Requirement
@@ -155,18 +127,20 @@ files:
 - itunes_api.gemspec
 - lib/itunes_api.rb
 - lib/itunes_api/configuration.rb
+- lib/itunes_api/music.rb
 - lib/itunes_api/music/album.rb
-- lib/itunes_api/music/album_lookup.rb
-- lib/itunes_api/music/all.rb
 - lib/itunes_api/music/artist.rb
-- lib/itunes_api/music/artist_lookup.rb
-- lib/itunes_api/music/artist_search.rb
-- lib/itunes_api/music/track.rb
-- lib/itunes_api/requests/album_tracklist.rb
-- lib/itunes_api/requests/all.rb
-- lib/itunes_api/requests/base.rb
-- lib/itunes_api/requests/lookup.rb
-- lib/itunes_api/requests/search.rb
+- lib/itunes_api/music/requests.rb
+- lib/itunes_api/music/requests/albums.rb
+- lib/itunes_api/music/requests/artist.rb
+- lib/itunes_api/music/requests/search.rb
+- lib/itunes_api/music/requests/songs.rb
+- lib/itunes_api/music/results.rb
+- lib/itunes_api/music/results/album.rb
+- lib/itunes_api/music/results/artist.rb
+- lib/itunes_api/music/results/song.rb
+- lib/itunes_api/music/song.rb
+- lib/itunes_api/request.rb
 - lib/itunes_api/version.rb
 homepage: https://github.com/mariodarco/itunes-api
 licenses:

data/lib/itunes_api/music/album_lookup.rb

@@ -1,21 +0,0 @@
-module ItunesApi
-  module Music
-    # Album Tracklist resulting from a specific lookup
-    class AlbumLookup
-      attr_reader_init :album_id, :store
-      selfie :tracklist
-
-      def tracklist
-        return [] unless songs_data
-
-        Track.build(songs_data)
-      end
-
-      private
-
-      def songs_data
-        @songs_data ||= Requests::AlbumTracklist.songs(album_id, store)
-      end
-    end
-  end
-end

data/lib/itunes_api/music/all.rb

@@ -1,6 +0,0 @@
-require_relative 'album'
-require_relative 'artist'
-require_relative 'album_lookup'
-require_relative 'artist_lookup'
-require_relative 'artist_search'
-require_relative 'track'

data/lib/itunes_api/music/artist_lookup.rb

@@ -1,25 +0,0 @@
-module ItunesApi
-  module Music
-    # Artist or Band resulting from a specific lookup
-    class ArtistLookup
-      attr_reader_init :artist_id, :store
-      selfie :artist, :store
-
-      def artist
-        build_artist
-      end
-
-      private
-
-      def build_artist
-        return lookup unless lookup
-
-        Artist.new(lookup, store)
-      end
-
-      def lookup
-        @lookup ||= Requests::Lookup.artist_with_albums(artist_id, store)
-      end
-    end
-  end
-end

data/lib/itunes_api/music/artist_search.rb

@@ -1,31 +0,0 @@
-module ItunesApi
-  module Music
-    # Artists or Bands resulting from a search
-    class ArtistSearch
-      attr_reader_init :name, :store
-      selfie :artists
-
-      def artists
-        @artists ||= artist_ids.map { |id| build_artist(id) }.compact
-      end
-
-      private
-
-      def artist_ids
-        @search ||= ItunesApi.artist_ids(name, store)
-      end
-
-      def build_artist(id)
-        if (lookup = lookup(id))
-          Artist.new(lookup, store)
-        end
-      end
-
-      def lookup(id)
-        Requests::Lookup.artist_with_albums(id, store)
-      rescue
-        nil
-      end
-    end
-  end
-end

data/lib/itunes_api/music/track.rb

@@ -1,46 +0,0 @@
-module ItunesApi
-  module Music
-    # Wrapper for song results.
-    class Track
-      attr_reader_init :data
-      private :data
-
-      def self.build(songs_data)
-        songs_data.map { |data| new(data) }
-      end
-
-      def duration
-        @duration ||= track_lenght(data[:trackTimeMillis])
-      end
-
-      def name
-        @name ||= data[:trackName]
-      end
-
-      def number
-        data[:trackNumber]
-      end
-
-      def streamable?
-        data[:isStreamable]
-      end
-
-      def to_hash
-        {
-          duration: duration,
-          name: name,
-          number: number,
-          stremable: stremable?,
-        }
-      end
-
-      private
-
-      def track_lenght(milliseconds)
-        minutes, milliseconds = milliseconds.divmod(1000 * 60)
-        seconds = milliseconds / 1000
-        "#{minutes}:#{seconds}"
-      end
-    end
-  end
-end

data/lib/itunes_api/requests/album_tracklist.rb

@@ -1,36 +0,0 @@
-module ItunesApi
-  module Requests
-    # Allows querying the API via lookup for album songs.
-    class AlbumTracklist
-      include Base
-      attr_reader_init :album_id, :store
-      selfie :songs
-
-      def songs
-        songs_data.map do |song|
-          symbolize_keys(unwrapped(song))
-        end
-      end
-
-      private
-
-      def action
-        'lookup'
-      end
-
-      def songs_data
-        results.find_all { |wrappers| wrappers['wrapperType'] == 'track' }
-      end
-
-      def query
-        {
-          entity: 'song',
-          id: album_id,
-          country: store.to_s.upcase,
-          limit: LIMIT,
-          sort: 'trackNumber'
-        }
-      end
-    end
-  end
-end

data/lib/itunes_api/requests/all.rb

@@ -1,4 +0,0 @@
-require_relative 'base'
-require_relative 'album_tracklist'
-require_relative 'lookup'
-require_relative 'search'

data/lib/itunes_api/requests/base.rb

@@ -1,37 +0,0 @@
-require 'faraday'
-require 'json'
-module ItunesApi
-  module Requests
-    # Allow requests to the iTunes API.
-    module Base
-      def results
-        @results ||= parsed_response.fetch('results') { [] }
-      end
-
-      private
-
-      def parsed_response
-        JSON.parse(response.body)
-      end
-
-      def connection
-        Faraday.new(url: BASE_URL)
-      end
-
-      def response
-        connection.get(action, query)
-      end
-
-      def symbolize_keys(hash)
-        hash.each_with_object({}) do |(key, value), new_hash|
-          new_hash[key.to_sym] = value
-          new_hash
-        end
-      end
-
-      def unwrapped(data_hash)
-        data_hash.tap { |hash| hash.delete('wrapperType') }
-      end
-    end
-  end
-end

data/lib/itunes_api/requests/lookup.rb

@@ -1,54 +0,0 @@
-module ItunesApi
-  module Requests
-    # Allows querying the API via lookup.
-    class Lookup
-      include Base
-      attr_reader_init :artist_id, :store
-      selfie :artist_with_albums
-
-      def artist_with_albums
-        return artist unless artist
-
-        artist.merge(albums: albums)
-      end
-
-      private
-
-      def action
-        'lookup'
-      end
-
-      def albums
-        albums_data.map do |album|
-          symbolize_keys(unwrapped(album))
-        end
-      end
-
-      def albums_data
-        results.find_all { |wrappers| wrappers['wrapperType'] == 'collection' }
-      end
-
-      def artist
-        return artist_data unless artist_data
-
-        symbolize_keys(unwrapped(artist_data))
-      end
-
-      def artist_data
-        @artist_data ||= results.find do |wrappers|
-          wrappers['wrapperType'] == 'artist'
-        end
-      end
-
-      def query
-        {
-          entity: 'album',
-          id: artist_id,
-          country: store.to_s.upcase,
-          limit: LIMIT,
-          sort: 'recent'
-        }
-      end
-    end
-  end
-end

data/lib/itunes_api/requests/search.rb

@@ -1,38 +0,0 @@
-module ItunesApi
-  module Requests
-    # Fetch all the artist ids corresponding to a search term
-    class Search
-      include Base
-      attr_reader_init :artist_name, :store
-      selfie :artist_ids
-
-      def artist_ids
-        results.collect do |result|
-          name_in?(result['artistName']) && result['artistId']
-        end.compact.uniq
-      end
-
-      private
-
-      def action
-        'search'
-      end
-
-      def name_in?(complete_name)
-        complete_name.downcase.include?(artist_name.downcase) ? true : nil
-      end
-
-      def query
-        {
-          attribute: 'artistTerm',
-          entity: 'musicArtist',
-          term: artist_name,
-          country: store.to_s.upcase,
-          limit: LIMIT,
-          media: 'music',
-          sort: 'recent'
-        }
-      end
-    end
-  end
-end