rscrobbler 0.1.0 → 0.2.0

data/lib/lastfm/track.rb

@@ -1,248 +1,57 @@
 module LastFM
-  class Track
-    class << self
 
-      TYPE = 'track'
-
-      # Add a list of user supplied tags to a track.
-      #
-      # @option params [String, required] :artist   the artist name
-      # @option params [String, required] :track    the track name
-      # @option params [Array,  required] :tags     array of tags to apply to this track. accepts a maximum of 10.
-      # @see http://www.last.fm/api/show?service=304
-      def add_tags( params )
-        LastFM.requires_authentication
-        LastFM.post( "#{TYPE}.addTags", params )
-      end
-
-      # Ban a track for the current user.
-      #
-      # @option params [String, required] :artist   the artist name
-      # @option params [String, required] :track    the track name
-      # @see http://www.last.fm/api/show?service=261
-      def ban( params )
-        LastFM.requires_authentication
-        LastFM.post( "#{TYPE}.ban", params )
-      end
-
-      # Get a list of buy Links for a track.
-      #
-      # @option params [String,  required unless :mbid] :artist         the artist name
-      # @option params [String,  required unless :mbid] :track          the track name
-      # @option params [String,  optional]              :mbid           the musicbrainz id for the track
-      # @option params [Boolean, optional]              :autocorrect    correct misspelled artist and track names to be returned in the response
-      # @option params [String,  optional]              :country        a country name, as defined by ISO 3166-1
-      # @see http://www.last.fm/api/show?service=431
-      def get_buylinks( params )
-        LastFM.get( "#{TYPE}.getBuylinks", params )
-      end
-
-      # Use the last.fm corrections data to check whether the supplied track has a correction to a canonical track
-      #
-      # @option params [String, required] :artist   the artist name to correct
-      # @option params [String, required] :track    the track name to correct
-      # @see http://www.last.fm/api/show?service=447
-      def get_correction( params )
-        LastFM.get( "#{TYPE}.getCorrection", params )
-      end
-
-      # Retrieve track metadata associated with a fingerprint id generated by the Last.fm Fingerprinter.
-      # Returns track elements, along with a 'rank' value between 0 and 1 reflecting the confidence for
-      # each match.
-      #
-      # @option params [String, required] :fingerprint_id   the fingerprint id to look up
-      # @see http://www.last.fm/api/show?service=441
-      # @see https://github.com/lastfm/Fingerprinter
-      # @see http://blog.last.fm/2010/07/09/fingerprint-api-and-app-updated
-      def get_fingerprint_metadata( params )
-        LastFM.get( "#{TYPE}.getFingerPrintMetadata", params )
-      end
-
-      # Get the metadata for a track.
-      #
-      # @option params [String,  required unless :mbid] :artist         the artist name
-      # @option params [String,  required unless :mbid] :track          the track name
-      # @option params [String,  optional]              :mbid           the musicbrainz id for the track
-      # @option params [Boolean, optional]              :autocorrect    correct misspelled artist and track names to be returned in the response
-      # @option params [String,  optional]              :username       username whose playcount for, and whether they've loved, this track is to be returned in the reponse
-      # @see http://www.last.fm/api/show?service=356
-      def get_info( params )
-        LastFM.get( "#{TYPE}.getInfo", params )
-      end
-
-      # Get shouts for a track.
-      #
-      # @option params [String,  required unless :mbid] :artist         the artist name
-      # @option params [String,  required unless :mbid] :track          the track name
-      # @option params [String,  optional]              :mbid           the musicbrainz id for the track
-      # @option params [Boolean, optional]              :autocorrect    correct misspelled artist and track 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=453
-      def get_shouts( params )
-        LastFM.get( "#{TYPE}.getShouts", params )
-      end
-
-      # Get similar tracks for a track on Last.fm, based on listening data.
-      #
-      # @option params [String,  required unless :mbid] :artist         the artist name
-      # @option params [String,  required unless :mbid] :track          the track name
-      # @option params [String,  optional]              :mbid           the musicbrainz id for the track
-      # @option params [Boolean, optional]              :autocorrect    correct misspelled artist and track names to be returned in the response
-      # @option params [Fixnum,  optional]              :limit          the number of results to fetch. defaults to 50
-      # @see http://www.last.fm/api/show?service=319
-      def get_similar( params )
-        LastFM.get( "#{TYPE}.getSimilar", params )
-      end
-
-      # Get the tags on a track.
-      #
-      # @option params [String,  required unless :mbid] :artist         the artist name
-      # @option params [String,  required unless :mbid] :track          the track name
-      # @option params [String,  optional]              :mbid           the musicbrainz id for the track
-      # @option params [Boolean, optional]              :autocorrect    correct misspelled artist and track 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=320
-      def get_tags( params )
-        secure = !params.include?(:user)
-        LastFM.requires_authentication if secure
-        LastFM.post( "#{TYPE}.getTags", params, secure )
-      end
-
-      # Get the top fans for a track, based on listening data.
-      #
-      # @option params [String,  required unless :mbid] :artist         the artist name
-      # @option params [String,  required unless :mbid] :track          the track name
-      # @option params [String,  optional]              :mbid           the musicbrainz id for the track
-      # @option params [Boolean, optional]              :autocorrect    correct misspelled artist and track names to be returned in the response
-      # @see http://www.last.fm/api/show?service=312
-      def get_top_fans( params )
-        LastFM.get( "#{TYPE}.getTopFans", params )
-      end
-
-      # Get the top fans for a track, ordered by tag count.
-      #
-      # @option params [String,  required unless :mbid] :artist         the artist name
-      # @option params [String,  required unless :mbid] :track          the track name
-      # @option params [String,  optional]              :mbid           the musicbrainz id for the track
-      # @option params [Boolean, optional]              :autocorrect    correct misspelled artist and track names to be returned in the response
-      # @see http://www.last.fm/api/show?service=289
-      def get_top_tags( params )
-        LastFM.get( "#{TYPE}.getTopTags", params )
-      end
-
-      # Love a track for the current user.
-      #
-      # @option params [String, required] :artist   the artist name
-      # @option params [String, required] :track    the track name
-      # @see http://www.last.fm/api/show?service=260
-      def love( params )
-        LastFM.requires_authentication
-        LastFM.post( "#{TYPE}.love", params )
-      end
-
-      # Remove a user's tag from a track.
-      #
-      # @option params [String, required] :artist   the artist name
-      # @option params [String, required] :track    the track name
-      # @option params [String, required] :tag      a single user tag to remove from this track
-      # @see http://www.last.fm/api/show?service=316
-      def remove_tag( params )
-        LastFM.requires_authentication
-        LastFM.post( "#{TYPE}.removeTag", params )
-      end
-
-      # Used to add a track-play to a user's profile. Scrobble a track, or a batch of tracks.
-      # Single tracks may be passed using the Object types listed, batches of tracks must be
-      # passed in as Arrays of each Object type. Allows up to a maximum of 50 scrobbles per
-      # batch. For batch scrobbles, Array indices of optional parameters must line up with
-      # the indicies of their corresponding tracks.
-      #
-      # @option params [String,  required unless :mbid] :artist           artist name
-      # @option params [String,  required unless :mbid] :track            track name
-      # @option params [String,  optional]              :mbid             the musicbrainz id for the track
-      # @option params [Time,    optional]              :timestamp        time the track started playing
-      # @option params [String,  optional]              :album            album name
-      # @option params [String,  optional]              :album_artist     album artist, if this differend from the track artist
-      # @option params [Fixnum,  optional]              :track_number     track number of the track on the album
-      # @option params [Fixnum,  optional]              :duration         track length, in seconds
-      # @option params [String,  optional]              :stream_id        track stream id, received from the radio.getPlaylist service
-      # @option params [Boolean, optional]              :chosen_by_user   whether or not the user chose the track
-      # @option params [String,  optional]              :context          sub-client version (not public, only enabled for certain api keys)
-      # @see http://www.last.fm/api/show?service=443
-      def scrobble( params )
-        LastFM.requires_authentication
-        # Tracks are passed to the service using array notation for each of the above params
-        array_params = {}
-        params.each do |hkey, hval|
-          hval = hval.to_i if hval.is_a?(Time)
-          Array(hval).each_with_index do |aval, index|
-            array_params["#{hkey}[#{index}]"] = aval
+  # @attr [LastFM::Album] album
+  # @attr [LastFM::Artist, String] artist
+  # @attr [Fixnum] duration
+  # @attr [Fixnum] id
+  # @attr [Hash] images
+  # @attr [Fixnum] listeners
+  # @attr [String] mbid
+  # @attr [String] name
+  # @attr [Fixnum] playcount
+  # @attr [Fixnum] position
+  # @attr [Boolean] streamable
+  # @attr [Boolean] streamable_fulltrack
+  # @attr [Array] tags
+  # @attr [String] url
+  # @attr [LastFM::Wii] wiki
+  class Track < Struct.new(:album, :artist, :duration, :id, :images, :listeners, :mbid, :name, :playcount, :position, :streamable, :streamable_fulltrack, :tags, :url, :wiki)
+
+    def update_from_node(node)
+      case node.name.to_sym
+        when :name
+          self.name = node.content
+        when :id
+          self.id = node.content.to_i
+        when :duration
+          self.duration = node.content.to_i
+        when :mbid
+          self.mbid = node.content
+        when :url
+          self.url = 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')
+          self.streamable_fulltrack = (node['fulltrack'] == '1')
+        when :image
+          self.images ||= {}
+          self.images.merge!({node['size'].to_sym => node.content})
+        when :artist
+          self.artist = (node.find('*').count == 0) ? node.content : LastFM::Artist.from_xml(node)
+        when :album
+          self.position = node['position'].to_i
+          self.album = LastFM::Album.from_xml(node)
+        when :toptags
+          self.tags = node.find('tag').map do |tag|
+            LastFM::Tag.from_xml(tag)
           end
