echonest 0.3.0

data/lib/echonest.rb

@@ -0,0 +1,56 @@
+
+require 'happymapper'
+require 'open-uri'
+require 'activesupport'
+require 'delegate'
+
+module EchoNest
+   def self.api_key=(api_key)
+    @api_key = api_key
+   end  
+   
+   def self.api_key
+    @api_key
+   end  
+
+end
+
+require "echonest/api_request.rb"
+require "echonest/paged_result.rb"
+
+require "echonest/artist.rb"
+require "echonest/xml/artist_doc.rb"
+
+require "echonest/xml/artist_search_results.rb"
+
+require "echonest/xml/audio_doc.rb"
+require "echonest/xml/audio_results.rb"
+require "echonest/xml/audio_result.rb"
+
+require "echonest/xml/blogs_doc.rb"
+require "echonest/xml/blogs_results.rb"
+require "echonest/xml/blogs_result.rb"
+
+require "echonest/xml/familiarity_result.rb"
+
+require "echonest/xml/hotttnesss_result.rb"
+
+require "echonest/xml/news_doc.rb"
+require "echonest/xml/news_results.rb"
+require "echonest/xml/news_result.rb"
+
+require "echonest/xml/profile_result.rb"
+
+require "echonest/xml/reviews_doc.rb"
+require "echonest/xml/reviews_results.rb"
+require "echonest/xml/reviews_result.rb"
+
+require "echonest/xml/similar_doc.rb"
+require "echonest/xml/similar_results.rb"
+require "echonest/xml/similar_result.rb"
+
+require "echonest/xml/urls_result.rb"
+
+require "echonest/xml/video_doc.rb"
+require "echonest/xml/video_results.rb"
+require "echonest/xml/video_result.rb"

data/lib/echonest/api_request.rb

@@ -0,0 +1,26 @@
+
+module EchoNest
+  class ApiRequest
+  
+    def initialize(resource, options)
+      @options = {:version =>3, :api_key => EchoNest.api_key}.merge(options)
+      @resource = resource
+    end
+    
+    def uri
+      "http://developer.echonest.com/api/#{@resource}?#{query_string(@options)}"
+    end
+    
+    def fetch
+      open(uri).read
+    end
+    
+    private
+    
+    def query_string(options)
+      options.keys.map { |key| "#{key.to_s}=#{URI.encode(options[key].to_s)}" }.join('&')
+    end
+  
+  end
+
+end

data/lib/echonest/artist.rb

@@ -0,0 +1,74 @@
+
+module EchoNest
+  class Artist
+    attr_accessor :id
+    
+    def initialize(id=nil)
+      @id = id if id
+    end
+    
+    def self.service(name, options = {})
+    
+      define_method "get_#{name.to_s}" do |*args|
+        options = args[0] if args.length == 1
+        options = {:id => id}.merge(options)
+        request = ApiRequest.new("get_#{name.to_s}", options)
+        "Xml::#{name.to_s.titleize}Result".constantize.parse request.fetch
+      end
+
+      if !options[:singular]
+        define_method name do
+          return instance_variable_get("@#{name.to_s}") if instance_variable_get("@#{name.to_s}")
+          result = self.send("get_#{name.to_s}")
+          pager = Proc.new { |start, rows| 
+            self.send("get_#{name.to_s}", :start => start, :rows => rows).results
+          }
+          page = PagedResult.new result.results, pager 
+          instance_variable_set("@#{name.to_s}",  page)
+        end
+      else
+        if !options[:provides]
+          define_method name do
+            return instance_variable_get("@#{name.to_s}") if instance_variable_get("@#{name.to_s}")
+            result = self.send("get_#{name.to_s}")
+            instance_variable_set("@#{name.to_s}", result.artist.send(name))
+          end
+        else
+
+          define_method name do
+            return instance_variable_get("@#{name.to_s}") if instance_variable_get("@#{name.to_s}")
+            result = self.send("get_#{name.to_s}")
+            instance_variable_set("@#{name.to_s}", result.artist)
+          end
+
+          options[:provides].each do |prop|
+            define_method prop do
+              return instance_variable_get("@#{prop.to_s}") if instance_variable_get("@#{prop.to_s}")
+              instance_variable_set("@#{prop.to_s}",  self.send(name).send(prop))
+            end
+          end
+        end
+      end    
+    end
+    
+    def self.find(query, options={})
+      options = {:query => query}.merge(options)
+      request = ApiRequest.new("search_artists", options)
+      results = Xml::ArtistSearchResults.parse(request.fetch)
+      results.artists
+    end
+    
+    service :audio
+    service :blogs
+    service :familiarity, :singular => true
+    service :hotttnesss, :singular => true
+    service :news
+    service :profile, :singular => true, :provides => [:id, :name, :foreign_id]
+    service :reviews
+    service :similar
+    service :urls, :singular => true, :provides => [:mb_url, :official_url, :myspace_url, :wikipedia_url,  :amazon_url, :itunes_url]
+    service :video
+    
+ 
+  end
+end

data/lib/echonest/paged_result.rb

@@ -0,0 +1,33 @@
+
+
+
+module EchoNest
+  class PagedResult < DelegateClass(Array)
+
+    def initialize(results, block, options={})
+      @results = results
+      @update = block
+      @page_name = options[:page] || :docs 
+      @available = @results.send(@page_name)
+      super(@available)
+    end
+
+    def found
+      @results.found
+    end
+
+    def next_page
+      results = @update.call @available.length, 15
+      @available += results.send(@page_name)
+      self.__setobj__(@available)
+    end
+
+    def [](i)
+      return @available[i] if @available[i]
+      next_page
+      @available[i]
+    end    
+        
+    
+  end
+end

