lastdotfm 1.0.0

data/Gemfile

@@ -0,0 +1,4 @@
+source "http://rubygems.org"
+
+# Specify your gem's dependencies in lastdotfm.gemspec
+gemspec

data/README.md

@@ -0,0 +1,19 @@
+Wrapper around the http://www.last.fm public API. 
+
+Still in development. Although probably won't be doing much more with it. 
+
+ToDo
+====
+
+1. Authenticated Functions
+1. Fix up redundancy 
+
+Usage
+======
+
+1. lastfm = Lastdotfm.new
+1. lastfm.album("Cher", "Believe").info
+1. lastfm.artist("Bjork").images
+1. lastfm.album_search("LCD Soundsystem", "This is Happening")
+1. lastfm.tag("Disco").info
+1. lastfm.venue(<venue_id_>).events

data/Rakefile

@@ -0,0 +1,2 @@
+require 'bundler'
+Bundler::GemHelper.install_tasks

data/lastdotfm.gemspec

@@ -0,0 +1,23 @@
+# -*- encoding: utf-8 -*-
+$:.push File.expand_path("../lib", __FILE__)
+require File.join(File.expand_path(File.dirname(__FILE__)), 'lastdotfm', 'version') 
+
+Gem::Specification.new do |s|
+  s.name        = "lastdotfm"
+  s.version     = Lastdotfm::VERSION
+  s.platform    = Gem::Platform::RUBY
+  s.authors     = ["Brooke McKim"]
+  s.email       = ["brooke.mckim@gmail.com"]
+  s.homepage    = "https://github.com/brookemckim/lastdotfm"
+  s.summary     = %q{Wrapper for the last.fm API.}
+  s.description = %q{Simple wrapper for the last.fm API. Will return raw API results in an HTTParty hash.}
+
+  s.rubyforge_project = "lastdotfm"
+
+  s.files         = `git ls-files`.split("\n")
+  s.test_files    = `git ls-files -- {test,spec,features}/*`.split("\n")
+  s.executables   = `git ls-files -- bin/*`.split("\n").map{ |f| File.basename(f) }
+  s.require_paths = ["lib"]
+  
+  s.add_dependency('httparty')
+end

data/lastdotfm.rb

@@ -0,0 +1,8 @@
+require 'httparty'
+require 'uri'
+
+require File.join(File.expand_path(File.dirname(__FILE__)), 'lastdotfm', "base")
+
+module Lastdotfm
+
+end

data/lastdotfm/album.rb

@@ -0,0 +1,52 @@
+module Lastdotfm
+  class Album < Base
+    
+    def initialize(lastfm, album)
+      @lastfm = lastfm
+      @album  = {}
+      
+      @album[:album]   = album[:album]
+      @album[:artist]  = album[:artist]
+    end  
+
+    #options[:language]
+    #options[:username]
+    #options[:autocorrect]
+    def info(options = {})
+      method = "album.getinfo"
+      params = @album.merge(options)
+      @lastfm.get(method, params)
+    end
+  
+    #options[:country]
+    #options[:autocorrect]
+    def buy_links(optons = {})
+      method = "album.getbuylinks"
+      params = @album.merge(options)
+      @lastfm.get(method, params)
+    end
+
+    #options[:limit]
+    #options[:autocorrect]
+    #options[:page]
+    def shouts(options = {})
+      method = "album.getshouts"
+      params = @album.merge(options)
+      @lastfm.get(method, params)
+    end
+  
+    #Not working yet
+    #def tags_by_user(artist, album, api_sig, session_key)
+    #  method = "album.gettags"
+    #  params = {:artist => artist, :album => album, :api_sig => api_sig, :session_key => session_key}
+    #  @lastfm.get(method, params)
+    #end
+  
+    #options[:autocorrect]
+    def top_tags(options = {})
+      method = "album.gettoptags"
+      params = @album.merge(options)
+      @lastfm.get(method, params)
+    end        
+  end 
+end   

data/lastdotfm/artist.rb

