scrobbler-ng 2.0.0

data/lib/scrobbler/venue.rb

@@ -0,0 +1,67 @@
+module Scrobbler
+  class Venue < Base
+    attr_accessor :name, :city, :country, :street, :postalcode
+    attr_accessor :geo_lat, :geo_long, :timezone, :url, :id
+
+    class << self
+      def new_from_xml(xml)
+        data = {}
+        xml.children.each do |child|
+          data[:name] = child.content if child.name == 'name'
+          data[:id] = child.content.to_i if child.name == 'id'
+          data[:url] = child.content if child.name == 'url'          
+
+          if child.name == 'location'
+            child.children.each do |location_element|
+              data[:city] = location_element.content if location_element.name == 'city'
+              data[:country] = location_element.content if location_element.name == 'country'
+              data[:street] = location_element.content if location_element.name == 'street'
+              data[:postalcode] = location_element.content if location_element.name == 'postalcode'
+              data[:timezone] = location_element.content if location_element.name == 'timezone'
+
+              if location_element.name == 'point' || location_element.name == 'geo:point'
+                location_element.children.each do |geo_element|
+                  data[:geo_lat] = geo_element.content if ['lat', 'geo:lat'].include?(geo_element.name)
+                  data[:geo_long] = geo_element.content if ['long', 'geo:long'].include?(geo_element.name)
+                end
+              end
+            end
+          end
+        end
+
+        if data.has_key?(:url) && !data.has_key?(:id)
+          data[:id] = id_from_url(data[:url])
+        end
+
+        Venue.new(data[:name], data)
+      end
+
+      # this retrives the venue ID from 
+      # the venue because the venue
+      # ID is not supplied
+      # in the XML apart from
+      # in the venue URL
+      def id_from_url(url)
+        url[url.rindex('/')+1,url.length].to_i
+      end
+
+      def search(venue, force=false)
+        get_response('venue.search', :venuematches, 'venuematches', 'venue', {'venue'=>venue}, force)
+      end
+    end
+
+    def initialize(name,data = {})
+      raise ArgumentError if name.empty?
+      @name = name
+      populate_data(data)
+    end
+
+    def events(force=false)
+      get_response('venue.getevents', :events, 'events', 'event', {'venue'=>@id}, force)
+    end
+
+    def past_events(force=false)
+      get_response('venue.getpastevents', :events, 'events', 'event', {'venue'=>@id}, force)
+    end
+  end
+end

data/lib/scrobbler.rb

@@ -0,0 +1,34 @@
+
+%w{uri rubygems libxml time}.each { |x| require x }
+require 'digest/md5'
+
+$: << File.expand_path(File.dirname(__FILE__))
+
+# Load base class
+require 'scrobbler/base'
+
+# Load helper modules
+require 'scrobbler/helper/image'
+require 'scrobbler/helper/streamable'
+
+require 'scrobbler/album'
+require 'scrobbler/artist'
+require 'scrobbler/event'
+require 'scrobbler/shout'
+require 'scrobbler/venue'
+require 'scrobbler/geo'
+require 'scrobbler/user'
+require 'scrobbler/session'
+require 'scrobbler/tag'
+require 'scrobbler/track'
+
+require 'scrobbler/auth'
+require 'scrobbler/library'
+require 'scrobbler/playlist'
+require 'scrobbler/radio'
+
+require 'scrobbler/simpleauth'
+require 'scrobbler/scrobble'
+require 'scrobbler/playing'
+
+require 'scrobbler/rest'

data/tasks/jeweler.rake

@@ -0,0 +1,18 @@
+begin
+  require 'jeweler'
+  Jeweler::Tasks.new do |s|
+    s.name = "scrobbler-ng"
+    s.summary = "A ruby library for accessing the last.fm v2 webservices"
+    s.email = "uwelk@xhochy.org"
+    s.homepage = "http://github.com/xhochy/scrobbler"
+    s.description = "A ruby library for accessing the last.fm v2 webservices"
+    s.authors = ['John Nunemaker', 'Jonathan Rudenberg', 'Uwe L. Korn']
+    if RUBY_PLATFORM =~ /\bjava\b/
+      s.add_dependency 'libxml-jruby'
+    else
+      s.add_dependency 'libxml-ruby'
+    end
+  end
+rescue LoadError
+  puts "Jeweler not available. Install it with: sudo gem install technicalpickles-jeweler -s http://gems.github.com"
+end

