idiomag 0.1.0

data/lib/idiomag/recommendation.rb

@@ -0,0 +1,70 @@
+module Idiomag
+  class Recommendation
+    ValidNetworks = [:lastfm,:mog,:ilike,:mystrands,:projectplaylist,:imeem,:pandora,:bebo,:myspace,:songza]
+    
+    def initialize(options)
+      if !options[:network].blank? && !options[:user].blank?
+        @user = options[:user]
+        @network = options[:network]
+        raise ArgumentError if !ValidNetworks.include?(@network)
+        @query = {:network => @network,:username => @user}
+      elsif !options[:apml].blank?
+        @apml = options[:apml]
+        @query = {:apml => @apml}
+      elsif !options[:artists].blank? && options[:artists].is_a?(Array)
+        @artist_list = options[:artists]
+        @query = {:artists => @artist_list}
+      else
+        raise ArgumentError
+      end
+    end
+    
+    def get(*args)
+      args.each do |action|
+        case action
+        when :articles
+          get_articles
+        when :artists
+          get_artists
+        else
+          raise ArgumentError
+        end
+      end
+    end
+    
+    def respond_to?(method)
+      case method
+      when :articles,:artists
+        true
+      else
+        super
+      end
+    end
+    
+    def method_missing(method, *args)  
+      case method
+      when :articles
+        get_articles if @articles.nil?
+        @articles
+      when :artists
+        get_artists if @artists.nil?
+        @artists
+      else
+        super
+      end
+    end
+    
+    private
+    
+      def get_articles
+        @articles = Parser.parse_articles(REST.fetch('recommendation/articles', @query))
+      end
+      
+      def get_artists
+        artist_data = REST.fetch('recommendation/artists', @query)
+        
+        @artists = {}
+        artist_data['artists'].each {|a| @artists[a['title']] = a['value'] }
+      end
+  end
+end

data/lib/idiomag/rest.rb

@@ -0,0 +1,20 @@
+module Idiomag
+  class InvalidResult < StandardError; end;
+
+  class REST
+    def self.fetch(resource, query={}, parse=true)
+      raise ArgumentError, 'api key missing' if Base.api_key.blank?
+      
+      options = {:query => {:key => Base.api_key}}
+      options[:query].merge!(query)
+      options[:format] = :json if parse
+      begin
+        data = HTTParty.get(API_URL + resource + "/json", options)
+      rescue Net::HTTPServerException => e
+          raise ArgumentError, 'invalid user, artist or tag' if e.message =~ /400/
+      end
+      raise InvalidResult if data.blank?
+      data
+    end
+  end
+end

data/lib/idiomag/tag.rb

@@ -0,0 +1,106 @@
+module Idiomag
+  class Tag    
+    def initialize(tag)
+      raise ArgumentError if tag.blank?
+      @tag = tag.to_s.gsub(/_/, ' ')
+    end
+    
+    def get(*args)
+      args.each do |action|
+        case action
+        when :articles
+          get_articles
+        when :photos
+          get_photos
+        when :videos
+          get_videos
+        when :playlist, :tracks
+          get_playlist
+        when :artists
+          get_artists
+        else
+          raise ArgumentError
+        end
+      end
+    end
+    
+    def respond_to?(method)
+      case method
+      when :articles,:photos,:videos,:playlist,:tracks,:artists,:list,:name
+        true
+      else
+        super
+      end
+    end
+    
+    def method_missing(method, *args)  
+      case method
+      when :name
+        @tag
+      when :articles
+        get_articles if @articles.nil?
+        @articles
+      when :photos
+        get_photos if @photos.nil?
+        @photos
+      when :videos
+        get_videos if @videos.nil?
+        @videos
+      when :playlist, :tracks
+        get_playlist if @playlist.nil?
+        @playlist
+      when :artists
+        get_artists if @artists.nil?
+        @artists
+      when :list
+        Tag.list
+      else
+        super
+      end
+    end
+    
+    class << self      
+      def list
+        if @list.blank?
+          @list_data = REST.fetch('tags', {}, false)
+      
+          @list = @list_data.split("\n")
+          @list.map! do |t|
+            if t =~ /-/
+              t.strip.downcase
+            else
+              t.strip.downcase.gsub(/ /, '_').to_sym
+            end
+          end
+        else
+          @list
+        end
+      end
+    end
+    
+    private
+    
+      def get_articles
+        @articles = Parser.parse_articles(REST.fetch('tag/articles', :tag => @tag))
+      end
+    
+      def get_photos
+        @photos = Parser.parse_photos(REST.fetch('tag/photos', :tag => @tag))
+      end
+    
+      def get_videos
+        @videos = Parser.parse_videos(REST.fetch('tag/videos', :tag => @tag))
+      end
+    
+      def get_playlist
+        @playlist = Parser.parse_playlist(REST.fetch('tag/playlist', :tag => @tag))
+      end
+      
+      def get_artists
+        artist_data = REST.fetch('tag/artists', :tag => @tag)
+      
+        @artists = {}
+        artist_data['profile']['artist'].each {|t| @artists[t['title']] = t['value']}
+      end
+  end
+end