@@ -0,0 +1,91 @@
+module Lastdotfm
+  class Artist < Base
+    
+    def initialize(lastfm, artist)
+      @lastfm = lastfm
+      @artist = artist
+    end
+    
+    #mbid, autocorrect, limit, page, 
+    def events(options = {})
+      method = "artist.getevents"
+      params = {:artist => @artist}.merge(options)
+      @lastfm.get(method, params)
+    end
+    
+    #mbid, autocorrect, limit, page, order
+    def images(options = {})
+      method = "artist.getimages"
+      params = {:artist => @artist}.merge(options)
+      @lastfm.get(method, params)
+    end
+    
+    #mbid, autocorrect, lang, username
+    def info(options = {})
+      method = "artist.getinfo"
+      params = {:artist => @artist}.merge(options)
+      @lastfm.get(method, params)
+    end
+    
+    #autocorrect, mbid, page, limit
+    def past_events(options = {})
+      method = "artist.getpastevents"
+      params = {:artist => @artist}.merge(options)
+      @lastfm.get(method, params)
+    end
+    
+    #autocorrect, mbid
+    def podcast(options = {})
+      method = "artist.getpodcast"
+      params = {:artist => @artist}.merge(options)
+      @lastfm.get(method, params)
+    end
+    
+    #mbid, limit, autocorect, page
+    def shouts(options = {})
+      method = "artist.getshouts"
+      params = {:artist => @artist}.merge(options)
+      @lastfm.get(method, params)
+    end
+    
+    #limit, autocorrect, mbid
+    def similar(options = {})
+      method = "artist.getsimilar"
+      params = {:artist => @artist}.merge(options)
+      @lastfm.get(method, params)
+    end
+    
+    #Needs user auth
+    #def tags(options = {})
+    #  
+    #end
+    
+    #mbid, autocorrect, page, limit
+    def top_albums(options = {})
+      method = "artist.gettopalbums"
+      params = {:artist => @artist}.merge(options)
+      @lastfm.get(method, params)
+    end
+    
+    #mbid, autocorrect
+    def top_fans(options = {})
+      method = "artist.topfans"
+      params = {:artist => @artist}.merge(options)
+      @lastfm.get(method, params)
+    end
+    
+    #mbid, autocorrect
+    def top_tags(options = {})
+      method = "artist.gettoptags"
+      params = {:artist => @artist}.merge(options)
+      @lastfm.get(method, params)
+    end
+    
+    #mbid, autocorrect
+    def top_tracks(options = {})
+      method = "artist.gettoptags"
+      params = {:artist => @artist}.merge(options)
+      @lastfm.get(method, params)
+    end                           
+  end  
+end  

data/lastdotfm/base.rb

@@ -0,0 +1,53 @@
+module Lastdotfm
+  def self.new(api_key)
+    self::Base.new(api_key)
+  end
+      
+  class Base
+    
+    [ "album",
+      "artist",
+      "venue",
+      "search",
+      "event"
+    ].each do |file|      
+      require File.join(File.expand_path(File.dirname(__FILE__)), file)   
+    end
+    
+    include Lastdotfm::Search
+    
+    attr :api_key, true
+    attr :api_secret, true
+    
+    URL_BASE = "http://ws.audioscrobbler.com/2.0/"
+        
+    def initialize(api_key)
+      @api_key    = api_key
+    end  
+        
+    def album(album)         @album  ||= Lastdotfm::Album.new(self, album)     end
+    def artist(artist)       @artist ||= Lastdotfm::Artist.new(self, artist)   end  
+    def user(user)           @user   ||= Lastdotfm::User.new(self, user)       end
+    def venue(venue)         @venue  ||= Lastdotfm::Venue.new(self, venue)     end
+    def event(event)         @event  ||= Lastdotfm::Event.new(self, venue)     end    
+      
+  protected
+  
+    def get(method, options)
+      options.merge!(:api_key => @api_key, :method => method)
+      url = generate_url(options)
+      puts url
+      res = HTTParty.get(url)["lfm"]
+      
+      unless res["status"] == "ok"
+        raise Lastdotfm, res["error"]
+      end
+      
+      return res    
+    end
+  
+    def generate_url(options = nil)
+      url = URI.encode(URL_BASE + "?" + options.collect { |k,v| "#{k}=#{v.to_s}" }.join('&'))
+    end
+  end    
+end  

data/lastdotfm/event.rb

@@ -0,0 +1,32 @@
+module Lastdotfm
+  class Event < Base
+    def initalize(lastfm, event)
+      @lastfm = lastfm
+      @event  = event
+    end
+    
+    #Requires Authentication
+    #def attend
+    #  
+    #end
+    #def share(); end  
+    #def shout(); end
+    def info
+      method = 'event.getInfo'
+      params = {:event => @event}
+      @lastfm.get(method, params)
+    end  
+    
+    def attendees(options = {})  
+      method = 'event.getAttendees'
+      params = {:event => @event}.merge(options)
+      @lastfm.get(method, params)
+    end  
+  
+    def shouts(options = {})
+      method = 'event.getShouts'
+      params = {:event => @event}.merge(options)
+      @lastfm.get(method, params)
+    end
+  end
+end  

data/lastdotfm/search.rb