data/tasks/rdoc.rake

@@ -0,0 +1,7 @@
+Rake::RDocTask.new do |rdoc|
+  rdoc.rdoc_dir = 'rdoc'
+  rdoc.title = 'scrobbler-ng'
+  rdoc.options << '--line-numbers' << '--inline-source'
+  rdoc.rdoc_files.include('README*')
+  rdoc.rdoc_files.include('lib/**/*.rb')
+end

data/tasks/tests.rake

@@ -0,0 +1,13 @@
+desc "Run all tests"
+Spec::Rake::SpecTask.new('test:unit') do |t|
+  begin
+    require 'rcov'
+    t.rcov = true
+    t.rcov_opts = ['--exclude', '/var/lib/gems']
+  rescue LoadError
+    t.rcov = false
+  end
+  t.spec_opts << '--format' << 'html:spec.html'
+  t.spec_opts << '--format' << 'progress'
+  t.spec_files = FileList['test/unit/*_spec.rb']
+end

data/tasks/yardoc.rake

@@ -0,0 +1,8 @@
+begin
+  require 'yard'
+  YARD::Rake::YardocTask.new do |t|
+    t.files   = ['lib/**/*.rb']   # optional
+  end
+rescue LoadError
+  puts "YARD not available. Install it with: sudo gem install yard"
+end

data/test/fixtures/xml/album/info.xml

