songkickr 0.3.3 → 0.4.0

data/lib/songkickr/remote.rb

@@ -1,205 +1,34 @@
+Dir[File.dirname(__FILE__) + '/remote_api/*.rb'].each { |file| require file }
+
 module Songkickr
   # Create an instance of the remote class to interact with the Songkick API.
   class Remote
     include HTTParty
+    include Songkickr::RemoteApi::UpcomingEvents
+    include Songkickr::RemoteApi::UserEventsAndTrackings
+    include Songkickr::RemoteApi::PastEvents
+    include Songkickr::RemoteApi::ArtistDetails
+    include Songkickr::RemoteApi::EventDetails
+    include Songkickr::RemoteApi::VenueDetails
+    include Songkickr::RemoteApi::SimilarArtists
+
+    attr_accessor :debug
+    attr_reader :api_key
+
     base_uri 'api.songkick.com/api/3.0'
     format :json
 
-    attr_reader :api_key
-
     # ==== Create a new instance of the remote class to talk to Songkick
     # Get an API key for your app from http://developer.songkick.com/
-    def initialize(api_key = nil)
+    def initialize(api_key = nil, options = {})
       @api_key = api_key
       @api_key ||= Songkickr.api_key
+      @debug = options[:debug] || false
 
       self.class.default_params :apikey => @api_key