@@ -0,0 +1,28 @@
+module Lastdotfm
+  module Search
+    #Feel like these should be class methods 
+    def album_search(artist, album, options = {}) 
+      method = "album.search"
+      params = {:artist => artist, :album => album}
+      get(method, params)    
+    end
+
+    def artist_search(artist, options = {})
+      method = "artist.search"
+      params = {:artist => artist}
+      get(method, params)
+    end
+
+    def tag_search(tag, options = {})
+      method = "tag.search"
+      params = {:tag => tag}
+      get(method, params)
+    end
+    
+    def venue_search(venue, options = {})
+      method = "venue.search"
+      params = {:venue => venue}
+      get(method, params)
+    end
+  end  
+end  

data/lastdotfm/tag.rb

@@ -0,0 +1,50 @@
+module Lastdotfm
+  class Tag
+    def initalize(lastfm, tag)
+      @lastfm = lastfm
+      @tag    = tag
+    end
+    
+    def info(options = {})
+      method = 'tag.getInfo'
+      params = {:tag => @tag}.merge(options)
+      @lastfm.get(method, params)
+    end
+    
+    def similar(options = {})
+      method = 'getSimilar'
+      params {:tag => @tag}.merge(options)
+      @lastfm.get(method, params)
+    end
+    
+    def top_albums(options = {})
+      method = 'getTopAlbums'
+      params {:tag => @tag}.merge(options)
+      @lastfm.get(method, params)
+    end   
+    
+    def top(options = {})
+      method = 'getTopTags'
+      params {:tag => @tag}.merge(options)
+      @lastfm.get(method, params)
+    end 
+      
+    def top_tracks(options = {})
+      method = 'getTopTracks'
+      params {:tag => @tag}.merge(options)
+      @lastfm.get(method, params)
+    end
+    
+    def weekly_artists(options = {})
+      method = 'getWeeklyArtistChart'
+      params {:tag => @tag}.merge(options)
+      @lastfm.get(method, params)
+    end
+    
+    def weekly_charts(options = {})
+      method = 'getWeeklyChartList'
+      params {:tag => @tag}.merge(options)
+      @lastfm.get(method, params)
+    end
+  end  
+end  

data/lastdotfm/user.rb

@@ -0,0 +1,161 @@
+module Lastdotfm
+  class User < Base
+    attr :username, true
+
+    def initalize(lastfm, user)
+      @lastfm = lastfm
+      @user   = user
+    end
+    
+    def artist_tracks(options = {})
+      method = 'user.getArtistTracks'
+      params = {:user => @user}.merge(options)
+      @lastfm.get(method, params)
+    end 
+    
+    def banned_tracks(options = {})
+      method = 'user.getBannedTracks'
+      params = {:user => @user}.merge(options)
+      @lastfm.get(method, params)
+    end
+    
+    def events(options = {})
+      method = 'user.getEvents'
+      params = {:user => @user}.merge(options)
+      @lastfm.get(method, params)
+    end
+    
+    def friends(options = {})
+      method = 'user.getFriends'
+      params = {:user => @user}.merge(options)
+      @lastfm.get(method, params)
+    end
+    
+    def info(options = {})
+      method = 'user.getInfo'
+      params = {:user => @user}.merge(options)
+      @lastfm.get(method, params)
+    end
+    
+    def loved_tracks(options = {})
+      method = 'user.getLovedTracks'
+      params = {:user => @user}.merge(options)
+      @lastfm.get(method, params)
+    end
+    
+    def neighbours(options = {})
+      method = 'user.getNeighbours'
+      params = {:user => @user}.merge(options)
+      @lastfm.get(method, params)
+    end  
+    
+    def new_releases(options = {})
+      method = 'user.getNewRelases'
+      params = {:user => @user}.merge(options)
+      @lastfm.get(method, params)
+    end 
+    
+    def past_events(options = {})
+      method = 'user.getPastEvents'
+      params = {:user => @user}.merge(options)
+      @lastfm.get(method, params)
+    end
+    
+    def personal_tags(options = {})
+      method = 'user.getPersonalTags'
+      params = {:user => @user}.merge(options)
+      @lastfm.get(method, params)
+    end
+
+    def playlists(options = {})
+      method = 'user.getPlaylists'
+      params = {:user => @user}.merge(options)
+      @lastfm.get(method, params)
+    end
+    
+    def recent_stations(options = {})
+      method = 'user.getRecentStations'
+      params = {:user => @user}.merge(options)
+      @lastfm.get(method, params)
+    end
+    
+    def recent_tracks(options = {})
+      method = 'user.getRecentTracks'
+      params = {:user => @user}.merge(options)
+      @lastfm.get(method, params)
+    end
+    
+    def recommended_artists(options = {})
+      method = 'user.getRecommendedArtists'
+      params = {:user => @user}.merge(options)
+      @lastfm.get(method, params)
+    end
+    
+    def recommended_events(options = {})
+      method = 'user.getRecommendedEvents'
+      params = {:user => @user}.merge(options)
+      @lastfm.get(method, params)
+    end
+
+    def shouts(options = {})
+      method = 'user.getShouts'
+      params = {:user => @user}.merge(options)
+      @lastfm.get(method, params)
+    end
+
+    def top_albums(options = {})
+      method = 'user.getTopAlbums'
+      params = {:user => @user}.merge(options)
+      @lastfm.get(method, params)
+    end
+
+    def top_artists(options = {})
+      method = 'user.getTopArtists'
+      params = {:user => @user}.merge(options)
+      @lastfm.get(method, params)
+    end
+
+    def top_tags(options = {})
+      method = 'user.getTopTags'
+      params = {:user => @user}.merge(options)
+      @lastfm.get(method, params)
+    end
+
+    def top_tracks(options = {})
+      method = 'user.getTopTracks'
+      params = {:user => @user}.merge(options)
+      @lastfm.get(method, params)
+    end
+
+    def weekly_album_chart(options = {})
+      method = 'user.getWeeklyAlbumChart'
+      params = {:user => @user}.merge(options)
+      @lastfm.get(method, params)
+    end
+
+    def weekly_artist_chart(options = {})
+      method = 'user.getWeeklyArtistChart'
+      params = {:user => @user}.merge(options)
+      @lastfm.get(method, params)
+    end
+    
+    def weekly_chart_list(options = {})
+      method = 'user.getWeeklyChartList'
+      params = {:user => @user}.merge(options)
+      @lastfm.get(method, params)
+    end
+    
+    def weekly_track_chart(options = {})
+      method = 'user.getWeeklyArtistChart'
+      params = {:user => @user}.merge(options)
+      @lastfm.get(method, params)
+    end
+    
+    #Need to implement authentication
+    #def shout(options = {})
+    #  method = 
+    #  params = {:user => @user}.merge(options)
+    #  @lastfm.get(method, params)
+    #end
+  end    
+end