-        end
-        LastFM.post( "#{TYPE}.scrobble", array_params )
+        when :wiki
+          self.wiki = LastFM::Wiki.from_xml(node)
       end
-
-      # Search for a track by track name. Returns track matches sorted by relevance.
-      #
-      # @option params [String, required] :track    the track name
-      # @option params [String, optional] :artist   narrow results based on an artist
-      # @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=286
-      def search( params )
-        LastFM.get( "#{TYPE}.search", params )
-      end
-
-      # Share a track twith one or more Last.fm users or other friends.
-      #
-      # @option params [String,  required] :artist      the artist name
-      # @option params [String,  required] :track       the track 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=305
-      def share( params )
-        LastFM.requires_authentication
-        LastFM.post( "#{TYPE}.share", params )
-      end
-
-      # Unban a track for the current user.
-      #
-      # @option params [String, required] :artist   the artist name
-      # @option params [String, required] :track    the track name
-      # @see http://www.last.fm/api/show?service=449
-      def unban( params )
-        LastFM.requires_authentication
-        LastFM.post( "#{TYPE}.unban", params )
-      end
-
-      # Unlove a track for the current user.
-      #
-      # @option params [String, required] :artist   the artist name
-      # @option params [String, required] :track    the track name
-      # @see http://www.last.fm/api/show?service=440
-      def unlove( params )
-        LastFM.requires_authentication
-        LastFM.post( "#{TYPE}.unlove", params )
-      end
-
-      # Used to notify Last.fm that a user has started listening to a track.
-      #
-      # @option params [String,  required unless :mbid] :artist           artist name
-      # @option params [String,  required unless :mbid] :track            track name
-      # @option params [String,  optional]              :mbid             the musicbrainz id for the track
-      # @option params [String,  optional]              :album            album name
-      # @option params [String,  optional]              :album_artist     album artist, if this differend from the track artist
-      # @option params [Fixnum,  optional]              :track_number     track number of the track on the album
-      # @option params [Fixnum,  optional]              :duration         track length, in seconds
-      # @option params [String,  optional]              :context          sub-client version (not public, only enabled for certain api keys)
-      # @see http://www.last.fm/api/show?service=454
-      def update_now_playing( params )
-        LastFM.requires_authentication
-        LastFM.post( "#{TYPE}.updateNowPlaying", params )
-      end
-
     end
