jonaustin-rockstar 0.7.1

data/examples/geo.rb

@@ -0,0 +1,60 @@
+require File.expand_path(File.join(File.dirname(__FILE__), '..', 'lib', 'rockstar'))
+
+# Please enter your API-Keys into lastfm.yml first. 
+# You can find them here : http://www.lastfm.de/api/account
+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/examples/lastfm.yml_example

@@ -0,0 +1,3 @@
+# Please enter your API-Keys. You can find them here : http://www.lastfm.de/api/account
+api_key: "API"
+api_secret: "KEY"

data/examples/scrobble.rb

@@ -0,0 +1,45 @@
+require File.expand_path(File.join(File.dirname(__FILE__), '..', 'lib', 'rockstar'))
+
+# Please enter your API-Keys into lastfm.yml first. 
+# You can find them here : http://www.lastfm.de/api/account
+Rockstar.lastfm = YAML.load_file(File.join(File.dirname(__FILE__), 'lastfm.yml'))
+
+# This is the desktop app aproach to token auth. See Rockstar::TokenAuth for
+# details on how to get a token for a web app.
+
+a = Rockstar::Auth.new
+token = a.token
+
+puts
+puts "Please open http://www.last.fm/api/auth/?api_key=#{Rockstar.lastfm_api_key}&token=#{token}"
+puts
+puts "Press enter when done."
+
+gets
+
+session = a.session(token)
+
+Rockstar::Track.scrobble(
+  :session_key  => session.key,
+  :track        => "Viva La Vida",
+  :artist       => "Coldplay",
+  :album        => "Viva La Vida",
+  :time         => Time.new,
+  :length       => 244,
+  :track_number => 7
+)
+
+# Love the Song :
+l_status = Rockstar::Track.new('Coldplay', 'Viva La Vida').love(session.key)
+
+puts "Love track status : #{l_status}"
+
+Rockstar::Track.updateNowPlaying(
+  :session_key  => session.key,
+  :track        => "Viva La Vida",
+  :artist       => "Coldplay",
+  :album        => "Viva La Vida",
+  :time         => Time.new,
+  :length       => 244,
+  :track_number => 7
+)

data/examples/tag.rb

@@ -0,0 +1,20 @@
+require File.expand_path(File.join(File.dirname(__FILE__), '..', 'lib', 'rockstar'))
+
+# Please enter your API-Keys into lastfm.yml first. 
+# You can find them here : http://www.lastfm.de/api/account
+Rockstar.lastfm = YAML.load_file(File.join(File.dirname(__FILE__), 'lastfm.yml'))
+
+tag = Rockstar::Tag.new('country')
+
+puts 'Top Tags '
+Rockstar::Tag.top_tags.each { |a| puts "(#{a.count}) #{a.name}" }
+
+puts
+
+puts 'Top Albums'
+tag.top_albums.each { |a| puts "(#{a.count}) #{a.name} by #{a.artist}" }
+
+puts
+
+puts 'Top Tracks'
+tag.top_tracks.each { |t| puts "(#{t.count}) #{t.name} by #{t.artist}" }

data/examples/track.rb

@@ -0,0 +1,14 @@
+require File.expand_path(File.join(File.dirname(__FILE__), '..', 'lib', 'rockstar'))
+require 'pp'
+
+# Please enter your API-Keys into lastfm.yml first. 
+# You can find them here : http://www.lastfm.de/api/account
+Rockstar.lastfm = YAML.load_file(File.join(File.dirname(__FILE__), 'lastfm.yml'))
+
+track = Rockstar::Track.new('Carrie Underwood', 'Before He Cheats')
+puts 'Fans'
+puts "=" * 4
+track.fans.each { |u| puts "(#{u.weight}) #{u.username}" }
+
+track = Rockstar::Track.new('U2 & Green Day', 'The Saints Are Coming')
+pp track.tags

data/examples/user.rb

@@ -0,0 +1,18 @@
+require File.expand_path(File.join(File.dirname(__FILE__), '..', 'lib', 'rockstar'))
+
+# Please enter your API-Keys into lastfm.yml first. 
+# You can find them here : http://www.lastfm.de/api/account
+Rockstar.lastfm = YAML.load_file(File.join(File.dirname(__FILE__), 'lastfm.yml'))
+
+user = Rockstar::User.new('jnunemaker')
+
+puts "#{user.username}'s Recent Tracks"
+puts "=" * (user.username.length + 16)
+user.recent_tracks.each { |t| puts t.name }
+
+puts
+puts
+
+puts "#{user.username}'s Top Tracks"
+puts "=" * (user.username.length + 13)
+user.top_tracks.each { |t| puts "(#{t.playcount}) #{t.name}" }