@@ -0,0 +1,43 @@
+<?xml version="1.0" encoding="utf-8"?>
+<lfm status="ok">
+<album>
+    <name>Some Hearts</name>
+    <artist>Carrie Underwood</artist>
+    <id>2317937</id>
+    <mbid>a33b9822-9f09-4e19-9d6e-e05af85c727b</mbid>
+    <url>http://www.last.fm/music/Carrie+Underwood/Some+Hearts</url>
+    <releasedate>    15 Nov 2005, 00:00</releasedate>
+    <image size="small">http://userserve-ak.last.fm/serve/34s/19874169.jpg</image>
+    <image size="medium">http://userserve-ak.last.fm/serve/64s/19874169.jpg</image>
+    <image size="large">http://userserve-ak.last.fm/serve/174s/19874169.jpg</image>
+    <image size="extralarge">http://userserve-ak.last.fm/serve/300x300/19874169.jpg</image>
+    <listeners>131312</listeners>
+    <playcount>2096260</playcount>
+    <toptags>
+        <tag>
+	  <name>country</name>
+	  <url>http://www.last.fm/tag/country</url>
+	</tag>
+        <tag>
+	  <name>albums i own</name>
+	  <url>http://www.last.fm/tag/albums%20i%20own</url>
+	</tag>
+        <tag>
+	  <name>pop</name>
+	  <url>http://www.last.fm/tag/pop</url>
+	</tag>
+        <tag>
+	  <name>country pop</name>
+	  <url>http://www.last.fm/tag/country%20pop</url>
+	</tag>
+        <tag>
+	  <name>american idol</name>
+	  <url>http://www.last.fm/tag/american%20idol</url>
+	</tag>
+      </toptags>
+         <wiki>
+        <published>Thu, 8 Jan 2009 17:10:24 +0000</published>
+        <summary><![CDATA[Some Hearts is the debut album from fourth-season American Idol winner Carrie Underwood, released in the United States on November 15, 2005. It has been certified seven times platinum in the U.S. (RIAA) and three times platinum in Canada (CRIA). On December 4, 2006, Some Hearts was named the number-one selling album of the year in all genres at the Billboard Music Awards. It is also the best selling debut album by a solo female country music artist in history.  ]]></summary>
+        <content><![CDATA[Some Hearts is the debut album from fourth-season American Idol winner Carrie Underwood, released in the United States on November 15, 2005. It has been certified seven times platinum in the U.S. (RIAA) and three times platinum in Canada (CRIA). On December 4, 2006, Some Hearts was named the number-one selling album of the year in all genres at the Billboard Music Awards. It is also the best selling debut album by a solo female country music artist in history.
 
 As of July 3, 2008, the album is no longer present nor eligible to appear on the U.S. Billboard 200. It had a run of 136 weeks, the second-longest for any album released in 2005, behind Nickelback's All the Right Reasons. The following week, it dropped out of the Top Country Albums Chart, having had a 137 week run. It is currently active on the Pop Catalog Chart. It has sold 6,630,000 copies in the U.S. to date.
 Some Hearts was the highest selling country album in the U.S. in both 2006 and 2007. The album now certified 7x Platinum and is the best-selling debut album for a female country artist.
 
 
 
 Track listing
 1. &quot;Wasted&quot; (Troy Verges, Marv Green, Hillary Lindsey) – 4:34 
 2. &quot;Don't Forget to Remember Me&quot; (Morgane Hayes, Kelley Lovelace, Ashley Gorley) – 4:00 
 3. &quot;Some Hearts&quot; (Diane Warren) – 3:48 
 4. &quot;Jesus, Take the Wheel&quot; (Brett James, Lindsey, Gordie Sampson) – 3:46 
 5. &quot;The Night Before (Life Goes On)&quot; (Wendell Mobley, Neil Thrasher, Jimmy Olander) – 3:54 
 6. &quot;Lessons Learned&quot; (Warren) – 4:09 
 7. &quot;Before He Cheats&quot; (Chris Tompkins, Josh Kear) – 3:19 
 8. &quot;Starts with Goodbye&quot; (Angelo, Lindsey) – 4:06 
 9. &quot;I Just Can't Live a Lie&quot; (Steve Robson, Wayne Hector) – 3:59 
 10. &quot;We're Young and Beautiful&quot; (Rivers Rutherford, Steve McEwan) – 3:53 
 11. &quot;That's Where It Is&quot; (Melissa Peirce, Robson, Greg Becker) – 3:35 
 12. &quot;Whenever You Remember&quot; (Warren) – 3:47 
 13. &quot;I Ain't in Checotah Anymore&quot; (Carrie Underwood, Trey Bruce, Angelo) – 3:21 
 14. &quot;Inside Your Heaven&quot; (Andreas Carlsson, Pelle Nyhlén, Savan Kotecha) – 3:45 (bonus track) ]]></content>
+      </wiki>
+    </album></lfm>

data/test/fixtures/xml/artist/fans.xml

