rscrobbler 0.2.2 → 0.3.0

checksums.yaml

@@ -0,0 +1,15 @@
+---
+!binary "U0hBMQ==":
+  metadata.gz: !binary |-
+    YTc2YTM0NGVjZWU5NzRiNWRlYzZhYjVkZTEwNmIwNzM1ZDk1NzVmYw==
+  data.tar.gz: !binary |-
+    MGJiMzZhNjRhMmMwOTJlZjkzYzE4ODQzYmJlYThhMmU2ZDYwNTIzMQ==
+SHA512:
+  metadata.gz: !binary |-
+    OWUyODBhMWU3YmE0ZTMxYmZkNDAyOTFiZjk2NmEzMmMwMDRmYjk0M2UwMjk0
+    Y2I5YTVhNGY5Mzc4MGJhOTdkZTUzMmZlOWNiZjRjYzkxYjY3NDdhZGI1NTgw
+    NDU1M2YwMmZmMmFiYzdmZDQ4ZTEwYWZlM2ZjMWM3NDYzMDNmYTI=
+  data.tar.gz: !binary |-
+    NmFmMzBhZDMzNTY2ZGM2MDFmNzZjZDE2NjM3YTQ2ZmU3ZTMyOGRmZDY4NjY2
+    Y2E3MzQ4NjM2N2JiNmE3ZjMyMjAyZjMzODE1MDU1MjYyZTk2YzQ5NDViOWRl
+    YWQ1MTc4ODlkODc1MjgyNjIxZDNmMzFhODFhMTQ1ZmE1ODQzMDg=

data/lib/lastfm/album.rb