data/lib/rockstar.rb

@@ -0,0 +1,46 @@
+$: << File.expand_path(File.dirname(__FILE__))
+
+require 'rubygems'
+require 'cgi'
+require 'hpricot'
+require 'active_support'
+require 'active_support/core_ext/object/blank'
+require 'active_support/core_ext/string/inflections'
+require 'time'
+require 'yaml'
+
+require 'rockstar/base'
+require 'rockstar/version'
+
+require 'rockstar/album'
+require 'rockstar/artist'
+require 'rockstar/chart'
+require 'rockstar/event'
+require 'rockstar/geo'
+require 'rockstar/library'
+require 'rockstar/metro'
+require 'rockstar/user'
+require 'rockstar/tag'
+require 'rockstar/track'
+require 'rockstar/venue'
+
+require 'rockstar/auth'
+require 'rockstar/session'
+require 'rockstar/rest'
+
+module Rockstar
+  extend self
+
+  def lastfm=(args)
+    @api_key    = args["api_key"] || args[:api_key]
+    @api_secret = args["api_secret"] || args[:api_secret]
+  end
+
+  def lastfm_api_key
+    @api_key
+  end
+
+  def lastfm_api_secret
+    @api_secret
+  end
+end

data/lib/rockstar/album.rb

@@ -0,0 +1,104 @@
+# Getting information about an album such as release date and the summary or description on it is very easy.
+#
+#   album = Rockstar::Album.new('Carrie Underwood', 'Some Hearts', :include_info => true)
+#
+#   puts "Album: #{album.name}"
+#   puts "Artist: #{album.artist}"
+#   puts "URL: #{album.url}"
+#   puts "Release Date: #{album.release_date.strftime('%m/%d/%Y')}"
+#
+# Would output:
+#
+#   Album: Some Hearts
+#   Artist: Carrie Underwood
+#   URL: http://www.last.fm/music/Carrie+Underwood/Some+Hearts
+#   Release Date: 11/15/2005
+#
+module Rockstar
+  class Album < Base
+    attr_accessor :artist, :artist_mbid, :name, :mbid, :playcount, :rank, :url, :release_date
+    attr_accessor :image_large, :image_medium, :image_small, :summary, :content, :images
+
+    # needed on top albums for tag
+    attr_accessor :count, :streamable
+
+    # needed for weekly album charts
+    attr_accessor :chartposition
+
+    class << self
+      def find(artist, name, o={})
+        new(artist, name, o)
+      end
+
+      def new_from_xml(xml, doc=nil)
+        name             = (xml).at(:name).inner_html                  if (xml).at(:name)
+        name             = xml['name']                                 if name.nil? && xml['name']
+        name             = xml.at(:title).inner_html                   if name.nil? && (xml).at(:title)
+        artist           = (xml).at(:artist).at(:name).inner_html      if (xml).at(:artist) && (xml).at(:artist).at(:name)
+        artist           = (xml).at(:artist).inner_html                if artist.nil? && (xml).at(:artist)
+        artist           = doc.root['artist']                          if artist.nil? && doc && doc.root['artist']
+
+        album = Album.new(artist, name)
+        album.load_info(xml)
+        album
+      end
+    end
+
+    def initialize(artist, name, o={})
+      raise ArgumentError, "Artist is required" if artist.blank?
+      raise ArgumentError, "Name is required" if name.blank?
+      @artist = artist
+      @name   = name
+
+      options = {:include_info => false}.merge(o)
+      load_info if options[:include_info]
+    end
+
+    def load_info(xml=nil)
+      unless xml
+        doc = self.class.fetch_and_parse("album.getInfo", {:artist => @artist, :album =>@name})
+        xml = (doc / :album).first
+      end
+
+      return self if xml.nil?
+
+      self.artist_mbid    = (xml).at(:artist)['mbid']                   if (xml).at(:artist) && (xml).at(:artist)['mbid']
+      self.artist_mbid    = (xml).at(:artist).at(:mbid).inner_html      if artist_mbid.nil? && (xml).at(:artist) && (xml).at(:artist).at(:mbid)
+      self.mbid           = (xml).at(:mbid).inner_html                  if (xml).at(:mbid)
+      self.playcount      = (xml).at(:playcount).inner_html             if (xml).at(:playcount)
+      self.rank           = xml['rank']                                 if xml['rank']
+      self.rank           = (xml).at(:rank).inner_html                  if (xml).at(:rank) if rank.nil?
+      self.url            = Base.fix_url((xml).at(:url).inner_html)     if (xml).at(:url)
+
+      self.summary        = (xml).at(:summary).to_plain_text            if (xml).at(:summary)
+      self.content        = (xml).at(:content).to_plain_text            if (xml).at(:content)
+
+      self.release_date   = Base.parse_time((xml).at(:releasedate).inner_html.strip) if (xml).at(:releasedate)
+      self.chartposition  = rank
+
+      self.images = {}
+      (xml/'image').each {|image|
+        self.images[image['size']] = image.inner_html if self.images[image['size']].nil?
+      }
+
+      self.image_large    = images['large']
+      self.image_medium   = images['medium']
+      self.image_small    = images['small']
+
+      # needed on top albums for tag
+      self.count          = xml['count'] if xml['count']
+      self.streamable     = xml['streamable'] if xml['streamable']
+
+      self
+    end
+
+    def image(which=:small)
+      which = which.to_s
+      raise ArgumentError unless ['small', 'medium', 'large', 'extralarge'].include?(which)
+      if (self.images.nil?)
+        load_info
+      end
+      self.images[which]
+    end
+  end
+end