data/lastdotfm/venue.rb

@@ -0,0 +1,20 @@
+module Lastdotfm
+  class Venue < Base
+    def initalize(lastfm, venue_id)
+      @lastfm = lastfm
+      @venue  = venue_id
+    end 
+    
+    def events
+      method = 'venue.getEvents'
+      params = {:venue => @venue}
+      @lastfm.get(method, params)
+    end
+    
+    def past_events(options = {})
+      method = 'venue.getPastEvents'
+      params = {:venue => @venue}.merge(options)
+      @lastfm.get(method, params)
+    end     
+  end
+end    

data/lastdotfm/version.rb

@@ -0,0 +1,3 @@
+module Lastdotfm
+  VERSION = "1.0.0"
+end

metadata

@@ -0,0 +1,78 @@
+--- !ruby/object:Gem::Specification 
+name: lastdotfm
+version: !ruby/object:Gem::Version 
+  prerelease: 
+  version: 1.0.0
+platform: ruby
+authors: 
+- Brooke McKim
+autorequire: 
+bindir: bin
+cert_chain: []
+
+date: 2011-05-08 00:00:00 Z
+dependencies: 
+- !ruby/object:Gem::Dependency 
+  name: httparty
+  prerelease: false
+  requirement: &id001 !ruby/object:Gem::Requirement 
+    none: false
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        version: "0"
+  type: :runtime
+  version_requirements: *id001
+description: Simple wrapper for the last.fm API. Will return raw API results in an HTTParty hash.
+email: 
+- brooke.mckim@gmail.com
+executables: []
+
+extensions: []
+
+extra_rdoc_files: []
+
+files: 
+- Gemfile
+- README.md
+- Rakefile
+- lastdotfm.gemspec
+- lastdotfm.rb
+- lastdotfm/album.rb
+- lastdotfm/artist.rb
+- lastdotfm/base.rb
+- lastdotfm/event.rb
+- lastdotfm/search.rb
+- lastdotfm/tag.rb
+- lastdotfm/user.rb
+- lastdotfm/venue.rb
+- lastdotfm/version.rb
+homepage: https://github.com/brookemckim/lastdotfm
+licenses: []
+
+post_install_message: 
+rdoc_options: []
+
+require_paths: 
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement 
+  none: false
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      version: "0"
+required_rubygems_version: !ruby/object:Gem::Requirement 
+  none: false
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      version: "0"
+requirements: []
+
+rubyforge_project: lastdotfm
+rubygems_version: 1.7.2
+signing_key: 
+specification_version: 3
+summary: Wrapper for the last.fm API.
+test_files: []
+