@@ -1,55 +1,197 @@
-module LastFM
-
-  # @attr [LastFM::Artist, String] artist
-  # @attr [Fixnum] id
-  # @attr [Hash] images
-  # @attr [Fixnum] listeners
-  # @attr [String] mbid
-  # @attr [String] name
-  # @attr [Fixnum] playcount
-  # @attr [Time] release_date
-  # @attr [Boolean] streamable
-  # @attr [Array<LastFM::Tag>] tags
-  # @attr [Array<LastFM::Track>] tracks
-  # @attr [String] url
-  # @attr [LastFM::Wiki] wiki
-  class Album < Struct.new(:artist, :id, :images, :listeners, :mbid, :name, :playcount, :release_date, :streamable, :tags, :tracks, :url, :wiki)
-
-    def update_from_node(node)
-      case node.name.to_sym
-        when :name, :title
-          self.name = node.content
-        when :artist
-          self.artist = (node.find('*').count == 0) ? node.content : LastFM::Artist.from_xml(node)
-        when :id
-          self.id = node.content.to_i
-        when :mbid
-          self.mbid = node.content
-        when :url
-          self.url = node.content
-        when :releasedate
-          self.release_date = Time.parse(node.content) rescue nil
-        when :image
-          self.images ||= {}
-          self.images.merge!({node['size'].to_sym => node.content})
-        when :listeners
-          self.listeners = node.content.to_i
-        when :playcount
-          self.playcount = node.content.to_i
-        when :streamable
-          self.streamable = (node.content == '1')
-        when :tracks
-          self.tracks = node.find('track').map do |track|
-            LastFM::Track.from_xml(track, :album => self.name, :position => track['rank'].to_i)
-          end
-        when :toptags
-          self.tags = node.find('tag').map do |tag|
-            LastFM::Tag.from_xml(tag)
-          end
-        when :wiki
-          self.wiki = LastFM::Wiki.from_xml(node)
-      end
-    end
-
-  end
-end
+module LastFM
+
+  # @attr [LastFM::Artist, String] artist
+  # @attr [Fixnum] id
+  # @attr [Hash] images
+  # @attr [Fixnum] listeners
+  # @attr [String] mbid
+  # @attr [String] name
+  # @attr [Fixnum] playcount
+  # @attr [Time] release_date
+  # @attr [Boolean] streamable
+  # @attr [Array<LastFM::Tag>] tags
+  # @attr [Array<LastFM::Track>] tracks
+  # @attr [String] url
+  # @attr [LastFM::Wiki] wiki
+  class Album < Struct.new(:artist, :id, :images, :listeners, :mbid, :name, :playcount, :release_date, :streamable, :tags, :tracks, :url, :wiki)
+
+    # API Methods
+    class << self
+
+      # Tag an album using a list of user supplied tags.
+      #
+      # @option params [String, required] :artist the artist name
+      # @option params [String, required] :album  the album name
+      # @option params [Array, required]  :tags   up to 10 tags to apply to this album
+      # @see http://www.last.fm/api/show?service=302
+      def add_tags( params )
+        LastFM.requires_authentication
+        LastFM.post( "album.addTags", params )
+      end
+
+      # Get a list of buy links for an album.
+      #
+      # @option params [String,  required unless :mbid] :artist         the artist name
+      # @option params [String,  required unless :mbid] :album          the album name
+      # @option params [String,  required]              :country        a country name, as defined by ISO 3166-1
+      # @option params [String,  optional]              :mbid           the musicbrainz id for the album
+      # @option params [Boolean, optional]              :autocorrect    transform misspelled artist names into correct artist names to be returned in the response
+      # @return [Array<LastFM::Buylink>] collection of links where this album can be bought or downloaded
+      # @see http://www.last.fm/api/show?service=429
+      def get_buylinks( params )
+        xml = LastFM.get( "album.getBuylinks", params )
+        [:physical, :download].each_with_object([]) do |type, buylinks|
+          xml.find("affiliations/#{type}s/affiliation").each do |buylink|
+            buylinks << LastFM::Buylink.from_xml( buylink, :type => type )
+          end
+        end
+      end
+
+      # Get the metadata for an album.
+      #
+      # @option params [String,  required unless :mbid] :artist         the artist name
+      # @option params [String,  required unless :mbid] :album          the album name
+      # @option params [String,  optional]              :mbid           the musicbrainz id for the album
+      # @option params [String,  optional]              :lang           the language to return the biography in, expressed as an ISO 639 alpha-2 code
+      # @option params [Boolean, optional]              :autocorrect    transform misspelled artist names into correct artist names to be returned in the response
+      # @option params [String,  optional]              :username       username whose playcount for this album is to be returned in the reponse
+      # @return [LastFM::Album] album constructed from the metadata contained in the response
+      # @see http://www.last.fm/api/show?service=290
+      def get_info( params )
+        xml = LastFM.get( "album.getInfo", params )
+        LastFM::Album.from_xml( xml )
+      end
+
+      # Get shouts for an album.
+      #
+      # @option params [String,  required unless :mbid] :artist         the artist name
+      # @option params [String,  required unless :mbid] :album          the album name
+      # @option params [String,  optional]              :mbid           the musicbrainz id for the album
+      # @option params [Boolean, optional]              :autocorrect    transform misspelled artist names into correct artist names to be returned in the response
+      # @option params [Fixnum,  optional]              :page           the page number to fetch. defaults to first page
+      # @option params [Fixnum,  optional]              :limit          the number of results to fetch per page. defaults to 50
+      # @return [Array<LastFM::Shout>] collection of shouts
+      # @see http://www.last.fm/api/show?service=450
+      def get_shouts( params )
+        xml = LastFM.get( "album.getShouts", params )
+        xml.find('shouts/shout').map do |shout|
+          LastFM::Shout.from_xml( shout )
+        end
+      end
+
+      # Get the tags applied by an individual user to an album.
+      #
+      # @option params [String,  required unless :mbid] :artist         the artist name
+      # @option params [String,  required unless :mbid] :album          the album name
+      # @option params [String,  optional]              :mbid           the musicbrainz id for the album
+      # @option params [Boolean, optional]              :autocorrect    transform misspelled artist names into correct artist names to be returned in the response
+      # @option params [String,  optional]              :user           if called in non-authenticated mode you must specify the user to look up
+      # @see http://www.last.fm/api/show?service=317
+      def get_tags( params )
+        secure = !params.include?(:user)
+        LastFM.requires_authentication if secure
+        xml = LastFM.get( "album.getTags", params, secure )
+        xml.find('tags/tag').map do |tag|
+          LastFM::Tag.from_xml( tag )
+        end
+      end
+
+      # Get the top tags for an album, ordered by popularity.
+      #
+      # @option params [String,  required unless :mbid] :artist         the artist name
+      # @option params [String,  required unless :mbid] :album          the album name
+      # @option params [String,  optional]              :mbid           the musicbrainz id for the album
+      # @option params [Boolean, optional]              :autocorrect    transform misspelled artist names into correct artist names to be returned in the response
+      # @return [Array<LastFM::Tag>] list of tags sorted by popularity
+      # @see http://www.last.fm/api/show?service=438
+      def get_top_tags( params )
+        xml = LastFM.get( "album.getTopTags", params )
+        xml.find('toptags/tag').map do |tag|
+          LastFM::Tag.from_xml( tag )
+        end
+      end
+
+      # Remove a user's tag from an album.
+      #
+      # @option params [String, required] :artist   the artist name
+      # @option params [String, required] :album    the album name
+      # @option params [String, required] :tag      a single user tag to remove from this album
+      # @see http://www.last.fm/api/show?service=314
+      def remove_tag( params )
+        LastFM.requires_authentication
+        LastFM.post( "album.removeTag", params )
+      end
+
+      # Search for an album by name. Returns album matches sorted by relevance.
+      #
+      # @option params [String, required] :album    the album name
+      # @option params [Fixnum, optional] :page     the page number to fetch. defaults to first page
+      # @option params [Fixnum, optional] :limit    the number of results to fetch per page. defaults to 50
+      # @return [Array<LastFM::Album>] list of albums sorted by relevance
+      # @see http://www.last.fm/api/show?service=357
+      def search( params )
+        xml = LastFM.get( "album.search", params )
+        xml.find('results/albummatches/album').map do |album|
+          LastFM::Album.from_xml( album )
+        end
+      end
+
+      # Share an album with one or more Last.fm users or other friends.
+      #
+      # @option params [String,  required] :artist      the artist name
+      # @option params [String,  required] :album       the album name
+      # @option params [Array,   required] :recipient   a list of email addresses or Last.fm usernames. maximum is 10
+      # @option params [String,  optional] :message     an optional message to send. if not supplied a default message will be used
+      # @option params [Boolean, optional] :public      optionally show in the sharing users activity feed. defaults to false
+      # @see http://www.last.fm/api/show?service=436
+      def share( params )
+        LastFM.requires_authentication
+        LastFM.post( "album.share", params )
+      end
+
+    end
+
+  private
+
+    # Compensate for discrepancies between XML response and model attributes
+    alias :image= :images=
+    alias :title= :name=
+    alias :releasedate= :release_date=
+    alias :toptags= :tags=
+
+    def parse_node(member, node)
+      case member
+      when :artist
+        if node.find('*').count == 0
+          node.content
+        else
+          LastFM::Artist.from_xml(node)
+        end
+      when :id, :listeners, :playcount
+        node.content.to_i
+      when :images
+        (self.images || {}).merge(node['size'].to_sym => node.content)
+      when :mbid, :name, :url
+        node.content
+      when :release_date
+        Time.parse(node.content) rescue nil
+      when :streamable
+        node.content == '1'
+      when :tags
+        node.find('tag').map do |tag|
+          LastFM::Tag.from_xml(tag)
+        end
+      when :tracks
+        node.find('track').map do |track|
+          LastFM::Track.from_xml(track,
+            :album => self.name,
+            :position => track['rank'].to_i
+          )
+        end
+      when :wiki
+        LastFM::Wiki.from_xml(node)
+      end
+    end
+
+  end
+end