@@ -0,0 +1,52 @@
+<?xml version="1.0" encoding="utf-8"?>
+<lfm status="ok">
+<topfans artist="Metallica">
+<user>
+    <name>Slide15</name>
+    <url>http://www.last.fm/user/Slide15</url>
+    <image size="small">http://userserve-ak.last.fm/serve/34/4477633.jpg</image>
+    <image size="medium">http://userserve-ak.last.fm/serve/64/4477633.jpg</image>
+    <image size="large">http://userserve-ak.last.fm/serve/126/4477633.jpg</image>
+    <weight>265440672</weight>
+</user>
+<user>
+    <name>Air_Force</name>
+    <url>http://www.last.fm/user/Air_Force</url>
+    <image size="small">http://userserve-ak.last.fm/serve/34/8191119.jpg</image>
+    <image size="medium">http://userserve-ak.last.fm/serve/64/8191119.jpg</image>
+    <image size="large">http://userserve-ak.last.fm/serve/126/8191119.jpg</image>
+    <weight>233280000</weight>
+</user>
+<user>
+    <name>Evile9</name>
+    <url>http://www.last.fm/user/Evile9</url>
+    <image size="small">http://userserve-ak.last.fm/serve/34/18665765.jpg</image>
+    <image size="medium">http://userserve-ak.last.fm/serve/64/18665765.jpg</image>
+    <image size="large">http://userserve-ak.last.fm/serve/126/18665765.jpg</image>
+    <weight>224640448</weight>
+</user>
+<user>
+    <name>thy_satan</name>
+    <url>http://www.last.fm/user/thy_satan</url>
+    <image size="small">http://userserve-ak.last.fm/serve/34/1832263.jpg</image>
+    <image size="medium">http://userserve-ak.last.fm/serve/64/1832263.jpg</image>
+    <image size="large">http://userserve-ak.last.fm/serve/126/1832263.jpg</image>
+    <weight>176333328</weight>
+</user>
+<user>
+    <name>Aiham</name>
+    <url>http://www.last.fm/user/Aiham</url>
+    <image size="small">http://userserve-ak.last.fm/serve/34/1209256.jpg</image>
+    <image size="medium">http://userserve-ak.last.fm/serve/64/1209256.jpg</image>
+    <image size="large">http://userserve-ak.last.fm/serve/126/1209256.jpg</image>
+    <weight>153124992</weight>
+</user>
+<user>
+    <name>Quugel</name>
+    <url>http://www.last.fm/user/Quugel</url>
+    <image size="small">http://userserve-ak.last.fm/serve/34/2614780.png</image>
+    <image size="medium">http://userserve-ak.last.fm/serve/64/2614780.png</image>
+    <image size="large">http://userserve-ak.last.fm/serve/126/2614780.png</image>
+    <weight>141551040</weight>
+</user>
+</topfans></lfm>

data/test/fixtures/xml/artist/info.xml