data/lib/echonest/xml/artist_doc.rb

@@ -0,0 +1,23 @@
+
+module EchoNest
+  module Xml
+    class ArtistDoc
+      include HappyMapper
+       
+      tag :artist
+       
+      element :name, String
+      element :id, String
+      element :familiarity, Float
+      element :hotttnesss, Float
+      element :foreign_id, String
+      
+      element :mb_url, String
+      element :official_url, String
+      element :myspace_url, String
+      element :wikipedia_url, String
+      element :amazon_url, String
+      element :itunes_url, String 
+    end
+  end
+end

data/lib/echonest/xml/artist_search_results.rb

@@ -0,0 +1,14 @@
+
+module EchoNest
+  module Xml
+    class ArtistSearchResults
+      include HappyMapper
+    
+      tag :response
+      
+  #    has_one :status, RequestStatus
+  #    has_one :query, RequestQuery
+      has_many :artists, ArtistDoc
+    end  
+  end
+end

data/lib/echonest/xml/audio_doc.rb

@@ -0,0 +1,20 @@
+
+module EchoNest
+  module Xml
+    class AudioDoc
+      include HappyMapper
+      
+      tag :doc
+      
+      element :artist_id, String
+      element :foreign_artist_id, String
+      element :artist, String
+      element :release, String
+      element :title, String
+      element :url, String
+      element :link, String
+      element :date, String
+      element :length, String
+    end
+  end
+end

data/lib/echonest/xml/audio_result.rb

@@ -0,0 +1,13 @@
+
+module EchoNest
+  module Xml
+    class AudioResult
+      include HappyMapper
+      
+      tag :response
+      
+      has_one :artist, ArtistDoc
+      has_one :results, AudioResults
+    end    
+  end
+end

data/lib/echonest/xml/audio_results.rb

@@ -0,0 +1,16 @@
+
+module EchoNest
+  module Xml
+    class AudioResults
+      include HappyMapper
+     
+      tag :results
+     
+      attribute :found, String
+      attribute :shown, String    
+      attribute :start, String
+      
+      has_many :docs, AudioDoc    
+    end  
+  end
+end

data/lib/echonest/xml/blogs_doc.rb

@@ -0,0 +1,15 @@
+
+module EchoNest
+  module Xml
+    class BlogsDoc
+      include HappyMapper
+      
+      tag :doc
+     
+      element :name, String
+      element :url, String
+      element :summary, String
+      element :date_found, String
+    end
+  end
+end

data/lib/echonest/xml/blogs_result.rb

@@ -0,0 +1,14 @@
+
+module EchoNest
+  module Xml
+    class BlogsResult
+      include HappyMapper
+      
+      tag :response
+      
+      has_one :artist, ArtistDoc
+      has_one :results, BlogsResults
+      
+    end
+   end
+end

data/lib/echonest/xml/blogs_results.rb

@@ -0,0 +1,18 @@
+
+module EchoNest
+  module Xml
+    class BlogsResults
+      include HappyMapper
+     
+      tag :results
+     
+      attribute :found, String
+      attribute :shown, String    
+      attribute :start, String
+      
+      has_many :docs, BlogsDoc    
+      
+    end
+  end
+end
+

data/lib/echonest/xml/familiarity_result.rb

@@ -0,0 +1,12 @@
+
+module EchoNest
+  module Xml
+    class FamiliarityResult
+        include HappyMapper
+        
+        tag :response
+        
+        has_one :artist, ArtistDoc
+    end
+  end
+end

data/lib/echonest/xml/hotttnesss_result.rb

@@ -0,0 +1,12 @@
+
+module EchoNest
+  module Xml
+    class HotttnesssResult
+      include HappyMapper
+      
+      tag :response
+      
+      has_one :artist, ArtistDoc
+    end    
+  end
+end

data/lib/echonest/xml/news_doc.rb

@@ -0,0 +1,15 @@
+
+module EchoNest
+  module Xml
+    class NewsDoc
+      include HappyMapper
+      
+      tag :doc
+     
+      element :name, String
+      element :url, String
+      element :summary, String
+      element :date_found, String
+    end
+  end
+end

data/lib/echonest/xml/news_result.rb

@@ -0,0 +1,14 @@
+
+module EchoNest
+  module Xml
+    class NewsResult
+      include HappyMapper
+      
+      tag :response
+      
+      has_one :artist, ArtistDoc
+      has_one :results, NewsResults
+      
+    end
+  end
+end

data/lib/echonest/xml/news_results.rb

@@ -0,0 +1,16 @@
+
+module EchoNest
+  module Xml
+   class NewsResults
+      include HappyMapper
+     
+      tag :results
+     
+      attribute :found, String
+      attribute :shown, String    
+      attribute :start, String
+      
+      has_many :docs, NewsDoc    
+    end     
+  end
+end

data/lib/echonest/xml/profile_result.rb

@@ -0,0 +1,12 @@
+
+module EchoNest
+  module Xml
+    class ProfileResult
+      include HappyMapper
+    
+      tag :response
+    
+      has_one :artist, ArtistDoc
+    end
+  end
+end

data/lib/echonest/xml/reviews_doc.rb

@@ -0,0 +1,16 @@
+
+module EchoNest
+  module Xml
+    class ReviewsDoc
+      include HappyMapper
+      
+      tag :doc
+     
+      element :name, String
+      element :review_text, String
+      element :url, String
+      element :summary, String
+      element :date_found, String
+    end
+  end
+end