firstfm 0.0.1

data/README.rdoc

@@ -0,0 +1,23 @@
+=Firstfm
+
+Firstfm is a ruby wrapper for the Last.fm APIs ( http://www.last.fm/api ). 
+
+My main focus is to import events from Last.FM, but with time I will try to add support for all API methods.
+
+== Installation
+
+  sudo gem install firstfm
+
+  create a ~/.firstfm file with this content
+  
+  api_key: YOUR_API_KEY
+
+== Usage
+
+  Firstfm::Venue.search("arena")
+  
+  Firstfm::Venue.get_events(8908030)
+  
+  Firstfm::Geo.get_events :location => "Berlin"
+  
+  

data/lib/firstfm/event.rb

@@ -0,0 +1,39 @@
+module Firstfm
+  
+  class Event
+    
+    attr_accessor :id, :title, :url, :venue, :tag, :description, :attendance, :website, :start_date, :reviews, :artists, :headliner, :tags, :images
+    
+    def self.init_events_from_hash(hash)
+      return [] unless hash["events"] && hash["events"]["event"]
+      return [init_event_from_hash(hash["events"]["event"])] if hash["events"]["event"].is_a?(Hash)
+      
+      hash["events"]["event"].inject([]) do |arr, venue_hash|
+        arr << init_event_from_hash(venue_hash)
+        arr
+      end
+    end
+    
+    def self.init_event_from_hash(hash)
+      return nil unless hash.is_a?(Hash)
+      event = Event.new
+      event.id = hash["id"]
+      event.title = hash["title"]
+      event.url = hash["url"]
+      event.tag = hash["tag"]
+      event.venue = Venue.init_venue_from_hash(hash["venue"])
+      event.description = hash["description"]
+      event.attendance = hash["attendance"]
+      event.reviews = hash["reviews"]
+      event.website = hash["website"]
+      event.start_date = hash['startDate']
+      event.artists = hash['artists']['artist'] if hash['artists']
+      event.headliner = hash['artists']['headliner'] if hash['artists']
+      event.tags = hash["tags"]["tag"] if hash["tags"]
+      event.images = hash["image"]
+      event
+    end
+    
+  end
+  
+end

data/lib/firstfm/geo.rb

@@ -0,0 +1,28 @@
+module Firstfm
+  
+  class Geo
+    
+    include HTTParty
+    base_uri 'ws.audioscrobbler.com'
+    format :xml
+    
+    def self.get_events(params = {})
+      location = params.delete(:location)
+      lat = params.delete(:lat)
+      lng = params.delete(:lng)
+      page = params.delete(:page) || 1
+      distance = params.delete(:distance)
+      
+      response = get("/2.0/", {:query => {:method => 'geo.getevents', :location => location, :page => page, :lat => lat, :lng => lng, :distance => distance, :api_key => Firstfm::CONFIG['api_key']}})
+      events = response && response['lfm'] ? Event.init_events_from_hash(response['lfm']) : []
+      
+      collection = WillPaginate::Collection.create(page, 10) do |pager|
+        pager.replace events
+        pager.total_entries = response['lfm']['events']['total'].to_i
+      end
+      
+    end
+    
+  end
+  
+end

data/lib/firstfm/location.rb

@@ -0,0 +1,22 @@
+module Firstfm
+  
+  class Location
+    
+    attr_accessor :city, :country, :postalcode, :lat, :long, :street
+    
+    def self.init_location_from_hash(hash)
+      return nil unless hash.is_a?(Hash)
+      
+      location = Location.new
+      location.city         = hash["city"]
+      location.country      = hash["country"]
+      location.postalcode   = hash["postalcode"]
+      location.street       = hash["street"]
+      location.lat          = hash["geo:point"]["geo:lat"] if hash["geo:point"]
+      location.long         = hash["geo:point"]["geo:lat"] if hash["geo:point"]
+      location
+    end
+    
+  end
+  
+end

data/lib/firstfm/venue.rb

@@ -0,0 +1,52 @@
+module Firstfm
+  
+  class Venue
+    
+    attr_accessor :id, :name, :url, :location, :website, :phonenumber, :images
+    
+    include HTTParty
+    base_uri 'ws.audioscrobbler.com'
+    format :xml
+    
+    def self.search(venue, page = 1, limit = 50, country = nil)
+      response = get("/2.0/", {:query => {:method => 'venue.search', :venue => venue, :page => page, :limit => limit, :country => country, :api_key => Firstfm::CONFIG['api_key']}})
+      venues = response && response['lfm'] ? Venue.init_venues_from_hash(response['lfm']) : []
+      collection = WillPaginate::Collection.create(page, limit) do |pager|
+        pager.replace venues
+        pager.total_entries = response['lfm']['results']['opensearch:totalResults'].to_i
+      end
+    end
+    
+    def self.get_events(venue_id)
+      response = get("/2.0/", {:query => {:method => 'venue.getEvents', :venue => venue_id, :api_key => Firstfm::CONFIG['api_key']}})
+      events = response && response['lfm'] ? Event.init_events_from_hash(response['lfm']) : []
+    end
+    
+    def get_events
+      self.class.get_events(self.id)
+    end
+    
+    def self.init_venues_from_hash(hash)
+      return [] unless hash["results"] && hash["results"]["venuematches"] && hash["results"]["venuematches"]["venue"]
+      return [init_venue_from_hash(hash["results"]["venuematches"]["venue"])] if hash["results"]["venuematches"]["venue"].is_a?(Hash)
+      hash["results"]["venuematches"]["venue"].inject([]) do |arr, venue_hash|
+        arr << init_venue_from_hash(venue_hash)
+        arr
+      end
+    end
+    
+    def self.init_venue_from_hash(hash)
+      venue = Venue.new
+      venue.id          = hash["id"]
+      venue.name        = hash["name"]
+      venue.url         = hash["url"]
+      venue.location    = Location.init_location_from_hash(hash["location"])
+      venue.website     = hash["website"]
+      venue.phonenumber = hash["phonenumber"]
+      venue.images = hash["image"]
+      venue
+    end
+    
+  end
+  
+end

data/lib/firstfm.rb

@@ -0,0 +1,14 @@
+require 'rubygems'
+require 'yaml'
+require 'httparty'
+require 'will_paginate'
+require 'firstfm/event'
+require 'firstfm/location'
+require 'firstfm/venue'
+require 'firstfm/geo'
+
+module Firstfm
+  
+  CONFIG = YAML::load(File.read(File.join(ENV['HOME'], '.firstfm')))
+  
+end

data/test/test_helper.rb

@@ -0,0 +1,4 @@
+require 'rubygems'
+require 'test/unit'
+require 'fakeweb'
+require File.dirname(__FILE__) + '/../lib/firstfm'

data/test/unit/geo_test.rb

@@ -0,0 +1,32 @@
+require File.dirname(__FILE__) + '/../test_helper.rb'
+ 
+class GeoTest < Test::Unit::TestCase
+  
+  def test_should_get_events
+    FakeWeb.register_uri(:get, %r|http://ws.audioscrobbler.com/|, :body => File.read(File.dirname(__FILE__) + "/../fixtures/geo_events.xml"))
+    events = Firstfm::Geo.get_events
+    assert_equal 2, events.size
+    
+    event = events.first
+    assert_equal "Entre Coche", event.title
+    assert_equal "1405068", event.id
+    assert_equal "La Boite", event.venue.name
+    
+    event = events.last
+    assert_equal "Bonafide", event.title
+    assert_equal "1443807", event.id
+    assert_equal "Ritmo y Compás", event.venue.name
+  end
+  
+  def test_should_get_events_with_one_event_as_result
+    FakeWeb.register_uri(:get, %r|http://ws.audioscrobbler.com/|, :body => File.read(File.dirname(__FILE__) + "/../fixtures/geo_event.xml"))
+    events = Firstfm::Geo.get_events
+    assert_equal 1, events.size
+    
+    event = events.first
+    assert_equal "Entre Coche", event.title
+    assert_equal "1405068", event.id
+    assert_equal "La Boite", event.venue.name
+  end
+  
+end

data/test/unit/venue_test.rb

@@ -0,0 +1,54 @@
+require File.dirname(__FILE__) + '/../test_helper.rb'
+ 
+class VenueTest < Test::Unit::TestCase
+  
+  def test_should_search_venues
+    FakeWeb.register_uri(:get, %r|http://ws.audioscrobbler.com/|, :body => File.read(File.dirname(__FILE__) + "/../fixtures/venues.xml"))
+    venues = Firstfm::Venue.search("arena")
+    assert_equal 2, venues.size
+    venue = venues.first
+    assert_equal "Arena", venue.name
+    assert_equal "Baumgasse 80", venue.location.street
+    venue = venues.last
+    assert_equal "8781374", venue.id
+    assert_equal "41.056222", venue.location.lat
+  end
+  
+  def test_should_search_venues_with_one_venue_as_result
+    FakeWeb.register_uri(:get, %r|http://ws.audioscrobbler.com/|, :body => File.read(File.dirname(__FILE__) + "/../fixtures/venue.xml"))
+    venues = Firstfm::Venue.search("arena")
+    assert_equal 1, venues.size
+    venue = venues.first
+    assert_equal "Arena", venue.name
+    assert_equal "8778545", venue.id
+    assert_equal "Baumgasse 80", venue.location.street
+  end
+  
+  def test_should_get_events
+    FakeWeb.register_uri(:get, %r|http://ws.audioscrobbler.com/|, :body => File.read(File.dirname(__FILE__) + "/../fixtures/events.xml"))
+    events = Firstfm::Venue.get_events(8908030)
+    assert_equal 2, events.size
+    
+    event = events.first
+    assert_equal "U.S. Girls", event.title
+    assert_equal "1313175", event.id
+    assert_equal "Cafe OTO", event.venue.name
+    
+    event = events.last
+    assert_equal "Shogun Kunitoki", event.title
+    assert_equal "1372916", event.id
+    assert_equal "Cafe OTO", event.venue.name
+  end
+  
+  def test_should_get_events_with_one_event_as_result
+    FakeWeb.register_uri(:get, %r|http://ws.audioscrobbler.com/|, :body => File.read(File.dirname(__FILE__) + "/../fixtures/event.xml"))
+    events = Firstfm::Venue.get_events(8908030)
+    assert_equal 1, events.size
+    
+    event = events.first
+    assert_equal "U.S. Girls", event.title
+    assert_equal "1313175", event.id
+    assert_equal "Cafe OTO", event.venue.name
+  end
+  
+end

metadata

@@ -0,0 +1,96 @@
+--- !ruby/object:Gem::Specification 
+name: firstfm
+version: !ruby/object:Gem::Version 
+  prerelease: false
+  segments: 
+  - 0
+  - 0
+  - 1
+  version: 0.0.1
+platform: ruby
+authors: 
+- Aleksandr Lossenko
+autorequire: 
+bindir: bin
+cert_chain: []
+
+date: 2010-03-10 00:00:00 +01:00
+default_executable: 
+dependencies: 
+- !ruby/object:Gem::Dependency 
+  name: will_paginate
+  prerelease: false
+  requirement: &id001 !ruby/object:Gem::Requirement 
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        segments: 
+        - 2
+        - 3
+        - 12
+        version: 2.3.12
+  type: :runtime
+  version_requirements: *id001
+- !ruby/object:Gem::Dependency 
+  name: httparty
+  prerelease: false
+  requirement: &id002 !ruby/object:Gem::Requirement 
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        segments: 
+        - 0
+        - 5
+        - 2
+        version: 0.5.2
+  type: :runtime
+  version_requirements: *id002
+description: Firstfm is a ruby wrapper for the Last.fm APIs ( http://www.last.fm/api ). My main focus is to import events from Last.FM, but with time I will try to add support for all API methods.
+email: aleksandr @nospam@ cligs.ee
+executables: []
+
+extensions: []
+
+extra_rdoc_files: 
+- README.rdoc
+files: 
+- lib/firstfm.rb
+- lib/firstfm/event.rb
+- lib/firstfm/geo.rb
+- lib/firstfm/location.rb
+- lib/firstfm/venue.rb
+- README.rdoc
+has_rdoc: true
+homepage: http://github.com/egze/firstfm
+licenses: []
+
+post_install_message: 
+rdoc_options: 
+- --charset=UTF-8
+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 ruby wrapper for the Last.fm APIs
+test_files: 
+- test/test_helper.rb
+- test/unit/geo_test.rb
+- test/unit/venue_test.rb