Musix 0.1

data/lib/musix.rb

@@ -0,0 +1,92 @@
+require 'bundler'
+Bundler.setup
+
+require 'httparty'
+require 'nokogiri'
+require 'Plist'
+require 'metaid'
+require 'cgi'
+
+# = What is Musix?
+# 
+# Musix was written to provide a simple interface for searching popular
+# music services such as Spotify, Grooveshark, ITunes and possibly more
+# in the future.
+module Musix
+  # = A Spotify metadata API wrapper
+  # 
+  #
+  # == Examples
+  #   Service::Spotify::Search.track('Fix You')
+  #   Service::Spotify::lookup(Service::Spotify::Search.track('Fix You')["track"].first["href"])
+  module Spotify
+    include HTTParty
+    format :xml
+    base_uri 'http://ws.spotify.com/'
+    
+    # = Spotify metadata search API
+    # Spotify::Search provides three methods for searching the {Spotify metadata API}[http://developer.spotify.com/en/metadata-api/search/].
+    class Search
+      
+      # Searches Spotify for a track.
+      def track(query, page = 1)
+        search("track", query, page)
+      end
+      
+      # Searches Spotify for an album.
+      def album(query, page = 1)
+        search("album", query, page)
+      end
+      
+      # Searches Spotify for an artist.
+      def artist(query, page = 1)
+        search("artist", query, page)
+      end
+      
+      private
+      def search(type, query, page)
+        Spotify::get("/search/1/#{method}", :query => { :q => query, :page => [args.first.to_i, 1].max }).fetch("#{method}s")
+      end
+    end
+    
+    # Looks up information about a Spotify URI with the +detail+ level of detail (max 2).
+    # 
+    # Spotify URIs looks like the following:
+    # -  spotify:track:id
+    # -  spotify:artist:id
+    # -  spotify:album:id
+    def self.lookup(uri, detail = 0)
+      type = uri.match('spotify:([^:]+)')[1]
+      get '/lookup/1/', :query => { :uri => uri, :extras => [type, "detail"].slice(0, detail).join }
+    end
+  end
+  
+  # = Grooveshark API
+  # Searches Grooveshark using the {Tinysong API}[http://tinysong.com/api]
+  class Grooveshark
+    include HTTParty
+    format :json
+    default_params :format => 'json'
+    
+    # Searches Grooveshark (tinysong), returns a maximum of +limit+ results
+    def self.search(uri, limit = 3)
+      get "http://tinysong.com/s/#{CGI::escape uri}", :query => { :limit => limit }
+    end
+  end
+  
+  # = iTunes API
+  # This code would not have been possible if I hadn’t found {itms-lib}[http://itms-lib.rubyforge.org/].
+  # It made my quest for an iTunes search API much shorter.
+  class ITunes
+    include HTTParty
+    headers 'User-Agent' => 'iTunes/9.1'
+    format :plain
+    
+    # Searches iTunes for +term+.
+    def self.search(term)
+      result = get 'http://ax.phobos.apple.com.edgesuite.net/WebObjects/MZSearch.woa/wa/search?submit=edit&term=%s' % CGI::escape(term)
+      itms   = Nokogiri::XML result
+      Plist::parse_xml(itms.css('TrackList plist').to_s)["items"]
+    end
+  end
+end

metadata

@@ -0,0 +1,108 @@
+--- !ruby/object:Gem::Specification 
+name: Musix
+version: !ruby/object:Gem::Version 
+  prerelease: false
+  segments: 
+  - 0
+  - 1
+  version: "0.1"
+platform: ruby
+authors: 
+- Kim Burgestrand
+autorequire: 
+bindir: bin
+cert_chain: []
+
+date: 2010-04-25 00:00:00 +02:00
+default_executable: 
+dependencies: 
+- !ruby/object:Gem::Dependency 
+  name: httparty
+  prerelease: false
+  requirement: &id001 !ruby/object:Gem::Requirement 
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        segments: 
+        - 0
+        version: "0"
+  type: :runtime
+  version_requirements: *id001
+- !ruby/object:Gem::Dependency 
+  name: nokogiri
+  prerelease: false
+  requirement: &id002 !ruby/object:Gem::Requirement 
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        segments: 
+        - 0
+        version: "0"
+  type: :runtime
+  version_requirements: *id002
+- !ruby/object:Gem::Dependency 
+  name: plist
+  prerelease: false
+  requirement: &id003 !ruby/object:Gem::Requirement 
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        segments: 
+        - 0
+        version: "0"
+  type: :runtime
+  version_requirements: *id003
+- !ruby/object:Gem::Dependency 
+  name: metaid
+  prerelease: false
+  requirement: &id004 !ruby/object:Gem::Requirement 
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        segments: 
+        - 0
+        version: "0"
+  type: :runtime
+  version_requirements: *id004
+description: 
+email: kim@burgestrand.se
+executables: []
+
+extensions: []
+
+extra_rdoc_files: []
+
+files: 
+- lib/musix.rb
+has_rdoc: true
+homepage: http://github.com/Burgestrand/Musix
+licenses: []
+
+post_install_message: 
+rdoc_options: []
+
+require_paths: 
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement 
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      segments: 
+      - 0
+      version: "0"
+required_rubygems_version: !ruby/object:Gem::Requirement 
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      segments: 
+      - 0
+      version: "0"
+requirements: []
+
+rubyforge_project: 
+rubygems_version: 1.3.6
+signing_key: 
+specification_version: 3
+summary: A simplified API for searching iTunes, Grooveshark and Spotify
+test_files: []
+