-    end
-
-    # ==== Event Search API
-    # http://www.songkick.com/developer/event-search
-    #
-    # === Parameters
-    # * +query+ - A hash of query parameters, see below for options.
-    #
-    # _Example:_ <code>{ :type => 'concert', :artists => 'Coolio' }</code>
-    #
-    # ==== Query Parameters
-    # * +type+ - valid types: concert or festival
-    # * +artists+ - events by any of the artists, comma-separated
-    # * +artist_name+ - plain text name of artist ex. 'As I Lay Dying', 'Parkway Drive', 'Animals As Leaders'
-    # * +artist_id+ - Songkick unique ID for an artist
-    # * +venue_id+ - Songkick unique ID for a venue
-    # * +setlist_item_name+ - name of a song which was played at the event – use with artist_id or artist_name
-    # * +min_date+ - Oldest date for which you want to look for events
-    # * +max_date+ - Most recent date for which you want to look for events
-    # * +location+ - See the Songkick website for instructions on how to use the location parameter http://www.songkick.com/developer/location-search
-    def events(query = {})
-      path = extract_path_from_query(query)
-      result = get("#{path}/events.json", :query => query)
-      Songkickr::EventResult.new result
-    end
-
-    # ==== Event API
-    # http://www.songkick.com/developer/upcoming-events
-    #
-    # Getting detailed information of a single event.
-    #
-    # === Parameters
-    # * +event_id+ - Songkick event ID. Extract the event ID either from a previous API call or from the URL of the event page on the website.
-    def event(event_id)
-      result = get("/events/#{event_id}.json")
-      Songkickr::Event.new result["resultsPage"]["results"]["event"]
-    end
-
-    # ==== Gigography API
-    # http://groups.google.com/group/songkick-api/browse_thread/thread/af15b9a6ad3c3513#
-    #
-    # === Parameters
-    # * +artist_id+ - Songkick artist_id, use artist_search to get it
-    # * +query+ - A hash of query parameters, see below for options.
-    #
-    # ==== Query Parameters
-    # * +min_date+ - Oldest date for which you want to look for events
-    # * +max_date+ - Most recent date for which you want to look for events
-    # * +per_page+ - Number of items on a page
-    # * +page+ - Number of page
-    def gigography(artist_id, query= {})
-      result = get("/artists/#{artist_id}/gigography.json",:query=>query)
-      Songkickr::EventResult.new result
-    end
-
-    # === Artist API
-    # Undocumented, but it works fine
-    #
-    # Returns an artist object
-    #
-    # === Parameters
-    #  * +artist_id+ - Songkick artist_id, use artist_search to get it
-    def artist(artist_id)
-      result = get("/artists/#{artist_id}.json")
-      Songkickr::Artist.new result["resultsPage"]["results"]["artist"]
-    end
-
-    # ==== Artist Search API
-    # Returns Artist objects.
-    #
-    # http://www.songkick.com/developer/artist-search
-    #
-    # === Parameters
-    # * +query+ - Search for artists by name using full text search. Results from Songkick are returned by relevancy.
-    #
-    # ==== Query Parameters
-    # * +artist_name+ - Name of an artist. <em>Ex. 'Lady Gaga', 'Slayer', 'Atmosphere'</em>
-    def artist_search(query={})
-      result = get("/search/artists.json", :query => query)
-      Songkickr::ArtistResult.new result
-    end
-
-    # ==== Artist calendar (Upcoming)
-    # Returns an array of Events.
-    #
-    # http://www.songkick.com/developer/upcoming-events-for-artist
-    #
-    # === Parameters
-    # * +artist_id+ - Songkick unique ID for artist. Use artist_search to find an artist ID.
-    # * +query+ - A hash of query parameters, see below for options.
-    #
-    # ==== Query Parameters
-    # * +page+ - Page number
-    # * +per_page+ - Number of results per page, max 50.
-    def artist_events(artist_id, query = {})
-      result = get("/artists/#{artist_id}/calendar.json", :query => query)
-      Songkickr::EventResult.new result
-    end
-
-    # ==== User Events API
-    # http://www.songkick.com/developer/upcoming-events-for-user
-    #
-    # === Parameters
-    # * +username+ - A Songkick username.
-    # * +query+ - A hash of query parameters, see below for options.
-    #
-    # ==== Query Parameters
-    # * +attendance+ (all, im_going, i_might_go) - defaults to im_going
-    # * +type+ (concert or festival)
-    # * +artists+ (events by any of the artists, comma-separated)
-    # * +artist_id+ - Songkick unique ID for an artist
-    # * +venue_id+ - Songkick unique ID for a venue
-    # * +setlist_item_name+ (name of a song which was played at the event – use with artist_id or artist_name)
-    # * +min_date+ - Oldest date for which you want to look for events
-    # * +max_date+ - Most recent date for which you want to look for events
-    # * +location+ - see the Songkick website for instructions on how to use the location parameter
-    def users_events(username, query = {})
-      result = get("/users/#{username}/events.json", :query => query)
-      Songkickr::EventResult.new result
-    end
-
-    # ==== User Tracked Artists
-    # http://www.songkick.com/developer/trackings
-    #
-    # === Parameters
-    # * +username+ - A Songkick username.
-    # * +query+ - A hash of query parameters, see below for options.
-    #
-    # ==== Query Parameters
-    # * +page+ - Page number
-    # * +per_page+ - Number of results per page, max 50.
-    def users_tracked_artists(username, query = {})
-      result = get("/users/#{username}/artists/tracked.json", :query => query)
-      Songkickr::ArtistResult.new result
-    end
-
-    # ==== Metro Area Events (Upcoming)
-    # Returns an array of Events.
-    #
-    # http://www.songkick.com/developer/upcoming-events-for-metro-area
-    #
-    # === Parameters
-    # * +metro_area_id+ - Songkick unique ID for metro areas. Use location_search to find a metro area ID.
-    # * +query+ - A hash of query parameters, see below for options.
-    #
-    # ==== Query Parameters
-    # * +page+ - Page number
-    # * +per_page+ - Number of results per page, max 50.
-    def metro_areas_events(metro_area_id, query = {})
-      result = get("/metro_areas/#{metro_area_id}/calendar.json", :query => query)
-      Songkickr::EventResult.new result
-    end
-
-    # ==== Concert Setlists API
-    # http://www.songkick.com/developer/setlists
-    #
-    # === Parameters
-    #
-    # * +event_id+ - Songkick event ID. Extract the event ID either from a previous API call or from the URL of the event page on the website.
-    def concert_setlists(event_id)
-      result = get("/events/#{event_id}/setlists.json")
-      Songkickr::ConcertSetlistResult.new result
-    end
-
-    # ==== Location Search API
-    # http://www.songkick.com/developer/location-search
-    #
-    # === Parameters
-    # * +query+ - A hash of query parameters, see below for options.
-    #
-    # ==== Query Parameters
-    # * +location+ - 'geo:{lat,lng}' string <em>Ex. 'geo:{-0.128,51.5078}'</em>
-    def location_search(query = {})
-      result = get("/search/locations.json", :query => query)
-      Songkickr::LocationResult.new result
-    end
-
-    # ==== Venue Search
-    # http://www.songkick.com/developer/venue-details
-    #
-    # === Parameters
-    #
-    # * +venue_id+ - Songkick venue ID.
-    def venue(venue_id)
-      result = get("/venues/#{venue_id}.json")
-      Songkickr::Venue.new result['resultsPage']['results']['venue']
+      if @debug
+        self.class.debug_output $stderr
+      end
     end
 
     def get(location, query_params = {})