-  end 
+
+  end
 end

data/lib/lastfm/venue.rb

@@ -1,40 +1,25 @@
 module LastFM
-  class Venue
-    class << self
+  class Venue < Struct.new(:id, :name, :location, :url, :website, :phone_number, :images)
 
-      TYPE = 'venue'
-
-      # Get a list of upcoming events for a venue.
-      #
-      # @option params [Fixnum,  required] :venue           the id for the venue to fetch event listings for
-      # @option params [Boolean, optional] :festivalsonly   whether only festivals should be returned, or all events
-      # @see http://www.last.fm/api/show?service=394
-      def get_events( params )
-        LastFM.get( "#{TYPE}.getEvents", params )
-      end
-
-      # Get a paginated list of all the events held at this venue in the past.
-      #
-      # @option params [Fixnum,  required] :venue           the id for the venue to fetch event listings for
-      # @option params [Boolean, optional] :festivalsonly   whether only festivals should be returned, or all events
-      # @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=395
-      def get_past_events( params )
-        LastFM.get( "#{TYPE}.getPastEvents", params )
+    def update_from_node(node)
+      case node.name.to_sym
+        when :id
+          self.id = node.content.to_i
+        when :name
+          self.name = node.content
+        when :location
+          # ??? city, country, street, postalcode, geo:lat, geo:long
+        when :url
+          self.url = node.content
+        when :website
+          self.website = node.content
+        when :phoneNumber
+          self.phone_number = node.content
+        when :image
+          self.images ||= {}
+          self.images.merge!({node['size'].to_sym => node.content})
       end
