sandro-metamuse 0.1.0

data/lib/metamuse/services/lastfm.rb

@@ -0,0 +1,27 @@
+module Metamuse
+  module Services
+    module Lastfm
+      extend Service
+      include HTTParty
+      base_uri 'http://ws.audioscrobbler.com/2.0/'
+      has_api_key
+
+      def self.top_albums(name)
+        build_albums get('', :query => {:method => "artist.gettopalbums", :artist => name})
+      end
+
+      def self.artist(name)
+      end
+
+      private
+
+      def self.build_albums(response)
+        album_data = response['lfm']['topalbums']['album']
+        album_data.map do |data|
+          images = data['image'].map {|location| Image.new location}
+          Album.new :name => data['name'], :mbid => data['mbid'], :rank => data['rank'], :images => images
+        end
+      end
+    end
+  end
+end

data/lib/metamuse/services/lastfm/image.rb

@@ -0,0 +1,41 @@
+class Metamuse::Services::Lastfm::Image
+  attr_reader :location, :size
+
+  DIMENSIONS = {
+    :small => '34x34',
+    :medium => '64x64',
+    :large => '126x126',
+    :extra_large => '300x300'
+  }
+
+  def initialize(location)
+    @location = location
+    set_size
+  end
+
+  def dimensions
+    DIMENSIONS[size]
+  end
+
+  def height
+    dimensions.split("x").last
+  end
+
+  def width
+    dimensions.split("x").first
+  end
+
+  private
+
+  def set_size
+    @size = DIMENSIONS.index(dimension_value_from_location)
+  end
+
+  def dimension_value_from_location
+    size_regexp = %r(/serve/(\d+).*/)
+    match = location.match size_regexp
+    if match && width = match.captures.first
+      "#{width}x#{width}"
+    end
+  end
+end

data/lib/metamuse/services/music_brainz.rb

@@ -0,0 +1,27 @@
+module Metamuse
+  module Services
+    class MusicBrainz
+      include HTTParty
+      base_uri 'http://musicbrainz.org/ws/1'
+      default_params :type => :xml
+
+      def self.album(id)
+        build_album get("/release/#{id}/", :query => {:inc => :tracks})
+      end
+
+      private
+
+      def self.build_album(response)
+        release = response['metadata']['release']
+        album_data = {:name => release['title'], :mbid => release['id']}
+
+        track_list = release['track_list']['track']
+        tracks = track_list.map do |track|
+          Track.new :name => track['title'], :index => track_list.index(track), :mbid => track['id']
+        end
+
+        Album.new album_data.merge(:tracks => tracks)
+      end
+    end
+  end
+end

data/lib/metamuse/track.rb

@@ -0,0 +1,13 @@
+module Metamuse
+  class Track
+    include InstanceInitialize
+    extend Association
+    belongs_to :album, Album
+    attr_accessor :name, :index, :freebase_id, :mbid
+    alias number index
+
+    def <=>(other)
+      name <=> other.name
+    end
+  end
+end

data/lib/object_ext.rb

@@ -0,0 +1,11 @@
+class Object
+  def try(method)
+    send(method) if respond_to? method
+  end
+
+  def attempt
+    yield self
+    rescue StandardError, RuntimeError
+      self
+  end
+end

data/metamuse.gemspec