@@ -212,14 +41,5 @@ module Songkickr
       end
       result
     end
-
-
-    private
-
-      # Given a query, look for an mbid key and return a path to access it.
-      def extract_path_from_query(query = {})
-        mbid = query.delete :mbid
-        "/artists/mbid:#{mbid}" if mbid
-      end
   end
 end

data/lib/songkickr/remote_api/artist_details.rb

@@ -0,0 +1,17 @@
+module Songkickr
+  module RemoteApi
+    module ArtistDetails
+      # === Artist API
+      # Undocumented, but it works fine
+      #
+      # Getting detailed information of a single artist.
+      #
+      # === Parameters
+      #  * +artist_id+ - Songkick artist_id, use artist_search to get it
+      def artist(artist_id)
+        result = get("/artists/#{artist_id}.json")
+        Songkickr::Artist.new result["resultsPage"]["results"]["artist"]
+      end
+    end
+  end
+end

data/lib/songkickr/remote_api/event_details.rb

@@ -0,0 +1,17 @@
+module Songkickr
+  module RemoteApi
+    module EventDetails
+      # ==== Event API
+      # http://www.songkick.com/developer/upcoming-events
+      #
+      # Getting detailed information of a single event.
+      #
+      # === Parameters
+      # * +event_id+ - Songkick event ID. Extract the event ID either from a previous API call or from the URL of the event page on the website.
+      def event(event_id)
+        result = get("/events/#{event_id}.json")
+        Songkickr::Event.new result["resultsPage"]["results"]["event"]
+      end
+    end
+  end
+end

data/lib/songkickr/remote_api/past_events.rb

@@ -0,0 +1,48 @@
+module Songkickr
+  module RemoteApi
+    module PastEvents
+      # ==== Artists Gigography API
+      # https://www.songkick.com/developer/past-events-for-artist
+      #
+      # === Parameters
+      # * +artist_id+ - Songkick artist_id, use artist_search to get it
+      # * +query+ - A hash of query parameters, see below for options.
+      #
+      # ==== Query Parameters
+      # * +per_page+ - Number of items on a page
+      # * +page+ - Number of page
+      # * +order+ - 'asc' or 'desc', 'asc' by default
+      def artists_gigography(artist_id, query = {})
+        result = self.class.get("/artists/#{artist_id}/gigography.json", :query => query)
+        Songkickr::EventResult.new result
+      end
+
+      # ==== User’s past events (gigography)
+      # https://www.songkick.com/developer/past-events-for-user
+      #
+      # === Parameters
+      # * +username+ - A Songkick username
+      # * +query+ - A hash of query parameters, see below for options.
+      #
+      # ==== Query Parameters
+      # * +per_page+ - Number of items on a page
+      # * +page+ - Number of page
+      # * +order+ - 'asc' or 'desc', 'asc' by default
+      def users_gigography(username, query = {})
+        result = self.class.get("/users/#{username}/gigography.json", :query => query)
+        Songkickr::EventResult.new result
+      end
+
+      # ==== Concert Setlists API
+      # http://www.songkick.com/developer/setlists
+      #
+      # === Parameters
+      #
+      # * +event_id+ - Songkick event ID. Extract the event ID either from a previous API call or from the URL of the event page on the website.
+      def concert_setlists(event_id)
+        result = get("/events/#{event_id}/setlists.json")
+        Songkickr::ConcertSetlistResult.new result
+      end
+    end
+  end
+end

data/lib/songkickr/remote_api/similar_artists.rb

@@ -0,0 +1,14 @@
+module Songkickr
+  module RemoteApi
+    module SimilarArtists
+      # ==== Similar Artists
+      # Returns an array of Artists similar to a given artist, based on tracking and attendance data
+      #
+      # https://www.songkick.com/developer/similar-artists
+      def similar_artists(artist_id)
+        result = get("/artists/#{artist_id}/similar_artists.json")
+        Songkickr::ArtistResult.new result
+      end
+    end
+  end
+end