data/lib/idiomag/user.rb

@@ -0,0 +1,114 @@
+module Idiomag
+  class User
+    attr_accessor :user
+    
+    def initialize(user)
+      raise ArgumentError if user.blank?
+      @user = user
+    end
+    
+    def get(*args)
+      args.each do |action|
+        case action
+        when :info
+          get_info
+        when :articles
+          get_articles
+        when :loved_articles
+          get_loved_articles
+        when :photos
+          get_photos
+        when :videos
+          get_videos
+        when :playlist, :tracks
+          get_playlist
+        else
+          raise ArgumentError
+        end
+      end
+    end
+    
+    def respond_to?(method)
+      case method
+      when :name,:email,:url,:tags,:artists,:articles,:loved_articles,:photos,:videos,:playlist,:tracks
+        true
+      else
+        super
+      end
+    end
+    
+    def method_missing(method, *args)  
+      case method
+      when :name
+        get_info if @name.nil?
+        @name
+      when :email
+        get_info if @email.nil?
+        @email
+      when :url
+        get_info if @url.nil?
+        @url
+      when :artists
+        get_info if @artists.nil?
+        @artists
+      when :tags
+        get_info if @tags.nil?
+        @tags
+      when :articles
+        get_articles if @articles.nil?
+        @articles
+      when :loved_articles
+        get_loved_articles if @loved_articles.nil?
+        @loved_articles
+      when :photos
+        get_photos if @photos.nil?
+        @photos
+      when :videos
+        get_videos if @videos.nil?
+        @videos
+      when :playlist, :tracks
+        get_playlist if @playlist.nil?
+        @playlist
+      else
+        super
+      end
+    end
+    
+    private
+      
+      def get_info
+        info_data = REST.fetch('user/info', {:user => @user})
+        
+        @name = info_data['name']
+        @email = info_data['email_sha1']
+        @url = info_data['url']
+        
+        @artists = {}
+        info_data['artists']['artist'].each {|a| @artists[a['title']] = a['value'] } if !info_data['artists'].blank?
+        
+        @tags = {}
+        info_data['tags']['tag'].each {|t| @tags[t['name']] = t['value']} if !info_data['tags'].blank?
+        @tags.keys_to_sym!
+      end
+      
+      def get_articles
+        @articles = Parser.parse_articles(REST.fetch('user/articles', :user => @user))
+      end
+      
+      def get_loved_articles
+        @loved_articles = Parser.parse_articles(REST.fetch('user/lovedarticles', :user => @user))
+      end
+      
+      def get_photos
+        @photos = Parser.parse_photos(REST.fetch('user/photos', :user => @user))
+      end
+      
+      def get_videos
+        @videos = Parser.parse_videos(REST.fetch('user/videos', :user => @user))
+      end
+      
+      def get_playlist
+        @playlist = Parser.parse_playlist(REST.fetch('user/playlist', :user => @user))
+      end
+  end
+end

data/spec/articles_spec.rb

@@ -0,0 +1,61 @@
+require File.dirname(__FILE__) + '/spec_helper.rb'
+
+describe 'Idiomag::Articles' do
+  before(:each) do
+    @articles = Idiomag::Articles.new
+  end
+  
+  it 'should respond_to the correct methods' do
+    @articles.respond_to?(:get).should == true
+    @articles.respond_to?(:latest).should == true
+    @articles.respond_to?(:featured).should == true
+  end
+  
+  it 'should error on invalid get argument' do
+    lambda { @articles.get(:foo) }.should raise_error(ArgumentError)
+  end
+  
+  it 'should error on invalid method' do
+    lambda { @articles.foo }.should raise_error(NoMethodError)
+  end
+  
+  describe 'latest' do
+    before(:each) do
+      @data = open(Fixtures + 'articles_latest.json').read
+      Idiomag::REST.should_receive(:fetch).with('articles/latest').and_return(JSON.parse(@data))
+    end
+    
+    it 'should allow prefetching' do
+      @articles.get(:latest)
+    end
+    
+    it 'should get latest articles' do
+      @articles.latest[0][:artist].should == 'K-Drama'
+      @articles.latest[0][:description].blank?.should_not == true
+    end
+    
+    it 'should parse the dates' do
+      @articles.latest[0][:date].class.should == Time
+    end
+  end
+  
+  describe 'featured' do
+    before(:each) do
+      @data = open(Fixtures + 'articles_featured.json').read
+      Idiomag::REST.should_receive(:fetch).with('articles/featured').and_return(JSON.parse(@data))
+    end
+    
+    it 'should allow prefetching' do
+      @articles.get(:featured)
+    end
+    
+    it 'should get featured articles' do
+      @articles.featured[0][:artist].should == 'Coldplay'
+      @articles.featured[0][:description].blank?.should_not == true
+    end
+    
+    it 'should parse the dates' do
+      @articles.featured[0][:date].class.should == Time
+    end
+  end
+end

data/spec/artist_spec.rb