-
-      # Search for a venue by venue name.
-      #
-      # @option params [String, required] :venue      the venue name to search for
-      # @option params [String, optional] :country    a country name used to limit results, as defined by ISO 3166-1
-      # @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=396
-      def search( params )
-        LastFM.get( "#{TYPE}.search", params )
-      end
-
     end
-  end 
-end
+
+  end
+end

data/lib/lastfm/wiki.rb

@@ -0,0 +1,20 @@
+module LastFM
+
+  # @attr [Time] published  Date the information in this entry was published
+  # @attr [String] summary  Short summary of the information in this entry
+  # @attr [String] content  Full content of this entry
+  class Wiki < Struct.new(:published, :summary, :content)
+
+    def update_from_node(node)
+      case node.name.to_sym
+        when :published
+          self.published = Time.parse(node.content)
+        when :summary #TODO: Remove CDATA wrapper
+          self.summary = node.content
+        when :content #TODO: Remove CDATA wrapper
+          self.content = node.content
+      end
+    end
+
+  end
+end

data/lib/rscrobbler.rb

@@ -1,28 +1,41 @@
 require 'digest/md5'
 require 'libxml'
 require 'net/http'
+require 'time'
 require 'uri'
 
 $:.unshift(File.dirname(__FILE__))
 
+require 'lastfm/struct'
+
 require 'lastfm/album'
 require 'lastfm/artist'
-require 'lastfm/auth'
-require 'lastfm/chart'
+require 'lastfm/buylink'
 require 'lastfm/event'
-require 'lastfm/geo'
-require 'lastfm/group'
-require 'lastfm/library'
-require 'lastfm/playlist'
-require 'lastfm/radio'
+require 'lastfm/shout'
 require 'lastfm/tag'
