lastfm-client 0.0.3

data/.gitignore

@@ -0,0 +1,4 @@
+pkg/*
+*.gem
+.bundle
+Gemfile.lock

data/.rspec

@@ -0,0 +1 @@
+--colour

data/Gemfile

@@ -0,0 +1,7 @@
+source "http://rubygems.org"
+
+# Specify your gem's dependencies in lastfm.gemspec
+gemspec
+
+gem "rake"
+gem "rspec", "~>2.0.0"

data/LICENSE

@@ -0,0 +1,20 @@
+Copyright (c) 2010 Piotr Chmolowski
+
+Permission is hereby granted, free of charge, to any person obtaining
+a copy of this software and associated documentation files (the
+"Software"), to deal in the Software without restriction, including
+without limitation the rights to use, copy, modify, merge, publish,
+distribute, sublicense, and/or sell copies of the Software, and to
+permit persons to whom the Software is furnished to do so, subject to
+the following conditions:
+
+The above copyright notice and this permission notice shall be
+included in all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
+EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
+MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
+NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE
+LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION
+OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION
+WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

data/README.md

@@ -0,0 +1,60 @@
+# Last.fm API Ruby Client
+
+LastFM is a Ruby wrapper for [Last.fm API](http://www.last.fm/api).
+
+## Installation
+
+Add the following line to your Gemfile and run `bundle install`:
+
+```ruby
+gem 'lastfm-client', :git => 'http://github.com/pch/lastfm-client.git'
+```
+
+You also need to set up your API key and client name, e.g.:
+
+```ruby
+LastFM.api_key     = "7234655fd87556209fa94ca6f5e7ad0a8b47f394"
+LastFM.client_name = "My awesome app"
+```
+
+If you're using Rails, you can add the above lines to an initalizer file, e.g. `config/initializers/lastfm.rb`
+
+## Usage examples
+
+```ruby
+LastFM::Album.get_info(:artist => "Red Hot Chili Peppers", :album => "Mother's Milk")
+LastFM::Artist.get_top_fans(:artist => "Gorillaz")
+LastFM::Geo.get_events(:location => "Warsaw")
+LastFM::User.get_top_albums(:user => "some_user")
+```
+
+### Authentication
+
+For some methods Last.fm requires authentication, which is somewhat similar to oAuth:
+
+```ruby
+class SessionsController < ApplicationController
+  def new
+    redirect_to LastFM.auth_url
+  end
+
+  def create
+    token = params[:token]
+    redirect_to root_path and return if !token || token == ""
+
+    api_session = LastFM::Auth.get_session(:token => token, :api_sig => true)
+    api_session = api_session["session"]
+
+    user = User.find_by_username(api_session["name"])
+    unless user
+      # new user
+      user = User.create(:username => api_session["name"])
+    end
+
+    session[:user_id]     = user.id
+    session[:session_key] = api_session["key"]
+
+    redirect_to root_path
+  end
+end
+```

data/Rakefile

@@ -0,0 +1,6 @@
+require 'bundler'
+Bundler::GemHelper.install_tasks
+
+require "rspec"
+require "rspec/core/rake_task"
+RSpec::Core::RakeTask.new(:spec)

data/lastfm.gemspec

@@ -0,0 +1,21 @@
+# -*- encoding: utf-8 -*-
+$:.push File.expand_path("../lib", __FILE__)
+require "lastfm-client/version"
+
+Gem::Specification.new do |s|
+  s.name        = "lastfm-client"
+  s.version     = LastFM::VERSION
+  s.platform    = Gem::Platform::RUBY
+  s.authors     = ["Piotr Chmolowski"]
+  s.email       = ["piotr@chmolowski.pl"]
+  s.homepage    = "http://github.com/pch/lastfm-client"
+  s.summary     = "Last.fm API client"
+  s.description = "Last.fm API client"
+
+  s.add_dependency "json", ">= 1.4.6"
+
+  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"]
+end

data/lib/lastfm-client.rb

@@ -0,0 +1,130 @@
+require "open-uri"
+require "uri"
+require "json"
+require "digest/md5"
+require "net/http"
+require "cgi"
+
+module LastFM
+  class APIException < StandardError; end
+  class InvalidData  < APIException;  end
+
+  extend self
+
+  autoload :APIClass,    'lastfm-client/api_class'
+  autoload :Album,       'lastfm-client/api_classes/album'
+  autoload :Artist,      'lastfm-client/api_classes/artist'
+  autoload :Auth,        'lastfm-client/api_classes/auth'
+  autoload :Chart,       'lastfm-client/api_classes/chart'
+  autoload :Event,       'lastfm-client/api_classes/event'
+  autoload :Geo,         'lastfm-client/api_classes/geo'
+  autoload :Group,       'lastfm-client/api_classes/group'
+  autoload :Library,     'lastfm-client/api_classes/library'
+  autoload :Playlist,    'lastfm-client/api_classes/playlist'
+  autoload :Radio,       'lastfm-client/api_classes/radio'
+  autoload :Tag,         'lastfm-client/api_classes/tag'
+  autoload :Tasteometer, 'lastfm-client/api_classes/tasteometer'
+  autoload :Track,       'lastfm-client/api_classes/track'
+  autoload :User,        'lastfm-client/api_classes/user'
+  autoload :Venue,       'lastfm-client/api_classes/venue'
+
+  DEFAULT_API_URL  = 'http://ws.audioscrobbler.com/2.0/'
+  DEFAULT_AUTH_URL = 'http://www.last.fm/api/auth/'
+
+  def api_url
+    @api_url || DEFAULT_API_URL
+  end
+
+  def api_url=(url)
+    @api_url = url
+  end
+
+  def api_key
+    @api_key or raise "API Key is not set"
+  end
+
+  def api_key=(key)
+    @api_key = key
+  end
+
+  def secret
+    @secret or raise "Secret is not set"
+  end
+
+  def secret=(secret)
+    @secret = secret
+  end
+
+  def client_name
+    @client_name or raise "Client name is not set"
+  end
+
+  def client_name=(name)
+    @client_name = name
+  end
+
+  def auth_url
+    (@auth_url || DEFAULT_AUTH_URL) + "?api_key=#{self.api_key}"
+  end
+
+  def auth_url=(url)
+    @auth_url = url
+  end
+
+  def send_api_request(method, params, request_method = :get)
+    raise "Invalid params" unless params.is_a?(Hash)
+
+    params[:method]  = method
+    params[:api_key] = self.api_key
+
+    if params[:api_sig] == true
+      params.delete(:api_sig)
+      params[:api_sig] = generate_signature(params)
+    end
+
+    params[:format] = "json"
+
+    if request_method == :post
+      post_data(self.api_url, params)
+    else
+      fetch_data(self.api_url + "?" + hash_to_params(params))
+    end
+  end
+
+  def fetch_data(url)
+    open(url, "User-Agent" => client_name) do |page|
+      ::JSON.parse(page.read)
+    end
+  end
+
+  #
+  # FIXME: returns either 403 or bad signature errors
+  #
+  def post_data(url, params)
+    url = URI.parse(url)
+    req = Net::HTTP::Post.new(url.path)
+    req.set_form_data(params)
+
+    res = Net::HTTP.new(url.host, url.port).start { |http| http.request(req) }
+
+    case res
+    when Net::HTTPSuccess, Net::HTTPRedirection
+      return ::JSON.parse(res.body)
+    when Net::HTTPClientError
+      raise LastFM::InvalidData, res.body if res.code == "422" # unprocessable entity
+    end
+
+    raise LastFM::APIException, res.error!
+  end
+
+  def generate_signature(params)
+    params    = params.sort_by { |k,v| k.to_s }
+    signature = params.map { |param| "#{param[0].to_s}#{param[1].to_s}" }.join('')
+    
+    Digest::MD5.hexdigest(signature + self.secret)
+  end
+
+  def hash_to_params(hash)
+    hash.map { |key, value| "#{key.to_s}=#{::CGI.escape(value.to_s)}" }.join('&')
+  end
+end

data/lib/lastfm-client/api_class.rb

@@ -0,0 +1,57 @@
+module LastFM
+  class APIClass
+
+    def self.unrestricted_methods(*args)
+      args.each do |method|
+        define_api_method(method) do |params|
+          raise ArgumentError, "Params should be a hash" unless params.is_a?(Hash)
+          send_request(method, params)
+        end
+      end
+    end
+
+    def self.restricted_methods(*args, &block)
+      if block_given?
+        yield
+      else
+        read(*args)
+      end
+    end
+
+    def self.read(*args)
+      args.each do |method|
+        define_api_method(method) do |params|
+          restricted_method(method, params)
+        end
+      end
+    end
+
+    def self.write(*args)
+      args.each do |method|
+        define_api_method(method) do |params|
+          restricted_method(method, params, :post)
+        end
+      end
+    end
+
+    def self.restricted_method(method, params, request_method = :get)
+      raise ArgumentError, "Params should be a hash" unless params.is_a?(Hash)
+
+      params[:api_sig] = true
+      send_request(method, params, request_method)
+    end
+
+    def self.send_request(method, params, request_method = :get)
+      api_method  = self.to_s.split("::").last + "." # LastFM::Album => Album
+      api_method += method.to_s.tr('_', '')          # get_info => getinfo
+
+      LastFM.send_api_request(api_method.downcase, params, request_method)
+    end
+
+    def self.define_api_method(method, &block)
+      (class << self; self; end).instance_eval do
+        define_method(method, &block)
+      end
+    end
+  end
+end

data/lib/lastfm-client/api_classes/album.rb

@@ -0,0 +1,9 @@
+module LastFM
+  class Album < APIClass
+    unrestricted_methods :get_buy_links, :get_info, :get_shouts, :get_tags, :get_top_tags, :search
+
+    restricted_methods do
+      write :add_tags, :remove_tag, :share
+    end
+  end
+end

data/lib/lastfm-client/api_classes/artist.rb

@@ -0,0 +1,12 @@
+module LastFM
+  class Artist < APIClass
+    unrestricted_methods :get_correction, :get_events, :get_images, :get_info, :get_past_events,
+                         :get_podcast, :get_shouts, :get_similar, :get_top_albums, :get_top_fans,
+                         :get_top_tags, :get_top_tracks, :search
+
+    restricted_methods do
+      read  :get_tags
+      write :add_tags, :remove_tag, :share, :shout
+    end
+  end
+end

data/lib/lastfm-client/api_classes/auth.rb

@@ -0,0 +1,6 @@
+module LastFM
+  class Auth < APIClass
+    unrestricted_methods :get_token
+    restricted_methods   :get_mobile_session, :get_session
+  end
+end

data/lib/lastfm-client/api_classes/chart.rb

@@ -0,0 +1,6 @@
+module LastFM
+  class Chart < APIClass
+    unrestricted_methods :get_hyped_artists, :get_hyped_tracks, :get_loved_tracks,
+                         :get_top_artists, :get_top_tags, :get_top_tracks
+  end
+end

data/lib/lastfm-client/api_classes/event.rb

@@ -0,0 +1,9 @@
+module LastFM
+  class Event < APIClass
+    unrestricted_methods :get_attendees, :get_info, :get_shouts
+    
+    restricted_methods do
+      write :attend, :share, :shout
+    end
+  end
+end

data/lib/lastfm-client/api_classes/geo.rb

@@ -0,0 +1,7 @@
+module LastFM
+  class Geo < APIClass
+    unrestricted_methods :get_events, :get_metro_artist_chart, :get_metro_hype_artist_chart, :get_metro_hype_track_chart,
+                         :get_metro_track_chart, :get_metro_unique_artist_chart, :get_metro_unique_track_chart,
+                         :get_metro_weekly_chartlist, :get_metros, :get_top_artists, :get_top_tracks
+  end
+end

data/lib/lastfm-client/api_classes/group.rb

@@ -0,0 +1,6 @@
+module LastFM
+  class Group < APIClass
+    unrestricted_methods :get_hype, :get_members, :get_weekly_album_chart, :get_weekly_artist_chart,
+                         :get_weekly_chart_list, :get_weekly_trackchart
+  end
+end

data/lib/lastfm-client/api_classes/library.rb

@@ -0,0 +1,9 @@
+module LastFM
+  class Library < APIClass
+    unrestricted_methods :get_albums, :get_artists, :get_tracks
+    
+    restricted_methods do 
+      write :add_album, :add_artist, :add_track
+    end
+  end
+end

data/lib/lastfm-client/api_classes/playlist.rb

@@ -0,0 +1,9 @@
+module LastFM
+  class Playlist < APIClass
+    unrestricted_methods :fetch
+    
+    restricted_methods do 
+      write :add_track, :create
+    end
+  end
+end

data/lib/lastfm-client/api_classes/radio.rb

@@ -0,0 +1,10 @@
+module LastFM
+  class Radio < APIClass
+    unrestricted_methods :search
+    
+    restricted_methods do
+      read  :get_playlist
+      write :tune
+    end
+  end
+end

data/lib/lastfm-client/api_classes/tag.rb

@@ -0,0 +1,6 @@
+module LastFM
+  class Tag < APIClass
+    unrestricted_methods :get_info, :get_similar, :get_top_albums, :get_top_artists, :get_top_tags,
+                         :get_top_tracks, :get_weekly_artist_chart, :get_weekly_chart_list, :search
+  end
+end

data/lib/lastfm-client/api_classes/tasteometer.rb

@@ -0,0 +1,5 @@
+module LastFM
+  class Tasteometer < APIClass
+    unrestricted_methods :compare
+  end
+end

data/lib/lastfm-client/api_classes/track.rb

@@ -0,0 +1,11 @@
+module LastFM
+  class Track < APIClass
+    unrestricted_methods :get_buy_links, :get_correction, :get_fingerprint_metadata, :get_info,
+                         :get_similar, :get_top_fans, :get_top_tags, :search
+
+    restricted_methods do
+      read  :get_tags
+      write :add_tags, :ban, :love, :remove_tag, :scrobble, :share, :unban, :unlove, :update_now_playing
+    end
+  end
+end

data/lib/lastfm-client/api_classes/user.rb

@@ -0,0 +1,15 @@
+module LastFM
+  class User < APIClass
+    unrestricted_methods :get_artist_tracks, :get_banned_tracks, :get_events, :get_friends,
+                         :get_info, :get_loved_tracks, :get_neighbours, :get_new_releases,
+                         :get_past_events, :get_playlists, :get_recent_tracks, :get_shouts,
+                         :get_top_albums, :get_top_artists, :get_top_tags, :get_top_tracks,
+                         :get_weekly_album_chart, :get_weekly_artist_chart, :get_weekly_chart_list,
+                         :get_weekly_track_chart
+
+    restricted_methods do
+      read  :get_recent_stations, :get_recommended_artists, :get_recommended_events
+      write :shout
+    end
+  end
+end

data/lib/lastfm-client/api_classes/venue.rb

@@ -0,0 +1,5 @@
+module LastFM
+  class Venue < APIClass
+    unrestricted_methods :get_events, :get_past_events, :search
+  end
+end

data/lib/lastfm-client/version.rb

@@ -0,0 +1,3 @@
+module LastFM
+  VERSION = "0.0.3"
+end

data/spec/api_class_spec.rb

@@ -0,0 +1,33 @@
+require "spec_helper"
+
+describe LastFM::APIClass do
+  it "should define unrestricted methods" do
+    LastFM::APIClass.unrestricted_methods(:foo, :bar, :baz)
+    LastFM::APIClass.unrestricted_methods.should be_an(Array)
+  end
+
+  it "should not allow to call an undefined method" do
+    lambda { LastFM::APIClass.i_wasnt_defined }.should raise_error(NoMethodError)
+  end
+
+  it "should not allow to call a method with invalid params" do
+    lambda { LastFM::APIClass.foo("not a hash") }.should raise_error(ArgumentError, "Params should be a hash")
+  end
+
+  it "should respond to unrestricted methods" do
+    LastFM.should_receive(:send_api_request).with("apiclass.foo", {:bar => :baz}, :get).and_return({})
+    LastFM::APIClass.foo(:bar => :baz).should be_a(Hash)
+  end
+
+  it "should define restricted methods" do
+    LastFM::APIClass.restricted_methods(:foo1, :bar1, :baz1)
+    LastFM::APIClass.should respond_to(:foo1)
+    LastFM::APIClass.should respond_to(:bar1)
+    LastFM::APIClass.should respond_to(:baz1)
+  end
+
+  it "should respond to restricted methods" do
+    LastFM.should_receive(:send_api_request).with("apiclass.foo1", {:bar => :baz, :api_sig => true}, :get).and_return({})
+    LastFM::APIClass.foo1(:bar => :baz).should be_a(Hash)
+  end
+end

data/spec/api_classes/album_spec.rb

@@ -0,0 +1,28 @@
+require "spec_helper"
+
+describe LastFM::Album do
+  it "should define unrestricted methods" do
+    LastFM::Album.should respond_to(:get_buy_links, :get_info,  :get_top_tags, :search)
+  end
+
+  it "should respond to unrestricted methods" do
+    LastFM.should_receive(:send_api_request).with("album.getinfo", {:bar => :baz}, :get).and_return({})
+    LastFM::Album.get_info(:bar => :baz).should be_a(Hash)
+  end
+
+  describe "restricted methods" do
+    it "should define restricted methods" do
+      LastFM::Album.should respond_to(:get_tags, :add_tags, :remove_tag, :share)
+    end
+    
+    it "should respond to restricted read methods" do
+      LastFM.should_receive(:send_api_request).with("album.gettags", {:bar => :baz}, :get).and_return({})
+      LastFM::Album.get_tags(:bar => :baz).should be_a(Hash)
+    end
+
+    it "should respond to restricted write methods" do
+      LastFM.should_receive(:send_api_request).with("album.addtags", {:bar => :baz, :api_sig => true}, :post).and_return({})
+      LastFM::Album.add_tags(:bar => :baz).should be_a(Hash)
+    end
+  end
+end

data/spec/api_classes/artist_spec.rb

@@ -0,0 +1,15 @@
+require "spec_helper"
+
+describe LastFM::Artist do
+  it "should define unrestricted methods" do
+    LastFM::Artist.should respond_to(
+      :get_correction, :get_events, :get_images, :get_info, :get_past_events,
+      :get_podcast, :get_shouts, :get_similar, :get_top_albums, :get_top_fans,
+      :get_top_tags, :get_top_tracks, :search
+    )
+  end
+  
+  it "should define restricted methods" do
+    LastFM::Artist.should respond_to(:add_tags, :get_tags, :remove_tag, :share, :shout)
+  end
+end

data/spec/api_classes/auth_spec.rb

@@ -0,0 +1,11 @@
+require "spec_helper"
+
+describe LastFM::Auth do
+  it "should define unrestricted methods" do
+    LastFM::Auth.should respond_to(:get_token)
+  end
+
+  it "should define restricted methods" do
+    LastFM::Auth.should respond_to(:get_mobile_session, :get_session)
+  end
+end

data/spec/api_classes/chart_spec.rb

@@ -0,0 +1,7 @@
+require "spec_helper"
+
+describe LastFM::Chart do
+  it "should define unrestricted methods" do
+    LastFM::Chart.should respond_to(:get_hyped_artists, :get_hyped_tracks, :get_loved_tracks, :get_top_artists, :get_top_tags, :get_top_tracks)
+  end
+end

data/spec/api_classes/event_spec.rb

@@ -0,0 +1,11 @@
+require "spec_helper"
+
+describe LastFM::Event do
+  it "should define unrestricted methods" do
+    LastFM::Event.should respond_to(:get_attendees, :get_info, :get_shouts)
+  end
+
+  it "should define restricted methods" do
+    LastFM::Event.should respond_to(:attend, :share, :shout)
+  end
+end

data/spec/api_classes/geo_spec.rb

@@ -0,0 +1,7 @@
+require "spec_helper"
+
+describe LastFM::Geo do
+  it "should define unrestricted methods" do
+    LastFM::Geo.should respond_to(:get_events, :get_metro_artist_chart, :get_metro_hype_artist_chart, :get_metro_hype_track_chart, :get_metro_track_chart, :get_metro_unique_artist_chart, :get_metro_unique_track_chart, :get_metro_weekly_chartlist, :get_metros, :get_top_artists, :get_top_tracks)
+  end
+end

data/spec/api_classes/group_spec.rb

@@ -0,0 +1,10 @@
+require "spec_helper"
+
+describe LastFM::Group do
+  it "should define unrestricted methods" do
+    LastFM::Group.should respond_to(
+      :get_hype, :get_members, :get_weekly_album_chart, :get_weekly_artist_chart,
+      :get_weekly_chart_list, :get_weekly_trackchart
+    )
+  end
+end

data/spec/api_classes/library_spec.rb

@@ -0,0 +1,11 @@
+require "spec_helper"
+
+describe LastFM::Library do
+  it "should define unrestricted methods" do
+    LastFM::Library.should respond_to(:get_albums, :get_artists, :get_tracks)
+  end
+
+  it "should define restricted methods" do
+    LastFM::Library.should respond_to(:add_album, :add_artist, :add_track)
+  end
+end

data/spec/api_classes/playlist_spec.rb

@@ -0,0 +1,11 @@
+require "spec_helper"
+
+describe LastFM::Playlist do
+  it "should define unrestricted methods" do
+    LastFM::Playlist.should respond_to(:fetch)
+  end
+
+  it "should define restricted methods" do
+    LastFM::Playlist.should respond_to(:add_track, :create)
+  end
+end

data/spec/api_classes/radio_spec.rb

@@ -0,0 +1,11 @@
+require "spec_helper"
+
+describe LastFM::Radio do
+  it "should define unrestricted methods" do
+    LastFM::Radio.should respond_to(:search)
+  end
+  
+  it "should define restricted methods" do
+    LastFM::Radio.should respond_to(:get_playlist, :tune)
+  end
+end

data/spec/api_classes/tag_spec.rb

@@ -0,0 +1,7 @@
+require "spec_helper"
+
+describe LastFM::Tag do
+  it "should define unrestricted methods" do
+    LastFM::Tag.should respond_to(:get_similar, :get_top_albums, :get_top_artists, :get_top_tags, :get_top_tracks, :get_weekly_artist_chart, :get_weekly_chart_list, :search)
+  end
+end

data/spec/api_classes/tasteometer_spec.rb

@@ -0,0 +1,7 @@
+require "spec_helper"
+
+describe LastFM::Tasteometer do
+  it "should define unrestricted methods" do
+    LastFM::Tasteometer.should respond_to(:compare)
+  end
+end

data/spec/api_classes/track_spec.rb

@@ -0,0 +1,17 @@
+require "spec_helper"
+
+describe LastFM::Track do
+  it "should define unrestricted methods" do
+    LastFM::Track.should respond_to(
+      :get_buy_links, :get_correction, :get_fingerprint_metadata, :get_info,
+      :get_similar, :get_top_fans, :get_top_tags, :search
+    )
+  end
+
+  it "should define restricted methods" do
+    LastFM::Track.should respond_to(
+      :get_tags, :add_tags, :ban, :love, :remove_tag, :scrobble, :share, :unban,
+      :unlove, :update_now_playing
+    )
+  end
+end

data/spec/api_classes/user_spec.rb

@@ -0,0 +1,18 @@
+require "spec_helper"
+
+describe LastFM::User do
+  it "should define unrestricted methods" do
+    LastFM::User.should respond_to(
+      :get_artist_tracks, :get_banned_tracks, :get_events, :get_friends,
+      :get_info, :get_loved_tracks, :get_neighbours, :get_new_releases,
+      :get_past_events, :get_playlists, :get_recent_tracks, :get_shouts,
+      :get_top_albums, :get_top_artists, :get_top_tags, :get_top_tracks,
+      :get_weekly_album_chart, :get_weekly_artist_chart, :get_weekly_chart_list,
+      :get_weekly_track_chart
+    )
+  end
+
+  it "should define restricted methods" do
+    LastFM::User.should respond_to(:get_recent_stations, :get_recommended_artists, :get_recommended_events, :shout)
+  end
+end

data/spec/api_classes/venue_spec.rb

@@ -0,0 +1,7 @@
+require "spec_helper"
+
+describe LastFM::Venue do
+  it "should define unrestricted methods" do
+    LastFM::Venue.should respond_to(:get_events, :get_past_events, :search)
+  end
+end

data/spec/lastfm-client_spec.rb

@@ -0,0 +1,101 @@
+require "spec_helper"
+
+describe LastFM do
+  it "should have a default API URL" do
+    LastFM.api_url.should == LastFM::DEFAULT_API_URL
+  end
+
+  it "should allow to set a custom API URL" do
+    custom_url = "http://foobar.com"
+
+    LastFM.api_url = custom_url
+    LastFM.api_url.should == custom_url
+  end
+
+  it "should set API key" do
+    LastFM.api_key = "1234"
+    LastFM.api_key.should == "1234"
+  end
+
+  it "should raise error when trying to read empty token" do
+    LastFM.api_key = nil
+    lambda { LastFM.api_key }.should raise_error(RuntimeError, "API Key is not set")
+  end
+
+  it "should set secret" do
+    LastFM.secret = "123456"
+    LastFM.secret.should == "123456"
+  end
+
+  it "should raise error when trying to read empty secret" do
+    LastFM.secret = nil
+    lambda { LastFM.secret }.should raise_error(RuntimeError, "Secret is not set")
+  end
+
+  it "should set client name" do
+    LastFM.client_name = "Foobar"
+    LastFM.client_name.should == "Foobar"
+  end
+
+  it "should raise error when trying to read empty client name" do
+    LastFM.client_name = nil
+    lambda { LastFM.client_name }.should raise_error(RuntimeError, "Client name is not set")
+  end
+
+  it "should have a default Auth URL" do
+    LastFM.api_key = "1234"
+    LastFM.auth_url.should == LastFM::DEFAULT_AUTH_URL + "?api_key=1234"
+  end
+
+  it "should allow to set a custom Auth URL" do
+    custom_url = "http://foobarbaz.com"
+
+    LastFM.auth_url = custom_url
+    LastFM.auth_url.should == custom_url + "?api_key=1234"
+  end
+
+  describe "API requests" do
+    it "should raise error when trying to supply invalid params" do
+      lambda { LastFM.send_api_request("test", nil) }.should raise_error(RuntimeError, "Invalid params")
+    end
+
+    it "should generate key signature" do
+      LastFM.secret = "test"
+      signature = LastFM.generate_signature(:foo => "hey", :bar => "hi", :baz => "hello")
+      signature.should == "46bfc3df86f175c869101e1c8c171589"
+    end
+
+    it "should send request" do
+      LastFM.api_url     = LastFM::DEFAULT_API_URL
+      LastFM.api_key     = "7fbc71d4b818dc1277e273ac1ef92b07"
+      LastFM.client_name = "Last.fm Ruby gem"
+
+      LastFM.should_receive(:fetch_data).with("http://ws.audioscrobbler.com/2.0/?artist=Cher&album=Believe&method=album.getinfo&api_key=7fbc71d4b818dc1277e273ac1ef92b07&format=json").and_return({})
+
+      response = LastFM.send_api_request("album.getinfo", :artist => "Cher", :album => "Believe")
+      response.should be_a(Hash)
+    end
+
+    it "should send GET request by default" do
+      LastFM.should_receive(:fetch_data).with("http://ws.audioscrobbler.com/2.0/?artist=Cher&album=Believe&method=album.getinfo&api_key=7fbc71d4b818dc1277e273ac1ef92b07&format=json").and_return({})
+
+      response = LastFM.send_api_request("album.getinfo", :artist => "Cher", :album => "Believe")
+      response.should be_a(Hash)
+    end
+
+    it "should send request with key signature" do
+      LastFM.secret = "test"
+      LastFM.should_receive(:fetch_data).with("http://ws.audioscrobbler.com/2.0/?artist=Cher&album=Believe&method=album.getinfo&api_key=7fbc71d4b818dc1277e273ac1ef92b07&api_sig=b796a3385c59872367f31fc510a4ee21&format=json").and_return({})
+
+      response = LastFM.send_api_request("album.getinfo", :artist => "Cher", :album => "Believe", :api_sig => true)
+      response.should be_a(Hash)
+    end
+
+    it "should send POST requests" do
+      LastFM.should_receive(:post_data).with("http://ws.audioscrobbler.com/2.0/", {:user => "jeff", :message => "hi Jeff!", :method => "user.shout", :api_key => "7fbc71d4b818dc1277e273ac1ef92b07", :api_sig => "83c66301079de9f515be5e0206ddbb18", :format => "json"}).and_return({})
+
+      response = LastFM.send_api_request("user.shout", {:user => "jeff", :message => "hi Jeff!", :api_sig => true}, :post)
+      response.should be_a(Hash)
+    end
+  end
+end

data/spec/spec_helper.rb

@@ -0,0 +1,4 @@
+require "bundler"
+Bundler.setup
+
+require "lastfm-client"

metadata

@@ -0,0 +1,120 @@
+--- !ruby/object:Gem::Specification
+name: lastfm-client
+version: !ruby/object:Gem::Version
+  version: 0.0.3
+  prerelease: 
+platform: ruby
+authors:
+- Piotr Chmolowski
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2012-03-05 00:00:00.000000000Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: json
+  requirement: &70293269416280 !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: 1.4.6
+  type: :runtime
+  prerelease: false
+  version_requirements: *70293269416280
+description: Last.fm API client
+email:
+- piotr@chmolowski.pl
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- .DS_Store
+- .gitignore
+- .rspec
+- Gemfile
+- LICENSE
+- README.md
+- Rakefile
+- lastfm.gemspec
+- lib/.DS_Store
+- lib/lastfm-client.rb
+- lib/lastfm-client/.DS_Store
+- lib/lastfm-client/api_class.rb
+- lib/lastfm-client/api_classes/album.rb
+- lib/lastfm-client/api_classes/artist.rb
+- lib/lastfm-client/api_classes/auth.rb
+- lib/lastfm-client/api_classes/chart.rb
+- lib/lastfm-client/api_classes/event.rb
+- lib/lastfm-client/api_classes/geo.rb
+- lib/lastfm-client/api_classes/group.rb
+- lib/lastfm-client/api_classes/library.rb
+- lib/lastfm-client/api_classes/playlist.rb
+- lib/lastfm-client/api_classes/radio.rb
+- lib/lastfm-client/api_classes/tag.rb
+- lib/lastfm-client/api_classes/tasteometer.rb
+- lib/lastfm-client/api_classes/track.rb
+- lib/lastfm-client/api_classes/user.rb
+- lib/lastfm-client/api_classes/venue.rb
+- lib/lastfm-client/version.rb
+- spec/api_class_spec.rb
+- spec/api_classes/album_spec.rb
+- spec/api_classes/artist_spec.rb
+- spec/api_classes/auth_spec.rb
+- spec/api_classes/chart_spec.rb
+- spec/api_classes/event_spec.rb
+- spec/api_classes/geo_spec.rb
+- spec/api_classes/group_spec.rb
+- spec/api_classes/library_spec.rb
+- spec/api_classes/playlist_spec.rb
+- spec/api_classes/radio_spec.rb
+- spec/api_classes/tag_spec.rb
+- spec/api_classes/tasteometer_spec.rb
+- spec/api_classes/track_spec.rb
+- spec/api_classes/user_spec.rb
+- spec/api_classes/venue_spec.rb
+- spec/lastfm-client_spec.rb
+- spec/spec_helper.rb
+homepage: http://github.com/pch/lastfm-client
+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: 
+rubygems_version: 1.8.11
+signing_key: 
+specification_version: 3
+summary: Last.fm API client
+test_files:
+- spec/api_class_spec.rb
+- spec/api_classes/album_spec.rb
+- spec/api_classes/artist_spec.rb
+- spec/api_classes/auth_spec.rb
+- spec/api_classes/chart_spec.rb
+- spec/api_classes/event_spec.rb
+- spec/api_classes/geo_spec.rb
+- spec/api_classes/group_spec.rb
+- spec/api_classes/library_spec.rb
+- spec/api_classes/playlist_spec.rb
+- spec/api_classes/radio_spec.rb
+- spec/api_classes/tag_spec.rb
+- spec/api_classes/tasteometer_spec.rb
+- spec/api_classes/track_spec.rb
+- spec/api_classes/user_spec.rb
+- spec/api_classes/venue_spec.rb
+- spec/lastfm-client_spec.rb
+- spec/spec_helper.rb