@@ -0,0 +1,89 @@
+# -*- encoding: utf-8 -*-
+
+Gem::Specification.new do |s|
+  s.name = %q{metamuse}
+  s.version = "0.1.0"
+
+  s.required_rubygems_version = Gem::Requirement.new(">= 0") if s.respond_to? :required_rubygems_version=
+  s.authors = ["Sandro Turriate"]
+  s.date = %q{2009-07-19}
+  s.email = %q{sandro.turriate@gmail.com}
+  s.extra_rdoc_files = [
+    "README.rdoc"
+  ]
+  s.files = [
+    ".document",
+     ".gitignore",
+     "MIT_LICENSE",
+     "README.rdoc",
+     "Rakefile",
+     "VERSION",
+     "lib/array_ext.rb",
+     "lib/arrayish.rb",
+     "lib/httparty_ext.rb",
+     "lib/metamuse.rb",
+     "lib/metamuse/album.rb",
+     "lib/metamuse/artist.rb",
+     "lib/metamuse/association.rb",
+     "lib/metamuse/collection.rb",
+     "lib/metamuse/services.rb",
+     "lib/metamuse/services/echonest.rb",
+     "lib/metamuse/services/freebase.rb",
+     "lib/metamuse/services/lastfm.rb",
+     "lib/metamuse/services/lastfm/image.rb",
+     "lib/metamuse/services/music_brainz.rb",
+     "lib/metamuse/track.rb",
+     "lib/object_ext.rb",
+     "metamuse.gemspec",
+     "script/console",
+     "spec/fake_object.rb",
+     "spec/fake_object_spec.rb",
+     "spec/metamuse/album_spec.rb",
+     "spec/metamuse/artist_spec.rb",
+     "spec/metamuse/association_spec.rb",
+     "spec/metamuse/collection_spec.rb",
+     "spec/metamuse/services/echonest_spec.rb",
+     "spec/metamuse/services/freebase_spec.rb",
+     "spec/metamuse/services/lastfm/image_spec.rb",
+     "spec/metamuse/services/lastfm_spec.rb",
+     "spec/metamuse/services/music_brainz_spec.rb",
+     "spec/metamuse_spec.rb",
+     "spec/spec_helper.rb",
+     "spec/web_fixtures/GET_developer.echonest.com-api-search_artists_17a9da1.fixture",
+     "spec/web_fixtures/GET_developer.echonest.com-api-search_artists_350c352.fixture",
+     "spec/web_fixtures/GET_musicbrainz.org-ws-1-release-bb32aa1d-f37b-4134-8c0e-b43b7a6dab85_b976ba7.fixture",
+     "spec/web_fixtures/GET_www.freebase.com-api-service-mqlread_60ee2bd.fixture",
+     "spec/web_fixtures/GET_www.freebase.com-api-service-mqlread_b8b2565.fixture"
+  ]
+  s.has_rdoc = true
+  s.homepage = %q{http://github.com/sandro/metamuse}
+  s.rdoc_options = ["--charset=UTF-8"]
+  s.require_paths = ["lib"]
+  s.rubygems_version = %q{1.3.1}
+  s.summary = %q{Search for music metadata}
+  s.test_files = [
+    "spec/fake_object.rb",
+     "spec/fake_object_spec.rb",
+     "spec/metamuse/album_spec.rb",
+     "spec/metamuse/artist_spec.rb",
+     "spec/metamuse/association_spec.rb",
+     "spec/metamuse/collection_spec.rb",
+     "spec/metamuse/services/echonest_spec.rb",
+     "spec/metamuse/services/freebase_spec.rb",
+     "spec/metamuse/services/lastfm/image_spec.rb",
+     "spec/metamuse/services/lastfm_spec.rb",
+     "spec/metamuse/services/music_brainz_spec.rb",
+     "spec/metamuse_spec.rb",
+     "spec/spec_helper.rb"
+  ]
+
+  if s.respond_to? :specification_version then
+    current_version = Gem::Specification::CURRENT_SPECIFICATION_VERSION
+    s.specification_version = 2
+
+    if Gem::Version.new(Gem::RubyGemsVersion) >= Gem::Version.new('1.2.0') then
+    else
+    end
+  else
+  end
+end

data/script/console

@@ -0,0 +1,8 @@
+#!/usr/bin/env ruby
+# File: script/console
+irb = RUBY_PLATFORM =~ /(:?mswin|mingw)/ ? 'irb.bat' : 'irb'
+
+libs = " -r irb/completion"
+libs << " -r lib/metamuse.rb"
+
+exec "#{irb} #{libs} --simple-prompt"

data/spec/fake_object.rb

@@ -0,0 +1,38 @@
+module FakeObject
+  def fake(*args)
+    Fake.new *args
+  end
+
+  class Fake
+    attr_reader :name, :strategy, :expectations
+
+    def initialize(*args)
+      @strategy = extract_strategy(args.last) || :stub
+      setup args
+    end
+
+    def setup(args)
+      case arg = args.shift
+      when Hash
+        set_expectations arg
+      when String
+        @name = arg
+        setup args
+      when NilClass
+      else
+        raise ArgumentError, "Hash excepted, got: #{args.inspect}"
+      end
+    end
+
+    def set_expectations(expectations)
+      expectations.each do |method_name, return_value|
+        ::RR.send(strategy, self).__send__(method_name).returns(return_value) # stub(object).method.returns(value)
+      end
+    end
+
+    def extract_strategy(arg)
+      arg[:strategy] if Hash === arg
+    end
+  end
+end
+

data/spec/fake_object_spec.rb

@@ -0,0 +1,66 @@
+require File.expand_path(File.dirname(__FILE__) + '/spec_helper')
+
+class FakeTestContext
+  include FakeObject
+  def stub(*args)
+  end
+end
+
+describe FakeObject do
+
+  context "#fake" do
+    before do
+      @context = FakeTestContext.new
+    end
+
+    it "sets the context when setting expectations" do
+      mock(FakeObject::Fake).new(:greeting => 'hi')
+      @context.fake(:greeting => 'hi')
+    end
+  end
+
+  describe Fake do
+    context "#new with no expectations" do
+      it "returns a fake object" do
+        FakeObject::Fake.new.should be_instance_of(Fake)
+      end
+
+      it "has a name" do
+        f = FakeObject::Fake.new 'fake'
+        f.name.should == 'fake'
+      end
+    end
+
+    context "#new with expectations" do
+      it "responds to fake method 'greeting'" do
+        f = FakeObject::Fake.new :greeting => 'hi'
+        f.greeting.should == 'hi'
+      end
+
+      it "responds has a name" do
+        f = FakeObject::Fake.new 'Greeter', :greeting => 'hi'
+        f.name.should == 'Greeter'
+      end
+
+      it "uses the mock build strategy" do
+        f = FakeObject::Fake.new({:greeting => 'hi'}, :strategy => :mock)
+        f.greeting
+        f.strategy.should == :mock
+      end
+    end
+
+    context "Hash not provided" do
+      it "raises ArgumentError for an array" do
+        expect {
+          FakeObject::Fake.new []
+        }.to raise_error(ArgumentError)
+      end
+
+      it "raises ArgumentError for a name and array" do
+        expect {
+          FakeObject::Fake.new 'name', []
+        }.to raise_error(ArgumentError)
+      end
+    end
+  end
+end

data/spec/metamuse/album_spec.rb

@@ -0,0 +1,4 @@
+require File.expand_path(File.dirname(__FILE__) + '/../spec_helper')
+
+describe Metamuse::Album do
+end

data/spec/metamuse/artist_spec.rb

@@ -0,0 +1,99 @@
+require File.expand_path(File.dirname(__FILE__) + '/../spec_helper')
+
+describe Metamuse::Artist do
+  subject { Metamuse::Artist.new :name => 'Mozart' }
+
+  describe ".build_artist" do
+    subject { Metamuse::Artist }
+    it "gets and enhances freebase artist information" do
+      mock.proxy(Metamuse::Services::Freebase).artist('Mozart') do |artist|
+        mock(artist).enhance_albums!
+        artist
+      end
+      subject.build('Mozart')
+    end
+  end
+
+  describe "#tracks" do
+    it "collects all of the tracks from the every album" do
+      album1 = fake(:tracks => [1,2])
+      album2 = fake(:tracks => [3,4])
+      stub(subject).albums { [album1, album2] }
+      subject.tracks.should == [1,2,3,4]
+    end
+  end
+
+  describe "#enhance_albums!" do
+    context "when albums exist" do
+      before do
+        @image = fake('image')
+        @lastfm_albums = [
+          Metamuse::Album.new(:name => 'Mild', :rank => 3, :mbid => 1),
+          Metamuse::Album.new(:name => 'Hot', :rank => 1, :mbid => 2, :images => [@image]),
+          Metamuse::Album.new(:name => 'Medium', :rank => 2, :mbid => 3)
+        ]
+        stub(subject).lastfm_albums { @lastfm_albums }
+        subject.albums = [{:name => "Mild"}, {:name => 'Hot'}, {:name => 'Medium'}]
+      end
+
+      it "uses albums from Last.fm" do
+        subject.enhance_albums!
+        subject.should have_received(:lastfm_albums).any_times
+      end
+
+      it "sets the album's mbid" do
+        subject.enhance_albums!.first.mbid.should == 2
+      end
+
+      it "sets the album's images collection" do
+        subject.enhance_albums!.first.images.should include(@image)
+      end
+
+      it "sets the album's rank" do
+        subject.enhance_albums!.first.rank.should == 1
+      end
+
+      context "rankings" do
+        it "sets rank to nil when the lastfm album is unranked" do
+          ranked = Metamuse::Album.new
+          stub(subject).lastfm_albums { [ranked] }
+          subject.enhance_albums!.first.rank.should be_nil
+        end
+
+        it "sorts based on rank" do
+          ranked = [Metamuse::Album.new(:name => 'Mild', :rank => 3), Metamuse::Album.new(:name => 'Hot', :rank => 1), Metamuse::Album.new(:name => 'Medium', :rank => 2)]
+          stub(subject).ranked_albums { ranked }
+          subject.enhance_albums!
+          subject.albums.map{|a| a.name}.should == %w(Hot Medium Mild)
+        end
+      end
+    end
+
+    context "artist has no albums" do
+      it "returns albums if the artist has no albums" do
+        albums = []
+        mock(subject).albums.any_times { albums }
+        subject.enhance_albums!.should == albums
+      end
+    end
+  end
+
+  describe "#fetch_albums_and_tracks!" do
+    it "fetches artist information from Freebase" do
+      mock.proxy(Metamuse::Services::Freebase).artist("Mozart") do |freebase_artist|
+        mock(subject).albums=(freebase_artist.albums)
+        freebase_artist
+      end
+      subject.fetch_albums_and_tracks!
+    end
+
+    it "assigns the tracks that were retrieved from Freebase" do
+      freebase_artist = nil
+      stub.proxy(Metamuse::Services::Freebase).artist('Mozart') do |fba|
+        freebase_artist = fba
+      end
+      subject.fetch_albums_and_tracks!
+      subject.tracks.should == freebase_artist.tracks
+    end
+  end
+end

data/spec/metamuse/association_spec.rb

@@ -0,0 +1,74 @@
+require File.expand_path(File.dirname(__FILE__) + '/../spec_helper')
+
+class TestShoe
+  extend Metamuse::Association
+  attr_accessor :color
+  def initialize(attrs={})
+    attrs.each {|k,v| send(:"#{k}=", v)}
+  end
+end
+
+class TestPerson
+  extend Metamuse::Association
+  has_many :shoes, TestShoe
+end
+TestShoe.class_eval { belongs_to :person, TestPerson }
+
+describe Metamuse::Association do
+  it "creates a shoes accessor which returns an array" do
+    TestPerson.new.shoes.should be_kind_of(Array)
+  end
+
+  describe "adding shoes to the test person" do
+    before do
+      @person = TestPerson.new
+    end
+
+    it "adds a single red shoe" do
+      expect {
+        @person.shoes << {:color => "red"}
+      }.to change{@person.shoes.size}.by(1)
+    end
+
+    it "creates a new shoe when not appending a TestShoe" do
+      mock.proxy(TestShoe).new({:color => 'red'})
+      @person.shoes << {:color => 'red'}
+      @person.shoes.last.color == 'red'
+    end
+
+    it "appends a TestShoe" do
+      @person.shoes << TestShoe.new(:color => "red")
+      @person.shoes.last.should be_instance_of(TestShoe)
+    end
+
+    it "appends many shoes" do
+      @person.shoes << [TestShoe.new(:color => "red"), {:color => "blue"}]
+      @person.shoes.size.should == 2
+      @person.shoes.map {|s| s.class}.uniq.should == [TestShoe]
+    end
+
+    it "clears old shoes when setting the collection" do
+      @person.shoes << {:color => 'blue'}
+      expect {
+        @person.shoes = {:color => 'red'}
+      }.to change{@person.shoes.first.color}.from('blue').to('red')
+      @person.shoes.size.should == 1
+    end
+  end
+
+  describe "TestShoe belongs to a TestPerson" do
+    before do
+      @person = TestPerson.new
+    end
+
+    it "sets the shoe's person equal to the person that added the shoe" do
+      @person.shoes << {:color => 'red', :person => @person}
+      @person.shoes.last.person.should == @person
+    end
+
+    it "sets the shoe's person when not explicitly available in the hash" do
+      @person.shoes << {:color => 'red'}
+      @person.shoes.last.person.should == @person
+    end
+  end
+end