data/lib/songkickr/remote_api/upcoming_events.rb

@@ -0,0 +1,125 @@
+module Songkickr
+  module RemoteApi
+    module UpcomingEvents
+      # ==== Artist calendar (Upcoming)
+      # Returns an array of Events.
+      #
+      # ex. remote.artist_events('mbid:5bac9b4f-2f1c-4d39-8d11-231d5b6650ce', :page => 1, :per_page => 5, :order => 'desc')
+      #
+      # http://www.songkick.com/developer/upcoming-events-for-artist
+      #
+      # === Parameters
+      # * +artist_id_or_music_brainz_id+ - Songkick unique ID for artist. Use artist_search to find an artist ID. Or a MusicBrainz.org id string. ex. mbid:5bac9b4f-2f1c-4d39-8d11-231d5b6650ce
+      # * +query+ - A hash of query parameters, see below for options.
+      #
+      # ==== Query Parameters
+      # * +page+ - Page number
+      # * +per_page+ - Number of results per page, max 50.
+      # * +order+ - Results are sorted by date. The order can be specified with: order ('asc' or 'desc', 'asc' by default).
+      def artist_events(artist_id_or_music_brainz_id, query = {})
+        if artist_id_or_music_brainz_id.to_s.match /^mbid\:\d+$/
+          url = "/artists/mbid:#{artist_id_or_music_brainz_id}/calendar.json"
+        else
+          url = "/artists/#{artist_id_or_music_brainz_id}/calendar.json"
+        end
+
+        result = get(url, :query => query)
+        Songkickr::EventResult.new result
+      end
+
+      # ==== Artist Search API
+      # Returns Artist objects.
+      #
+      # http://www.songkick.com/developer/artist-search
+      #
+      # === Parameters
+      # * +query+ - Search for artists by name using full text search. Results from Songkick are returned by relevancy.
+      #
+      # ==== Query Parameters
+      # * +artist_name+ - Name of an artist. <em>Ex. 'Lady Gaga', 'Slayer', 'Atmosphere'</em>
+      def artist_search(query = {})
+        result = self.class.get("/search/artists.json", :query => { :query => query })
+        Songkickr::ArtistResult.new result
+      end
+
+      # ==== Event Search API
+      # http://www.songkick.com/developer/event-search
+      #
+      # === Parameters
+      # * +query+ - A hash of query parameters, see below for options.
+      #
+      # _Example:_ <code>{ :type => 'concert', :artists => 'Coolio' }</code>
+      #
+      # ==== Query Parameters
+      # * +type+ - valid types: concert or festival
+      # * +artists+ - events by any of the artists, comma-separated
+      # * +artist_name+ - plain text name of artist ex. 'As I Lay Dying', 'Parkway Drive', 'Animals As Leaders'
+      # * +artist_id+ - Songkick unique ID for an artist
+      # * +venue_id+ - Songkick unique ID for a venue
+      # * +setlist_item_name+ - name of a song which was played at the event – use with artist_id or artist_name
+      # * +min_date+ - Oldest date for which you want to look for events
+      # * +max_date+ - Most recent date for which you want to look for events
+      # * +location+ - See the Songkick website for instructions on how to use the location parameter http://www.songkick.com/developer/location-search
+      def events(query = {})
+        result = get("/events.json", :query => query)
+        Songkickr::EventResult.new result
+      end
+
+      # ==== Location Search API
+      # http://www.songkick.com/developer/location-search
+      #
+      # === Parameters
+      # * +query+ - A hash of query parameters, see below for options.
+      #
+      # ==== Query Parameters
+      # * +name+ - Metro area or city named 'location_name' string <em>Ex. 'Minneapolis, Nashville, or London'</em>
+      # * +location+ - 'geo:{lat,lng}' string <em>Ex. 'geo:{-0.128,51.5078}'</em>
+      # * +ip+ - 'ip:{ip-addr}' string <em>Ex. 'ip:{123.123.123.123}'</em>
+      # * +page+ - Page number
+      # * +per_page+ - Number of results per page, max 50.
+      def location_search(query = {})
+        result = get("/search/locations.json", :query => { :query => query })
+        Songkickr::LocationResult.new result
+      end
+
+      # ==== Metro Area Events (Upcoming)
+      # Returns an array of Events.
+      #
+      # http://www.songkick.com/developer/upcoming-events-for-metro-area
+      #
+      # === Parameters
+      # * +metro_area_id+ - Songkick unique ID for metro areas. Use location_search to find a metro area ID.
+      # * +query+ - A hash of query parameters, see below for options.
+      #
+      # ==== Query Parameters
+      # * +page+ - Page number
+      # * +per_page+ - Number of results per page, max 50.
+      def metro_areas_events(metro_area_id, query = {})
+        result = get("/metro_areas/#{metro_area_id}/calendar.json", :query => query)
+        Songkickr::EventResult.new result
+      end
+
+      # ==== Venue Calendar
+      # https://www.songkick.com/developer/upcoming-events-for-venue
+      #
+      # === Parameters
+      #
+      # * +venue_id+ - Songkick venue ID.
+      def venue_calendar(venue_id)
+        result = get("/venues/#{venue_id}/calendar.json")
+        Songkickr::EventResult.new result
+      end
+
+      # ==== Venue Search
+      # https://www.songkick.com/developer/venue-search
+      #
+      # === Parameters
+      #
+      # * +query+ -
+      def venue_search(query)
+        result = get("/search/venues.json", :query => { :query => query })
+        Songkickr::VenueResult.new result
+      end
+    end
+  end
+end