data/lib/rockstar/artist.rb

@@ -0,0 +1,183 @@
+# Below are examples of how to find an artists top tracks and similar artists.
+#
+#   artist = Rockstar::Artist.new('Carrie Underwood')
+#
+#   puts 'Top Tracks'
+#   puts "=" * 10
+#   artist.top_tracks.each { |t| puts "#{t.name}" }
+#
+#   puts
+#
+#   puts 'Similar Artists'
+#   puts "=" * 15
+#   artist.similar.each { |a| puts "(#{a.match}%) #{a.name}" }
+#
+# Would output something similar to:
+#
+#   Top Tracks
+#   ==========
+#   (8797) Before He Cheats
+#   (3574) Don't Forget to Remember Me
+#   (3569) Wasted
+#   (3246) Some Hearts
+#   (3142) Jesus, Take the Wheel
+#   (2600) Starts With Goodbye
+#   (2511) Jesus Take The Wheel
+#   (2423) Inside Your Heaven
+#   (2328) Lessons Learned
+#   (2040) I Just Can't Live a Lie
+#   (1899) Whenever You Remember
+#   (1882) We're Young and Beautiful
+#   (1854) That's Where It Is
+#   (1786) I Ain't in Checotah Anymore
+#   (1596) The Night Before (Life Goes On)
+#
+#   Similar Artists
+#   ===============
+#   (100%) Rascal Flatts
+#   (84.985%) Keith Urban
+#   (84.007%) Kellie Pickler
+#   (82.694%) Katharine McPhee
+#   (81.213%) Martina McBride
+#   (79.397%) Faith Hill
+#   (77.121%) Tim McGraw
+#   (75.191%) Jessica Simpson
+#   (75.182%) Sara Evans
+#   (75.144%) The Wreckers
+#   (73.034%) Kenny Chesney
+#   (71.765%) Dixie Chicks
+#   (71.084%) Kelly Clarkson
+#   (69.535%) Miranda Lambert
+#   (66.952%) LeAnn Rimes
+#   (66.398%) Mandy Moore
+#   (65.817%) Bo Bice
+#   (65.279%) Diana DeGarmo
+#   (65.115%) Gretchen Wilson
+#   (62.982%) Clay Aiken
+#   (62.436%) Ashlee Simpson
+#   (62.160%) Christina Aguilera
+module Rockstar
+  class Artist < Base
+    attr_accessor :name, :mbid, :listenercount, :playcount, :rank, :url, :thumbnail
+    attr_accessor :summary, :content, :images, :count, :streamable, :tags
+    attr_accessor :chartposition
+
+    # used for similar artists
+    attr_accessor :match
+
+    class << self
+      def new_from_xml(xml, doc=nil)
+        # occasionally name can be found in root of artist element (<artist name="">) rather than as an element (<name>)
+        name             = (xml).at(:name).inner_html           if (xml).at(:name)
+        name             = xml['name']                          if name.nil? && xml['name']
+
+        artist = Artist.new(name)
+        artist.load_info(xml)
+        artist
+      end
+    end
+
+    def initialize(name, o={})
+      raise ArgumentError, "Name or mbid is required" if name.blank? && o[:mbid].blank?
+      @name = name unless name.blank?
+      @mbid = o[:mbid] unless o[:mbid].blank?
+
+      options = {:include_info => false}.merge(o)
+      load_info if options[:include_info]
+    end
+
+    def load_info(xml=nil)
+      unless xml
+        params = @mbid.blank? ? {:artist => @name} : {:mbid => @mbid}
+
+        doc = self.class.fetch_and_parse("artist.getInfo", params)
+        xml = (doc / :artist).first
+      end
+
+      return self if xml.nil?
+
+      self.name           = (xml).at(:name).inner_html              if (xml).at(:name)
+      self.mbid           = (xml).at(:mbid).inner_html              if (xml).at(:mbid)
+      self.listenercount  = (xml).at(:listeners).inner_html         if (xml).at(:listeners)
+      self.playcount      = (xml).at(:playcount).inner_html         if (xml).at(:playcount)
+      self.chartposition  = self.rank = xml['rank']                 if xml['rank']
+      self.chartposition  = self.rank = (xml).at(:rank).inner_html  if (xml).at(:rank) if self.rank.nil?
+      self.url            = Base.fix_url((xml).at(:url).inner_html) if (xml).at(:url)
+
+      if bio_xml = xml.at(:bio)
+        self.summary      = bio_xml.at(:summary).to_plain_text      if bio_xml.at(:summary)
+        self.content      = bio_xml.at(:content).to_plain_text      if bio_xml.at(:content)
+      end
+
+      self.images = {}
+      (xml/'image').each {|image|
+        self.images[image['size']] = image.inner_html if self.images[image['size']].nil?
+      }
+
+      self.thumbnail      = self.images['small']
+      self.match          = (xml).at(:match).inner_html          if (xml).at(:match)
+
+      # in top artists for tag
+      self.count          = xml['count']                         if xml['count']
+      self.streamable     = xml['streamable']                    if xml['streamable']
+
+      self.streamable     = (xml).at(:streamable).inner_html == '1' ? 'yes' : 'no' if self.streamable.nil? && (xml).at(:streamable)
+
+      self.tags = (xml/'tag/name').collect(&:inner_html)
+
+      self
+    end
+
+    def events(force=false)
+      get_instance("artist.getEvents", :events, :event, {:artist => @name}, force)
+    end
+
+    def similar(force=false)
+      get_instance("artist.getSimilar", :similar, :artist, {:artist => @name}, force)
+    end
+
+    def top_fans(force=false)
+      get_instance("artist.getTopFans", :top_fans, :user, {:artist => @name}, force)
+    end
+
+    def top_tracks(force=false)
+      get_instance("artist.getTopTracks", :top_tracks, :track, {:artist => @name}, force)
+    end
+
+    def top_albums(force=false)
+      get_instance("artist.getTopAlbums", :top_albums, :album, {:artist => @name}, force)
+    end
+
+    def top_tags(force=false)
+      get_instance("artist.getTopTags", :top_tags, :tag, {:artist => @name}, force)
+    end
+
+    def image(which=:medium)
+      which = which.to_s
+      raise ArgumentError unless ['small', 'medium', 'large', 'extralarge'].include?(which)
+      load_info if self.images.nil?
+      self.images[which]
+    end
+
+    def user_images(opts={})
+      if mbid.nil?
+        opts[:artist] = name
+      else
+        opts[:mbid] = mbid
+      end
+
+      images = []
+      image_doc = self.class.fetch_and_parse("artist.getImages", opts, false)
+      (image_doc/'image').each do |xml|
+        image_sizes = {}
+        xml.search('/sizes/size').each do |image|
+          image_sizes[image['name']] = image.inner_html
+        end
+
+        images << image_sizes
+      end
+
+      images
+    end
+  end
+end