rockstar 0.7.0 → 0.7.1

data/README.md

@@ -91,6 +91,32 @@ object, you have to add `:include_info => true` .
     # To get a list of possible locations use
     geo.metros("germany").each{|m| p m.name}
 
+    # Retrieve list of top tracks by country
+    geo.toptracks('united kingdom', 10).each{|t| p "#{t.name} by #{t.artist}"}
+
+    # Retrieve list of top artists by country
+    geo.topartists('united kingdom', 10).each{|a| p "artist #{a.name} with #{a.listenercount} listeners"}
+
+
+## Library
+
+	# Get artists and albums for user
+    library = Rockstar::Library.new
+
+    puts 'Artists'
+    library.artists(false, :user => 'jnunemaker').each { |a| puts a.name }
+    
+    puts 'Albums'
+    library.albums(false, :user => 'jnunemaker').each { |a| puts a.name }
+
+	# Get it with Rockstar::User
+    user = Rockstar::User.new('jnunemaker')
+    
+    puts 'Artists'
+    user.artists.each { |a| puts a.name }
+    
+    puts 'Albums'
+    user.albums.each { |a| puts a.name }
 
 ##  Get rights to access the user data for scrobbing, now playing, events etc...
 

data/VERSION

@@ -1 +1 @@
-0.7.0
+0.7.1

data/examples/geo.rb

@@ -7,3 +7,54 @@ Rockstar.lastfm = YAML.load_file(File.join(File.dirname(__FILE__), 'lastfm.yml')
 geo = Rockstar::Geo.new
 
 geo.events(:location => 'london').each{|e| p "#{e.title} at #{e.venue.name}"}
+
+
+# Get Top Tracks by country of the last week
+#<toptracks country="Spain">  
+#  <track rank="1">
+#    <name>Violet Hill</name>
+#    <playcount>1055</playcount>
+#    <mbid/>
+#    <url>http://www.last.fm/music/Coldplay/_/Violet+Hill</url>
+#    <streamable fulltrack="0">1</streamable>
+#    <artist>
+#      <name>Coldplay</name>
+#      <mbid>cc197bad-dc9c-440d-a5b5-d52ba2e14234</mbid>
+#      <url>http://www.last.fm/music/Coldplay</url>
+#    </artist>
+#    <image size="small">...</image>
+#    <image size="medium">...</image>
+#    <image size="large">...</image>
+#  </track>
+#  ...
+#</toptracks>
+geo.toptracks('united kingdom', 10).each{|t| p "#{t.name} by #{t.artist}"}
+
+
+#Get the most popular artists on Last.fm by country
+#<topartists country="Spain"  page="1" perPage="50" totalPages="10" total="500">
+#
+#                        <artist rank="1">
+#    <name>Muse</name>
+#                <listeners>1736</listeners>
+#                <mbid>1695c115-bf3f-4014-9966-2b0c50179193</mbid>
+#                        <url>http://www.last.fm/music/Muse</url>
+#    <streamable>1</streamable>
+#            <image size="small">http://userserve-ak.last.fm/serve/34/416065.jpg</image>
+#        <image size="medium">http://userserve-ak.last.fm/serve/64/416065.jpg</image>
+#        <image size="large">http://userserve-ak.last.fm/serve/126/416065.jpg</image>
+#        <image size="extralarge">http://userserve-ak.last.fm/serve/252/416065.jpg</image>
+#        <image size="mega">http://userserve-ak.last.fm/serve/500/416065/Muse.jpg</image>
+#    </artist>                    <artist rank="2">
+#    <name>Coldplay</name>
+#                <listeners>1497</listeners>
+#                <mbid>cc197bad-dc9c-440d-a5b5-d52ba2e14234</mbid>
+#                        <url>http://www.last.fm/music/Coldplay</url>
+#    <streamable>1</streamable>
+#            <image size="small">http://userserve-ak.last.fm/serve/34/210303.jpg</image>
+#        <image size="medium">http://userserve-ak.last.fm/serve/64/210303.jpg</image>
+#        <image size="large">http://userserve-ak.last.fm/serve/126/210303.jpg</image>
+#        <image size="extralarge">http://userserve-ak.last.fm/serve/252/210303.jpg</image>
+#        <image size="mega">http://userserve-ak.last.fm/serve/500/210303/Coldplay.jpg</image>
+#    </artist>                    <a
+geo.topartists('united kingdom', 10).each{|a| p "artist #{a.name} with #{a.listenercount} listeners"}

data/lib/rockstar/geo.rb

@@ -16,5 +16,32 @@ module Rockstar
       get_instance("geo.getMetros", :metros, :metro, {:country => country}, force)
     end
 
+
+    
+    # Get a list of the Top Artists for a specified country
+    # 
+    # Country is specified in last.fm API docs as 'A country name, as defined by the ISO 3166-1 country names standard'
+    # Not sure of the coverage
+    # 
+    # Also specify limit and page to page through full resultset
+    # 
+    # returns array of Artist instances
+    def topartists(country, limit = nil, page = nil, force = false)
+      get_instance("geo.getTopArtists", :topartists, :artist, {:country => country, :limit => limit, :page => page}, force)
+    end
+    
+    # Get a list of the Top Tracks for a specified country
+    # 
+    # Country is specified in last.fm API docs as 'A country name, as defined by the ISO 3166-1 country names standard'
+    # Not sure of the coverage
+    # 
+    # Also specify limit and page to page through full resultset
+    # 
+    # returns array of Track instances   
+    # TODO: is this the correct object to return? We dont have the full data so is this really best
+    def toptracks(country, limit = nil, page = nil, force = false)
+      get_instance("geo.getTopTracks", :toptracks, :track, {:country => country, :limit => limit, :page => page}, force)
+    end    
+
   end
 end

data/rockstar.gemspec

@@ -5,11 +5,11 @@
 
 Gem::Specification.new do |s|
   s.name = "rockstar"
-  s.version = "0.7.0"
+  s.version = "0.7.1"
 
   s.required_rubygems_version = Gem::Requirement.new(">= 0") if s.respond_to? :required_rubygems_version=
   s.authors = ["Bodo Tasche"]
-  s.date = "2012-11-15"
+  s.date = "2013-02-19"
   s.description = "This gem is an updated version of jnunemakers scrobbler gem. Rockstar uses v2.0 of the last.fm api."
   s.email = "bodo@putpat.tv"
   s.extra_rdoc_files = [
@@ -65,6 +65,8 @@ Gem::Specification.new do |s|
     "test/fixtures/xml/artist/gettoptracks_artist_Metallica.xml",
     "test/fixtures/xml/geo/getevents_location_london.xml",
     "test/fixtures/xml/geo/getmetros_country_germany.xml",
+    "test/fixtures/xml/geo/gettopartists_country_spain_limit_50_page_.xml",
+    "test/fixtures/xml/geo/gettoptracks_country_spain_limit_50_page_.xml",
     "test/fixtures/xml/library/getalbums_user_jnunemaker.xml",
     "test/fixtures/xml/library/getartists_user_jnunemaker.xml",
     "test/fixtures/xml/tag/gettopalbums_tag_rock.xml",