@@ -0,0 +1,58 @@
+<?xml version="1.0" encoding="utf-8"?>
+<lfm status="ok">
+<artist>
+  <name>Cher</name>
+  <mbid>bfcc6d75-a6a5-4bc6-8282-47aec8531818</mbid>
+  <url>http://www.last.fm/music/Cher</url>
+  <image size="small">http://userserve-ak.last.fm/serve/34/9137697.jpg</image>
+  <image size="medium">http://userserve-ak.last.fm/serve/64/9137697.jpg</image>
+  <image size="large">http://userserve-ak.last.fm/serve/126/9137697.jpg</image>
+  <streamable>1</streamable>
+  <stats>
+    <listeners>383775</listeners>
+    <playcount>3141583</playcount>
+  </stats>
+
+  <similar>
+	    <artist>
+	  <name>Sonny &amp; Cher</name>
+	  <url>http://www.last.fm/music/Sonny%2B%2526%2BCher</url>
+	  <image size="small">http://userserve-ak.last.fm/serve/34/4987379.jpg</image>
+	  <image size="medium">http://userserve-ak.last.fm/serve/64/4987379.jpg></image>
+	  <image size="large">http://userserve-ak.last.fm/serve/126/4987379.jpg</image>
+	</artist>
+    <artist>
+	  <name>Cyndi Lauper</name>
+	  <url>http://www.last.fm/music/Cyndi+Lauper</url>
+	  <image size="small">http://userserve-ak.last.fm/serve/34/6967243.jpg</image>
+	  <image size="medium">http://userserve-ak.last.fm/serve/64/6967243.jpg></image>
+	  <image size="large">http://userserve-ak.last.fm/serve/126/6967243.jpg</image>
+	</artist>
+    <artist>
+	  <name>Madonna</name>
+	  <url>http://www.last.fm/music/Madonna</url>
+	  <image size="small">http://userserve-ak.last.fm/serve/34/12913295.jpg</image>
+	  <image size="medium">http://userserve-ak.last.fm/serve/64/12913295.jpg></image>
+	  <image size="large">http://userserve-ak.last.fm/serve/126/12913295.jpg</image>
+	</artist>
+    <artist>
+	  <name>Tina Turner</name>
+	  <url>http://www.last.fm/music/Tina+Turner</url>
+	  <image size="small">http://userserve-ak.last.fm/serve/34/2480149.jpg</image>
+	  <image size="medium">http://userserve-ak.last.fm/serve/64/2480149.jpg></image>
+	  <image size="large">http://userserve-ak.last.fm/serve/126/2480149.jpg</image>
+	</artist>
+    <artist>
+	  <name>Céline Dion</name>
+	  <url>http://www.last.fm/music/C%C3%A9line+Dion</url>
+	  <image size="small">http://userserve-ak.last.fm/serve/34/11218127.jpg</image>
+	  <image size="medium">http://userserve-ak.last.fm/serve/64/11218127.jpg></image>
+	  <image size="large">http://userserve-ak.last.fm/serve/126/11218127.jpg</image>
+	</artist>
+  </similar>
+      <bio>
+    <published>Fri, 5 Dec 2008 19:55:12 +0000</published>
+    <summary><![CDATA[Cher (born Cherilyn Sarkisian on May 20, 1946, later adopted by Gilbert LaPierre.) is an American singer, actress, songwriter, author and entertainer. Among her many career accomplishments in music, television and film, she has won an Academy Award, a Grammy Award, an Emmy Award and three Golden Globe Awards among others.  Cher first rose to prominence in 1965 as one half of the pop/rock duo Sonny &amp; Cher.]]></summary>
+    <content><![CDATA[Cher (born Cherilyn Sarkisian on May 20, 1946, later adopted by Gilbert LaPierre.) is an American singer, actress, songwriter, author and entertainer. Among her many career accomplishments in music, television and film, she has won an Academy Award, a Grammy Award, an Emmy Award and three Golden Globe Awards among others.
 
 Cher first rose to prominence in 1965 as one half of the pop/rock duo Sonny &amp; Cher. She also established herself as a solo recording artist, releasing 25 albums, contributing to numerous compilations, and tallying 34 Billboard Top 40 entries over her career, both solo and with Sonny. These include eighteen Top 10 singles and five number one singles (four solo). Cher has had 16 top ten hits in the UK between 1965 and 2003, four of which reached number one (two solo, one with Sonny, one as part of a charity single).
 
 She became a television star in the 1970s and a film actress in the 1980s. In 1987, she won the Academy Award for Best Actress for her role in the romantic comedy Moonstruck.
 
 In a career surpassing 40 years, Cher has been described as an enduring pop icon and one of the most popular female artists in music history. Since her debut in 1964, Cher has sold as a solo artist over 100 million records worldwide and an estimated 70 million singles and with duo Sonny and Cher over 75 million records becoming one of the biggest-selling artists of all time.
 
 
 
 During 2007, in the seventh volume of Chrome Hearts, Cher once again confirmed that she is working on her twenty-sixth studio album. No recordings have taken place as of yet, and no release date had been scheduled.
 
 It is rumoured that Cher will collaborate with Timbaland in a song for his next album Shock Value II, which will also feature Gwen Stefani, Madonna, Dido and Christina Aguilera. This album is expected to be released in November 2008.
 
 On February 7, 2008 Cher, at 61, announced that she had reached a deal to perform 200 shows over three years live at the Colosseum at Caesars Palace in Las Vegas. Her new show, entitled Cher at the Colosseum, will debut on May 6, 2008. [36] The show reportedly includes 18 dancers, 4 aerielists, and multiple costumes designed by Bob Mackie. Choreography will be directed by Doriana Sanchez who also worked with Cher on her past three major tours. Her show will perform four nights a week for a month, and a second leg of the show will continue in August. Cher will share the stage on a rotating basis with contemporaries Bette Midler (whose The Showgirl Must Go On opened on February 20, 2008) and Elton John (whose The Red Piano which opened in 2004, will continues its run of about 50 shows a year).
 
 On February 10, 2008, Cher made a brief appearance at the Grammy Awards, introducing a performance by Tina Turner and Beyonce Knowles.
 
 Los Angeles]]></content>
+  </bio>
+  </artist></lfm>