-require 'lastfm/tasteometer'
 require 'lastfm/track'
-require 'lastfm/user'
 require 'lastfm/venue'
+require 'lastfm/wiki'
+
+require 'lastfm/api/album'
+require 'lastfm/api/artist'
+require 'lastfm/api/auth'
+require 'lastfm/api/chart'
+require 'lastfm/api/event'
+require 'lastfm/api/geo'
+require 'lastfm/api/group'
+require 'lastfm/api/library'
+require 'lastfm/api/playlist'
+require 'lastfm/api/radio'
+require 'lastfm/api/tag'
+require 'lastfm/api/tasteometer'
+require 'lastfm/api/track'
+require 'lastfm/api/user'
+require 'lastfm/api/venue'
 
 module LastFM
-  VERSION = '0.1.0'
+  VERSION = '0.2.0'
 
   HOST = 'ws.audioscrobbler.com'
   API_VERSION = '2.0'
@@ -62,7 +75,7 @@ module LastFM
       [:api_key, :api_secret, :username, :auth_token].each do |cred|
         raise AuthenticationError, "Missing credential: #{cred}" unless LastFM.send(cred)
       end
-      self.session_key = Auth.get_mobile_session( username: username, auth_token: auth_token ).find_first('session/key').content
+      self.session_key = Api::Auth.get_mobile_session( username: username, auth_token: auth_token ).find_first('session/key').content
     end
 
     # Has the service been authenticated?

data/test/test_album.rb

@@ -0,0 +1,36 @@
+require 'test/unit'
+load 'lib/rscrobbler.rb'
+
+def check_attributes(model, attrs)
+  attrs.each do |attr|
+    assert_not_nil model.send(attr), "#{attr} expected to be set."
+  end
+end
+
+class LastFM::AlbumTest < Test::Unit::TestCase
+
+  def setup
+    LastFM.api_key = 'b25b959554ed76058ac220b7b2e0a026'
+    @artist = 'Cher'
+    @album = 'Believe'
+  end
+
+  def test_search
+    albums = LastFM::Album.search :album => @album, :limit => 1
+    assert_equal 1, albums.size
+    assert albums.first.is_a? LastFM::Album
+    check_attributes albums.first, [:name, :artist, :id, :url, :images, :streamable, :mbid]
+  end
+
+  def test_get_info
+    assert_raise LastFM::LastFMError do
+      LastFM::Album.get_info :album => @album
+    end
+    album = LastFM::Album.get_info :artist => @artist, :album => @album
+    assert_equal @artist, album.artist
+    assert_equal @album, album.name
+    assert album.wiki.is_a? LastFM::Wiki
+    check_attributes album, [:artist, :id, :images, :listeners, :mbid, :name, :playcount, :release_date, :tags, :tracks, :url, :wiki]
+  end
+
+end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: rscrobbler
 version: !ruby/object:Gem::Version
-  version: 0.1.0
+  version: 0.2.0
   prerelease: 
 platform: ruby
 authors:
@@ -9,11 +9,11 @@ authors:
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2012-01-30 00:00:00.000000000Z
+date: 2012-04-23 00:00:00.000000000Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: libxml-ruby
-  requirement: &2164437020 !ruby/object:Gem::Requirement
+  requirement: &2152911920 !ruby/object:Gem::Requirement
     none: false
     requirements:
     - - ! '>='
@@ -21,7 +21,7 @@ dependencies:
         version: '0'
   type: :runtime
   prerelease: false
-  version_requirements: *2164437020
+  version_requirements: *2152911920
 description: rscrobbler is a Ruby gem for accessing Last.fm's API (http://www.last.fm/api).
 email:
 - sgt.floydpepper@gmail.com
@@ -31,37 +31,32 @@ extensions: []
 extra_rdoc_files: []
 files:
 - lib/lastfm/album.rb