@@ -0,0 +1,149 @@
+require File.dirname(__FILE__) + '/spec_helper.rb'
+
+describe 'Idiomag::Artist' do
+  before(:each) do
+    @artist = Idiomag::Artist.new('Anberlin')
+  end
+  
+  it 'should require an artist' do
+    lambda { Idiomag::Artist.new }.should raise_error(ArgumentError)
+  end
+  
+  it 'should know the artist name' do
+    @artist.name.should == 'Anberlin'
+  end
+  
+  it 'should respond_to the correct methods' do
+    @artist.respond_to?(:get).should == true
+    @artist.respond_to?(:name).should == true
+    @artist.respond_to?(:links).should == true
+    @artist.respond_to?(:related).should == true
+    @artist.respond_to?(:tags).should == true
+    @artist.respond_to?(:articles).should == true
+    @artist.respond_to?(:photos).should == true
+    @artist.respond_to?(:videos).should == true
+    @artist.respond_to?(:playlist).should == true
+    @artist.respond_to?(:tracks).should == true
+  end
+
+  it 'should error on invalid get argument' do
+    lambda { @artist.get(:foo) }.should raise_error(ArgumentError)
+  end
+  
+  it 'should error on invalid method' do
+    lambda { @artist.foo }.should raise_error(NoMethodError)
+  end
+
+  describe 'info' do
+    before(:each) do
+      @data = open(Fixtures + 'artist_info.json').read
+      Idiomag::REST.should_receive(:fetch).with('artist/info',:artist=>'Anberlin').and_return(JSON.parse(@data))
+    end
+    
+    it 'should allow prefetching' do
+      @artist.get(:info)
+    end
+    
+    it 'should get links' do
+      @artist.links.should include('http://www.anberlin.com')
+    end
+    
+    it 'should get related artists' do
+      @artist.related['Relient K'].should include('http://www.idiomag.com/artist/relient_k/')
+    end
+  end
+  
+  describe 'tags' do
+    before(:each) do
+      @data = open(Fixtures + 'artist_tags.json').read
+      Idiomag::REST.should_receive(:fetch).with('artist/tags',:artist=>'Anberlin').and_return(JSON.parse(@data))
+    end
+    
+    it 'should allow prefetching' do
+      @artist.get(:tags)
+    end
+    
+    it 'should get tags' do
+      @artist.tags[:alternative_rock].should == 0.37
+    end
+  end
+  
+  describe 'articles' do
+    before(:each) do
+      @data = open(Fixtures + 'artist_articles.json').read
+      Idiomag::REST.should_receive(:fetch).with('artist/articles',:artist=>'Anberlin').and_return(JSON.parse(@data))
+    end
+    
+    it 'should allow prefetching' do
+      @artist.get(:articles)
+    end
+    
+    it 'should get articles' do
+      @artist.articles[0][:artist].should == 'Anberlin'
+      @artist.articles[0][:description].blank?.should_not == true
+    end
+    
+    it 'should parse the dates' do
+      @artist.articles[0][:date].class.should == Time
+    end
+  end
+  
+  describe 'photos' do
+    before(:each) do
+      @data = open(Fixtures + 'artist_photos.json').read
+      Idiomag::REST.should_receive(:fetch).with('artist/photos',:artist=>'Anberlin').and_return(JSON.parse(@data))
+    end
+    
+    it 'should allow prefetching' do
+      @artist.get(:photos)
+    end
+    
+    it 'should get photos' do
+      @artist.photos[0][:title].should =~ /jpg/
+      @artist.photos[0][:url].should =~ /jpg/
+      @artist.photos[0][:width].class.should == Fixnum
+      @artist.photos[0][:height].class.should == Fixnum
+    end
+    
+    it 'should parse the dates' do
+      @artist.photos[0][:date].class.should == Time
+    end
+  end
+  
+  describe 'videos' do    
+    before(:each) do
+      @data = open(Fixtures + 'artist_videos.json').read
+      Idiomag::REST.should_receive(:fetch).with('artist/videos',:artist=>'Anberlin').and_return(JSON.parse(@data))
+    end
+    
+    it 'should allow prefetching' do
+      @artist.get(:videos)
+    end
+    
+    it 'should get videos' do
+      @artist.videos[0][:location].should =~ /video/
+      @artist.videos[0][:info].should =~ /youtube/
+      @artist.videos[0][:thumb].should =~ /jpg/
+    end
+  end
+  
+  describe 'playlist' do
+    before(:each) do
+      @data = open(Fixtures + 'artist_playlist.json').read
+      Idiomag::REST.should_receive(:fetch).with('artist/playlist',:artist=>'Anberlin').and_return(JSON.parse(@data))
+    end
+    
+    it 'should allow prefetching' do
+      @artist.get(:playlist)
+    end
+    
+    it 'should get playlist' do
+      @artist.playlist[0][:location] =~ /mp3/
+    end
+    
+    it 'should respond to #tracks' do
+      @artist.get(:tracks)
+      @artist.tracks[0][:location] =~ /mp3/
+    end
+  end
+end