echonest-ruby-api 0.7.0 → 0.8.0

data/lib/echonest-ruby-api/genre.rb

@@ -0,0 +1,34 @@
+require 'rubygems'
+require 'bundler/setup'
+require_relative 'base'
+
+module Echonest
+  class Genre < Echonest::Base
+    attr_accessor :name
+
+    def initialize(api_key, name = nil)
+      @api_key = api_key
+      @name = name
+    end
+
+    def artists(options = {})
+      get_response(options.merge(name: @name))
+    end
+
+    def profile(options = {})
+      get_response(options.merge(name: @name))
+    end
+
+    def similar(options = {})
+      get_response(options.merge(name: @name))
+    end
+
+    def self.list(api_key, options = {})
+      Base.get_api_endpoint(api_key, 'genre/list', options)
+    end
+
+    def self.search(api_key, options = {})
+      Base.get_api_endpoint(api_key, 'genre/search', options)
+    end
+  end
+end

data/lib/echonest-ruby-api/version.rb

@@ -1,3 +1,3 @@
 module Echonest
-  VERSION = "0.7.0"
+  VERSION = "0.8.0"
 end

data/spec/artist_spec.rb

@@ -85,7 +85,7 @@ describe Echonest::Artist do
     end
 
   end
-  
+
   describe '#videos' do
 
     it 'should download a specified number of video streams' do
@@ -103,18 +103,18 @@ describe Echonest::Artist do
     end
 
   end
-  
+
   describe '#urls' do
-    
+
     it 'should return a hash of urls' do
       VCR.use_cassette('urls') do
         create_valid_artist
         @a.urls.should be_a Hash
       end
     end
-    
+
   end
-  
+
   describe '#familiarity' do
 
     it 'should allow us to find out how familiar an artist is' do
@@ -138,6 +138,18 @@ describe Echonest::Artist do
     end
   end
 
+  describe '#genres' do
+    it 'should allow us to find what genre an artist is in' do
+      VCR.use_cassette('genres', record: :new_episodes) do
+        create_valid_artist
+        @a.genres.should be_an Array
+        @a.genres.size.should > 0
+        @a.genres.should include('rock')
+        @a.genres.should include('alternative rock')
+      end
+    end
+  end
+
   describe '#hotttnesss' do
     it 'should allow us to find out how hotttt an artist is' do
       VCR.use_cassette('hotttnesss') do
@@ -228,6 +240,60 @@ describe Echonest::Artist do
     end
   end # /search
 
+  describe '#similar', vcr: {cassette_name: 'similar_artists'} do
+    it 'should return similar artists' do
+      create_valid_artist
+      @a.similar(results: 10).count.should be > 0
+    end
+
+    it 'expect to return an array of artists' do
+      create_valid_artist
+      results = @a.similar(results: 10)
+      results.should be_a Array
+    end
+
+    it 'expect to return name for each artist' do
+      create_valid_artist
+      names = []
+      results = @a.similar(results: 10)
+      results.each do |a|
+        a[:name].empty?.should eq false
+        a[:name].length.should be > 0
+      end
+    end
+
+    it 'expect an id for each similar artist' do
+      create_valid_artist
+      ids = []
+      results = @a.similar(results: 10)
+      results.each do |a|
+        a[:id].empty?.should eq false
+      end
+    end
+
+  end # /similar
+
+  describe '#suggest', vcr: {cassette_name: 'suggest'} do
+    it 'should return an Array of artists' do
+      create_valid_artist
+      @a.suggest.should be_a Array
+    end
+
+    it 'should return an Artist object for each result' do
+      create_valid_artist
+      @a.suggest.each do |k|
+        k.class.should be Echonest::Artist
+      end
+    end
+
+    it 'should fill in id of each returned artist' do
+      create_valid_artist
+      @a.suggest.each do |k|
+        k.id.should_not be_nil
+      end
+    end
+  end # /suggest
+
   describe '#top_hottt', vcr: {cassette_name: 'top_hottt'} do
     it 'should return an Array of artists' do
       create_valid_artist

data/spec/genre_spec.rb