data/lib/songkickr/remote_api/user_events_and_trackings.rb

@@ -0,0 +1,143 @@
+module Songkickr
+  module RemoteApi
+    module UserEventsAndTrackings
+      # ==== Users Tracked Events Calendar
+      # Returns a list of calendar entries with events for a user's tracked artists in her tracked metro areas.
+      # /users/#{username}/calendar.json?reason=tracked_artist
+      #
+      # === Parameters
+      # * +username+ - A Songkick username.
+      # * +query+ - A hash of query parameters, see below for options.
+      #
+      # ==== Query Parameters
+      # * +page+ - Page number
+      # * +per_page+ - Number of results per page, max 50.
+      def users_tracked_events_calendar(username, query = {})
+        result = get("/users/#{username}/calendar.json?reason=tracked_artist", :query => query)
+        Songkickr::CalendarResult.new result
+      end
+
+      # ==== User Attendance Calendar
+      # Returns a list of calendar entries with events that a user is planning to attend.
+      # /users/#{username}/calendar.json?reason=attendance
+      #
+      # === Parameters
+      # * +username+ - A Songkick username.
+      # * +query+ - A hash of query parameters, see below for options.
+      #
+      # ==== Query Parameters
+      # * +page+ - Page number
+      # * +per_page+ - Number of results per page, max 50.
+      def users_attendance_calendar(username, query = {})
+        result = get("/users/#{username}/calendar.json?reason=attendance", :query => query)
+        Songkickr::CalendarResult.new result
+      end
+
+
+      # ==== User Tracked Metro Areas
+      # http://www.songkick.com/developer/trackings
+      #
+      # === Parameters
+      # * +username+ - A Songkick username.
+      # * +query+ - A hash of query parameters, see below for options.
+      #
+      # ==== Query Parameters
+      # * +page+ - Page number
+      # * +per_page+ - Number of results per page, max 50.
+      def users_tracked_metro_areas(username, query = {})
+        result = get("/users/#{username}/metro_areas/tracked.json", :query => query)
+        Songkickr::MetroAreaResult.new result
+      end
+
+      # ==== User Metro Area Tracking
+      # http://www.songkick.com/developer/trackings
+      #
+      # === Parameters
+      # * +username+ - A Songkick username.
+      # * +metro_area_id+ - A Songkick metro area ID.
+      # * +query+ - A hash of query parameters, see below for options.
+      def users_metro_area_tracking(username, metro_area_id, query = {})
+        result = get("/users/#{username}/trackings/metro_area:#{metro_area_id}.json", :query => query)
+        Songkickr::MetroAreaResult.new result
+      end
+
+      # ==== User Tracked Artists
+      # http://www.songkick.com/developer/trackings
+      #
+      # === Parameters
+      # * +username+ - A Songkick username.
+      # * +query+ - A hash of query parameters, see below for options.
+      #
+      # ==== Query Parameters
+      # * +page+ - Page number
+      # * +per_page+ - Number of results per page, max 50.
+      def users_tracked_artists(username, query = {})
+        result = get("/users/#{username}/artists/tracked.json", :query => query)
+        Songkickr::ArtistResult.new result
+      end
+
+      # ==== User Artist Tracking
+      # http://www.songkick.com/developer/trackings
+      #
+      # === Parameters
+      # * +username+ - A Songkick username.
+      # * +artist_id+ - A Songkick artist ID.
+      def users_artist_tracking(username, artist_id)
+        result = get("/users/#{username}/trackings/artist:#{artist_id}.json")
+        Songkickr::ArtistResult.new result
+      end
+
+      # ==== User Muted Artists
+      # http://www.songkick.com/developer/trackings
+      #
+      # === Parameters
+      # * +username+ - A Songkick username.
+      # * +query+ - A hash of query parameters, see below for options.
+      #
+      # ==== Query Parameters
+      # * +page+ - Page number
+      # * +per_page+ - Number of results per page, max 50.
+      def users_muted_artists(username, query = {})
+        result = get("/users/#{username}/artists/muted.json", :query => query)
+        Songkickr::ArtistResult.new result
+      end
+
+      # ==== User Events API
+      # http://www.songkick.com/developer/upcoming-events-for-user
+      #
+      # === Parameters
+      # * +username+ - A Songkick username.
+      # * +query+ - A hash of query parameters, see below for options.
+      #
+      # ==== Query Parameters
+      # * +page+ - Page number
+      # * +per_page+ - Number of results per page, max 50.
+      # * +attendance+ (all, im_going, i_might_go) - defaults to im_going
+      # * +type+ (concert or festival)
+      # * +artists+ (events by any of the artists, comma-separated)
+      # * +artist_id+ - Songkick unique ID for an artist
+      # * +venue_id+ - Songkick unique ID for a venue
+      # * +setlist_item_name+ (name of a song which was played at the event – use with artist_id or artist_name)
+      # * +min_date+ - Oldest date for which you want to look for events
+      # * +max_date+ - Most recent date for which you want to look for events
+      # * +location+ - see the Songkick website for instructions on how to use the location parameter
+      # * +order+ - 'asc' or 'desc', 'asc' by default
+      # * +created_after+ - timestamp using ISO8601 format, e.g. 2012-02-29T13:37:00Z
+      def users_events(username, query = {})
+        result = get("/users/#{username}/events.json", :query => query)
+        Songkickr::EventResult.new result
+      end
+
+      # ==== User Attendance
+      # http://www.songkick.com/developer/trackings
+      #
+      # === Parameters
+      # * +username+ - A Songkick username.
+      # * +event_id+ - A Songkick event/concert ID.
+      def users_attendance(username, event_id)
+        result = get("/users/#{username}/trackings/event:#{event_id}.json")
+        Songkickr::TrackingResult.new result
+      end
+    end
+  end
+end