data/lib/lastfm/artist.rb

@@ -1,48 +1,291 @@
-module LastFM
-
-  # @attr [Hash] images
-  # @attr [Fixnum] listeners
-  # @attr [String] mbid
-  # @attr [String] name
-  # @attr [Fixnum] playcount
-  # @attr [Array] similar
-  # @attr [Boolean] streamable
-  # @attr [Array] tags
-  # @attr [String]  url
-  # @attr [LastFM::Wiki] wiki
-  class Artist < Struct.new(:images, :listeners, :mbid, :name, :playcount, :similar, :streamable, :tags, :url, :wiki)
-
-    def update_from_node(node)
-      case node.name.to_sym
-        when :name
-          self.name = node.content
-        when :mbid
-          self.mbid = node.content
-        when :url
-          self.url = node.content
-        when :image
-          self.images ||= {}
-          self.images.merge!({node['size'].to_sym => node.content})
-        when :streamable
-          self.streamable = (node.content == '1')
-        when :listeners
-          self.listeners = node.content.to_i
-        when :playcount
-          self.playcount = node.content.to_i
-        when :stats # nested listeners and playcount
-          node.find('*').each{|child| self.update_from_node(child)}
-        when :similar
-          self.similar = node.find('artist').map do |artist|
-            LastFM::Artist.from_xml(artist)
-          end
-        when :tags
-          self.tags = node.find('tag').map do |tag|
-            LastFM::Tag.from_xml(tag)
-          end
-        when :bio
-          self.wiki = LastFM::Wiki.from_xml(node)
-      end
-    end
-
-  end
-end
+module LastFM
+
+  # @attr [Hash] images
+  # @attr [Fixnum] listeners
+  # @attr [String] mbid
+  # @attr [String] name
+  # @attr [Fixnum] playcount
+  # @attr [Array] similar
+  # @attr [Boolean] streamable
+  # @attr [Array] tags
+  # @attr [String]  url
+  # @attr [LastFM::Wiki] wiki
+  class Artist < Struct.new(:images, :listeners, :mbid, :name, :playcount, :similar, :streamable, :tags, :url, :wiki)
+
+    # API Methods
+    class << self
+
+      # Tag an artist with one or more user supplied tags.
+      #
+      # @option params [String, required] :artist   the artist name
+      # @option params [Array, required]  :tags     up to 10 tags to apply to this artist
+      # @see http://www.last.fm/api/show/?service=303
+      def add_tags( params )
+        LastFM.requires_authentication
+        LastFM.post( "artist.addTags", params )
+      end
+
+      # Check whether the supplied artist has a correction to a canonical artist.
+      #
+      # @option params [String, required] :artist   the artist name
+      # @return [Array<LastFM::Artist>] list of suggestion corrections, in order of similarity
+      # @see http://www.last.fm/api/show/?service=446
+      def get_correction( params )
+        xml = LastFM.get( "artist.getCorrection", params )
+        xml.find('corrections/correction/artist').map do |correction|
+          LastFM::Artist.from_xml( correction )
+        end
+      end
+
+      # Get a list of upcoming events for this artist.
+      #
+      # @option params [String,  required unless :mbid] :artist           the artist name
+      # @option params [String,  optional]              :mbid             the musicbrainz id for the artist
+      # @option params [Boolean, optional]              :festivalsonly    whether only festivals should be returned, or all events
+      # @option params [Boolean, optional]              :autocorrect      transform misspelled artist names into correct artist names to be returned in the response
+      # @option params [Fixnum,  optional]              :page             the page number to fetch. defaults to first page
+      # @option params [Fixnum,  optional]              :limit            the number of results to fetch per page. defaults to 50
+      # @see http://www.last.fm/api/show/?service=117
+      def get_events( params )
+        xml = LastFM.get( "artist.getEvents", params )
+        xml.find('events/event').map do |event|
+          LastFM::Event.from_xml( event )
+        end
+      end
+
+      # Get images for this artist in a variety of sizes.
+      #
+      # @option params [String,  required unless :mbid] :artist         the artist name
+      # @option params [String,  optional]              :mbid           the musicbrainz id for the artist
+      # @option params [Symbol,  optional]              :order          sort ordering can be either :popularity (default) or :dateadded
+      # @option params [Boolean, optional]              :autocorrect    transform misspelled artist names into correct artist names to be returned in the response
+      # @option params [Fixnum,  optional]              :page           the page number to fetch. defaults to first page
+      # @option params [Fixnum,  optional]              :limit          the number of results to fetch per page. defaults to 50
+      # @see http://www.last.fm/api/show/?service=407
+      def get_images( params )
+        LastFM.get( "artist.getImages", params )
+      end
+
+      # Get the metadata for an artist. Includes biography.
+      #
+      # @option params [String,  required unless :mbid] :artist         the artist name
+      # @option params [String,  optional]              :mbid           the musicbrainz id for the artist
+      # @option params [String,  optional]              :lang           the language to return the biography in, expressed as an ISO 639 alpha-2 code
+      # @option params [Boolean, optional]              :autocorrect    transform misspelled artist names into correct artist names to be returned in the response
+      # @option params [String,  optional]              :username       username whose playcount for this artist is to be returned in the reponse
+      # @return [LastFM::Artist] artist constructed from the metadata contained in the response
+      # @see http://www.last.fm/api/show/?service=267
+      def get_info( params )
+        xml = LastFM.get( "artist.getInfo", params )
+        LastFM::Artist.from_xml( xml )
+      end
+
+      # Get a paginated list of all the events this artist has played at in the past.
+      #
+      # @option params [String,  required unless :mbid] :artist         the artist name
+      # @option params [String,  optional]              :mbid           the musicbrainz id for the artist
+      # @option params [Boolean, optional]              :autocorrect    transform misspelled artist names into correct artist names to be returned in the response
+      # @option params [Fixnum,  optional]              :page           the page number to fetch. defaults to first page
+      # @option params [Fixnum,  optional]              :limit          the number of results to fetch per page. defaults to 50
+      # @see http://www.last.fm/api/show/?service=428
+      def get_past_events( params )
+        LastFM.get( "artist.getPastEvents", params )
+      end
+
+      # Get a podcast of free mp3s based on an artist.
+      #
+      # @option params [String,  required unless :mbid] :artist         the artist name
+      # @option params [String,  optional]              :mbid           the musicbrainz id for the artist
+      # @option params [Boolean, optional]              :autocorrect    transform misspelled artist names into correct artist names to be returned in the response
+      # @see http://www.last.fm/api/show/?service=118
+      def get_podcast( params )
+        LastFM.get( "artist.getPodcast", params )
+      end
+
+      # Get shouts for this artist.
+      #
+      # @option params [String,  required unless :mbid] :artist         the artist name
+      # @option params [String,  optional]              :mbid           the musicbrainz id for the artist
+      # @option params [Boolean, optional]              :autocorrect    transform misspelled artist names into correct artist names to be returned in the response
+      # @option params [Fixnum,  optional]              :page           the page number to fetch. defaults to first page
+      # @option params [Fixnum,  optional]              :limit          the number of results to fetch per page. defaults to 50
+      # @return [Array<LastFM::Shout>] collection of shouts
+      # @see http://www.last.fm/api/show/?service=397
+      def get_shouts( params )
+        xml = LastFM.get( "artist.getShouts", params )
+        xml.find('shouts/shout').map do |shout|
+          LastFM::Shout.from_xml( shout )
+        end
+      end
+
+      # Get all the artists similar to this artist.
+      #
+      # @option params [String,  required unless :mbid] :artist         the artist name
+      # @option params [String,  optional]              :mbid           the musicbrainz id for the artist
+      # @option params [Boolean, optional]              :autocorrect    transform misspelled artist names into correct artist names to be returned in the response
+      # @option params [Fixnum,  optional]              :limit          limit the number of results to fetch
+      # @return [Array<LastFM::Artist>] list of similar artists
+      # @see http://www.last.fm/api/show/?service=119
+      def get_similar( params )
+        xml = LastFM.get( "artist.getSimilar", params )
+        xml.find('similarartists/artist').map do |artist|
+          LastFM::Artist.from_xml( artist )
+        end
+      end
+
+      # Get the tags applied by an individual user to an artist on Last.fm. If accessed as an authenticated service
+      # and you don't supply a user parameter then this service will return tags for the authenticated user.
+      #
+      # @option params [String,  required unless :mbid] :artist         the artist name
+      # @option params [String,  optional]              :mbid           the musicbrainz id for the artist
+      # @option params [Boolean, optional]              :autocorrect    transform misspelled artist names into correct artist names to be returned in the response
+      # @option params [String,  optional]              :user           if called in non-authenticated mode you must specify the user to look up
+      # @see http://www.last.fm/api/show/?service=318
+      def get_tags( params )
+        secure = !params.include?(:user)
+        LastFM.requires_authentication if secure
+        LastFM.get( "artist.getTags", params, secure )
+      end
+
+      # Get the top albums for an artist, ordered by popularity.
+      #
+      # @option params [String,  required unless :mbid] :artist         the artist name
+      # @option params [String,  optional]              :mbid           the musicbrainz id for the artist
+      # @option params [Boolean, optional]              :autocorrect    transform misspelled artist names into correct artist names to be returned in the response
+      # @option params [Fixnum,  optional]              :page           the page number to fetch. defaults to first page
+      # @option params [Fixnum,  optional]              :limit          the number of results to fetch per page. defaults to 50
+      # @return [Array<LastFM::Album>] top albums, ordered by popularity
+      # @see http://www.last.fm/api/show/?service=287
+      def get_top_albums( params )
+        xml = LastFM.get( "artist.getTopAlbums", params )
+        xml.find('topalbums/album').map do |album|
+          LastFM::Album.from_xml( album )
+        end
+      end
+
+      # Get the top fans for an artist on Last.fm, based on listening data.
+      #
+      # @option params [String,  required unless :mbid] :artist         the artist name
+      # @option params [String,  optional]              :mbid           the musicbrainz id for the artist
+      # @option params [Boolean, optional]              :autocorrect    transform misspelled artist names into correct artist names to be returned in the response
+      # @see http://www.last.fm/api/show/?service=310
+      def get_top_fans( params )
+        LastFM.get( "artist.getTopFans", params )
+      end
+
+      # Get the top tags for an artist, ordered by popularity.
+      #
+      # @option params [String,  required unless :mbid] :artist         the artist name
+      # @option params [String,  optional]              :mbid           the musicbrainz id for the artist
+      # @option params [Boolean, optional]              :autocorrect    transform misspelled artist names into correct artist names to be returned in the response
+      # @return [Array<LastFM::Tag>] list of tags ordered by popularity
+      # @see http://www.last.fm/api/show/?service=288
+      def get_top_tags( params )
+        xml = LastFM.get( "artist.getTopTags", params )
+        xml.find('toptags/tag').map do |tag|
+          LastFM::Tag.from_xml( tag )
+        end
+      end
+
+      # Get the top tracks by an artist, ordered by popularity.
+      #
+      # @option params [String,  required unless :mbid] :artist         the artist name
+      # @option params [String,  optional]              :mbid           the musicbrainz id for the artist
+      # @option params [Boolean, optional]              :autocorrect    transform misspelled artist names into correct artist names to be returned in the response
+      # @option params [Fixnum,  optional]              :page           the page number to fetch. defaults to first page
+      # @option params [Fixnum,  optional]              :limit          the number of results to fetch per page. defaults to 50
+      # @return [Array<LastFM::Track>] top tracks, ordered by popularity
+      # @see http://www.last.fm/api/show/?service=277
+      def get_top_tracks( params )
+        xml = LastFM.get( "artist.getTopTracks", params )
+        xml.find('toptracks/track').map do |track|
+          LastFM::Track.from_xml( track )
+        end
+      end
+
+      # Remove a user's tag from an artist.
+      #
+      # @option params [String, required] :artist   the artist name
+      # @option params [String, required] :tag      a single user tag to remove from this artist
+      # @see http://www.last.fm/api/show/?service=315
+      def remove_tag( params )
+        LastFM.requires_authentication
+        LastFM.post( "artist.removeTag", params )
+      end
+
+      # Search for an artist by name. Returns artist matches sorted by relevance.
+      #
+      # @option params [Fixnum, optional] :page     the page number to fetch. defaults to first page
+      # @option params [Fixnum, optional] :limit    the number of results to fetch per page. defaults to 50
+      # @option params [String, required] :artist   the artist name
+      # @return [Array<LastFM::Artist>] list of artists sorted by relevance
+      # @see http://www.last.fm/api/show/?service=272
+      def search( params )
+        xml = LastFM.get( "artist.search", params )
+        xml.find('results/artistmatches/artist').map do |artist|
+          LastFM::Artist.from_xml( artist )
+        end
+      end
+
+      # Share an artist with Last.fm users or other friends.
+      #
+      # @option params [String,  required] :artist      the artist name
+      # @option params [Array,   required] :recipient   a list of email addresses or Last.fm usernames. maximum is 10
+      # @option params [String,  optional] :message     an optional message to send. if not supplied a default message will be used
+      # @option params [Boolean, optional] :public      optionally show in the sharing users activity feed. defaults to false
+      # @see http://www.last.fm/api/show/?service=306
+      def share( params )
+        LastFM.requires_authentication
+        LastFM.post( "artist.share", params )
+      end
+
+      # Shout in this artist's shoutbox.
+      #
+      # @option params [String, required] :artist     name of the artist to shout on
+      # @option params [String, required] :message    message to post to the shoutbox
+      # @see http://www.last.fm/api/show/?service=408
+      def shout( params )
+        LastFM.requires_authentication
+        LastFM.post( "artist.shout", params )
+      end
+
+    end
+
+  private
+
+    # Compensate for discrepancies between XML response and model attributes
+    alias :image= :images=
+    alias :bio= :wiki=
+
+    # node with nested listeners and playcount
+    def stats=(node)
+      node.find('*').each do |child|
+        send(:"#{child.name}=", child)
+      end
+    end
+
+    def parse_node(member, node)
+      case member
+      when :images
+        (self.images || {}).merge(node['size'].to_sym => node.content)
+      when :listeners, :playcount
+        node.content.to_i
+      when :name, :mbid, :url
+        node.content
+      when :similar
+        node.find('artist').map do |artist|
+          LastFM::Artist.from_xml(artist)
+        end
+      when :streamable
+        node.content == '1'
+      when :tags
+        node.find('tag').map do |tag|
+          LastFM::Tag.from_xml(tag)
+        end
+      when :wiki
+        LastFM::Wiki.from_xml(node)
+      end
+    end
+
+  end
+end

data/lib/lastfm/auth.rb

@@ -0,0 +1,33 @@
+module LastFM
+  class Auth
+    class << self
+
+      # Create a web service session for a user. Used for authenticating a user when the
+      # password can be inputted by the user. Only suitable for standalone mobile devices.
+      #
+      # @option params [String, required] :username     last.fm username
+      # @option params [String, required] :auth_token   md5 hash of the username + the password hash
+      # @see http://www.last.fm/api/show?service=266
+      def get_mobile_session( params )
+        LastFM.get( "auth.getMobileSession", params, :secure )
+      end
+
+      # Fetch a session key for a user. The third step in the authentication process.
+      #
+      # @option params [String, required] :token    md5 hash returned by step 1 of the authentication process
+      # @see http://www.last.fm/api/show?service=125
+      def get_session( params )
+        LastFM.get( "auth.getSession", params, :secure )
+      end
+
+      # Fetch an unathorized request token for an API account. This is step 2 of
+      # the authentication process for desktop applications.
+      #
+      # @see http://www.last.fm/api/show?service=265
+      def get_token
+        LastFM.get( "auth.getToken", {}, :secure )
+      end
+
+    end
+  end
+end