+- lib/lastfm/api/album.rb
+- lib/lastfm/api/artist.rb
+- lib/lastfm/api/auth.rb
+- lib/lastfm/api/chart.rb
+- lib/lastfm/api/event.rb
+- lib/lastfm/api/geo.rb
+- lib/lastfm/api/group.rb
+- lib/lastfm/api/library.rb
+- lib/lastfm/api/playlist.rb
+- lib/lastfm/api/radio.rb
+- lib/lastfm/api/tag.rb
+- lib/lastfm/api/tasteometer.rb
+- lib/lastfm/api/track.rb
+- lib/lastfm/api/user.rb
+- lib/lastfm/api/venue.rb
 - lib/lastfm/artist.rb
-- lib/lastfm/auth.rb
-- lib/lastfm/chart.rb
+- lib/lastfm/buylink.rb
 - lib/lastfm/event.rb
-- lib/lastfm/geo.rb
-- lib/lastfm/group.rb
-- lib/lastfm/library.rb
-- lib/lastfm/playlist.rb
-- lib/lastfm/radio.rb
+- lib/lastfm/shout.rb
+- lib/lastfm/struct.rb
 - lib/lastfm/tag.rb
-- lib/lastfm/tasteometer.rb
 - lib/lastfm/track.rb
-- lib/lastfm/user.rb
 - lib/lastfm/venue.rb
+- lib/lastfm/wiki.rb
 - lib/rscrobbler.rb
-- test/unit/lib/lastfm/album_test.rb
-- test/unit/lib/lastfm/artist_test.rb
-- test/unit/lib/lastfm/auth_test.rb
-- test/unit/lib/lastfm/chart_test.rb
-- test/unit/lib/lastfm/event_test.rb
-- test/unit/lib/lastfm/geo_test.rb
-- test/unit/lib/lastfm/group_test.rb
-- test/unit/lib/lastfm/library_test.rb
-- test/unit/lib/lastfm/playlist_test.rb
-- test/unit/lib/lastfm/radio_test.rb
-- test/unit/lib/lastfm/tag_test.rb
-- test/unit/lib/lastfm/tasteometer_test.rb
-- test/unit/lib/lastfm/track_test.rb
-- test/unit/lib/lastfm/user_test.rb
-- test/unit/lib/lastfm/venue_test.rb
-- test/unit/lib/rscrobbler_test.rb
+- test/test_album.rb
 - bin/generate_lastfm_auth_token
 homepage: https://github.com/sgtFloyd/rscrobbler
 licenses: []
@@ -88,20 +83,5 @@ signing_key:
 specification_version: 3
 summary: Last.fm API wrapper
 test_files:
-- test/unit/lib/lastfm/album_test.rb
-- test/unit/lib/lastfm/artist_test.rb
-- test/unit/lib/lastfm/auth_test.rb
-- test/unit/lib/lastfm/chart_test.rb
-- test/unit/lib/lastfm/event_test.rb
-- test/unit/lib/lastfm/geo_test.rb
-- test/unit/lib/lastfm/group_test.rb
-- test/unit/lib/lastfm/library_test.rb
-- test/unit/lib/lastfm/playlist_test.rb
-- test/unit/lib/lastfm/radio_test.rb
-- test/unit/lib/lastfm/tag_test.rb
-- test/unit/lib/lastfm/tasteometer_test.rb
-- test/unit/lib/lastfm/track_test.rb
-- test/unit/lib/lastfm/user_test.rb
-- test/unit/lib/lastfm/venue_test.rb
-- test/unit/lib/rscrobbler_test.rb
+- test/test_album.rb
 has_rdoc: 

data/lib/lastfm/auth.rb

@@ -1,35 +0,0 @@
-module LastFM
-  class Auth
-    class << self
-
-      TYPE = 'auth'
-
-      # 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( "#{TYPE}.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( "#{TYPE}.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( "#{TYPE}.getToken", {}, :secure )
-      end
-
-    end
-  end
-end