data/lib/songkickr/remote_api/venue_details.rb

@@ -0,0 +1,16 @@
+module Songkickr
+  module RemoteApi
+    module VenueDetails
+      # ==== Venue Details
+      # http://www.songkick.com/developer/venue-details
+      #
+      # === Parameters
+      #
+      # * +venue_id+ - Songkick venue ID.
+      def venue(venue_id)
+        result = get("/venues/#{venue_id}.json")
+        Songkickr::Venue.new result['resultsPage']['results']['venue']
+      end
+    end
+  end
+end

data/lib/songkickr/result_set.rb

@@ -0,0 +1,27 @@
+module Songkickr
+  class ResultSet
+    attr_accessor :page, :per_page, :total_entries, :results, :result_type, :result_key_string, :status
+
+    def initialize(result_hash = {})
+      # @result_type = "Event" or "MetroArea"
+      results_page = result_hash["resultsPage"]
+
+      if results_page
+        @status        = results_page["status"]                if results_page.include? "status"
+        @page          = results_page["page"]                  if results_page.include? "page"
+        @per_page      = results_page["per_page"]              if results_page.include? "per_page"
+        @total_entries = results_page["totalEntries"]          if results_page.include? "totalEntries"
+        @results       = parse_results results_page["results"] if results_page.include? "results"
+      end
+    end
+
+    protected
+
+      def parse_results(results = {})
+        return [] unless results.include? result_key_string
+        results[result_key_string].inject([]) do |result_items, result_item|
+          result_items << eval("Songkickr::#{result_type}.new(#{result_item})")
+        end
+      end
+  end
+end