@@ -0,0 +1,76 @@
+require 'spec_helper'
+
+describe Echonest::Genre do
+  it 'should accept name for creation' do
+    g = Echonest::Genre.new('BNOAEBT3IZYZI6WXI', 'folk rock')
+
+    expect(g.name).to eq 'folk rock'
+  end
+
+  describe 'instance methods' do
+    context 'with valid api key and name' do
+      before :all do
+        @genre = Echonest::Genre.new('BNOAEBT3IZYZI6WXI', 'folk rock')
+      end
+
+      describe '#artists' do
+        it 'returns a list of associated artists' do
+          VCR.use_cassette('genre_artists') do
+            artists = @genre.artists
+
+            expect(artists[:status][:message]).to eq 'Success'
+            expect(artists[:artists]).to include(id: 'ARVHQNN1187B9B9FA3',
+                                             name: 'Cat Stevens')
+          end
+        end
+      end
+
+      describe '#profile' do
+        it 'returns a profile response given' do
+          VCR.use_cassette('genre_profile') do
+            profile = @genre.profile
+
+            expect(profile[:status][:message]).to eq 'Success'
+            expect(profile[:genres][0][:name]).to eq 'folk rock'
+          end
+        end
+      end
+
+      describe '#similar' do
+        it 'returns a list of similar genres' do
+          VCR.use_cassette('genre_similar') do
+            genres = @genre.similar
+
+            expect(genres[:status][:message]).to eq 'Success'
+            expect(genres[:genres]).to include name: 'singer-songwriter', similarity: 0.708333
+          end
+        end
+      end
+    end
+  end
+
+  describe 'class methods' do
+    describe '#list' do
+      it 'returns a list of genres given valid api key' do
+        VCR.use_cassette('genre_list') do
+          genres =  Echonest::Genre.list 'BNOAEBT3IZYZI6WXI'
+
+          expect(genres[:status][:message]).to eq 'Success'
+          expect(genres[:genres]).to include name: 'folk rock'
+        end
+      end
+    end
+
+    describe '#search' do
+      it 'returns a list of genres related to search term given valid api key' do
+        VCR.use_cassette('genre_search') do
+          results = Echonest::Genre.search 'BNOAEBT3IZYZI6WXI',
+                                           name: 'folk rock'
+
+          expect(results[:status][:message]).to eq 'Success'
+          expect(results[:genres]).to include name: 'folk rock'
+        end
+      end
+    end
+  end
+end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: echonest-ruby-api
 version: !ruby/object:Gem::Version
-  version: 0.7.0
+  version: 0.8.0
 platform: ruby
 authors:
 - Max Woolf
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2014-04-08 00:00:00.000000000 Z
+date: 2015-03-20 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: httparty
@@ -141,6 +141,11 @@ files:
 - fixtures/vcr_cassettes/biographies.yml
 - fixtures/vcr_cassettes/blogs.yml
 - fixtures/vcr_cassettes/familiarity.yml
+- fixtures/vcr_cassettes/genre_artists.yml
+- fixtures/vcr_cassettes/genre_list.yml
+- fixtures/vcr_cassettes/genre_profile.yml
+- fixtures/vcr_cassettes/genre_search.yml
+- fixtures/vcr_cassettes/genre_similar.yml
 - fixtures/vcr_cassettes/genres.yml
 - fixtures/vcr_cassettes/hotttnesss.yml
 - fixtures/vcr_cassettes/images.yml
@@ -155,6 +160,7 @@ files:
 - fixtures/vcr_cassettes/profile.yml
 - fixtures/vcr_cassettes/search.yml
 - fixtures/vcr_cassettes/search_2.yml
+- fixtures/vcr_cassettes/similar_artists.yml
 - fixtures/vcr_cassettes/single_biography.yml
 - fixtures/vcr_cassettes/song_identify.yml
 - fixtures/vcr_cassettes/song_profile.yml
@@ -162,6 +168,7 @@ files:
 - fixtures/vcr_cassettes/song_search_slow.yml
 - fixtures/vcr_cassettes/songs.yml
 - fixtures/vcr_cassettes/songs_more.yml
+- fixtures/vcr_cassettes/suggest.yml
 - fixtures/vcr_cassettes/ten_blogs.yml
 - fixtures/vcr_cassettes/ten_news_articles.yml
 - fixtures/vcr_cassettes/ten_videos.yml
@@ -176,6 +183,7 @@ files:
 - lib/echonest-ruby-api/blog.rb
 - lib/echonest-ruby-api/error.rb
 - lib/echonest-ruby-api/foreign_id.rb
+- lib/echonest-ruby-api/genre.rb
 - lib/echonest-ruby-api/playlist.rb
 - lib/echonest-ruby-api/song.rb
 - lib/echonest-ruby-api/version.rb
@@ -184,6 +192,7 @@ files:
 - spec/base_spec.rb
 - spec/error_spec.rb
 - spec/foreign_id_spec.rb
+- spec/genre_spec.rb
 - spec/playlist_spec.rb
 - spec/song_spec.rb
 - spec/spec_helper.rb
@@ -207,7 +216,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
       version: '0'
 requirements: []
 rubyforge_project: 
-rubygems_version: 2.0.6
+rubygems_version: 2.2.2
 signing_key: 
 specification_version: 4
 summary: A gem to get hold of some echonest stuff!
@@ -216,6 +225,7 @@ test_files:
 - spec/base_spec.rb
 - spec/error_spec.rb
 - spec/foreign_id_spec.rb
+- spec/genre_spec.rb
 - spec/playlist_spec.rb
 - spec/song_spec.rb
 - spec/spec_helper.rb