rscrobbler 0.2.2 → 0.3.0

data/lib/lastfm/buylink.rb

@@ -1,34 +1,34 @@
-module LastFM
-
-  # @attr [Symbol] type  whether the link is for a physical purchase, or a download
-  # @attr [Hash] supplier
-  # @attr [Hash] price
-  # @attr [String] link
-  # @attr [Boolean] is_search
-  class Buylink < Struct.new(:type, :supplier, :price, :link, :is_search)
-
-    def update_from_node(node)
-      case node.name.to_sym
-        when :supplierName
-          self.supplier ||= {}
-          self.supplier[:name] = node.content
-        when :supplierIcon
-          self.supplier ||= {}
-          self.supplier[:icon] = node.content
-        when :price # nested price & currency
-          node.find('*').each{|child| self.update_from_node(child)}
-        when :amount
-          self.price ||= {}
-          self.price[:amount] = node.content.to_f
-        when :currency
-          self.price ||= {}
-          self.price[:currency] = node.content
-        when :buyLink
-          self.link = node.content
-        when :isSearch
-          self.is_search = (node.content == '1')
-      end
-    end
-
-  end
-end
+module LastFM
+
+  # @attr [Symbol] type  whether the link is for a physical purchase, or a download
+  # @attr [Hash] supplier
+  # @attr [Hash] price
+  # @attr [String] link
+  # @attr [Boolean] is_search
+  class Buylink < Struct.new(:type, :supplier, :price, :link, :is_search)
+
+    def update_from_node(node)
+      case node.name.to_sym
+        when :supplierName
+          self.supplier ||= {}
+          self.supplier[:name] = node.content
+        when :supplierIcon
+          self.supplier ||= {}
+          self.supplier[:icon] = node.content
+        when :price # nested price & currency
+          node.find('*').each{|child| self.update_from_node(child)}
+        when :amount
+          self.price ||= {}
+          self.price[:amount] = node.content.to_f
+        when :currency
+          self.price ||= {}
+          self.price[:currency] = node.content
+        when :buyLink
+          self.link = node.content
+        when :isSearch
+          self.is_search = (node.content == '1')
+      end
+    end
+
+  end
+end

data/lib/lastfm/chart.rb

@@ -0,0 +1,61 @@
+module LastFM
+  class Chart
+    class << self
+
+      # Get the hyped artists chart
+      #
+      # @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=493
+      def get_hyped_artists( params )
+        LastFM.get( "chart.getHypedArtists", params )
+      end
+
+      # Get the hyped tracks chart
+      #
+      # @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=494
+      def get_hyped_tracks( params )
+        LastFM.get( "chart.getHypedTracks", params )
+      end
+
+      # Get the most loved tracks chart
+      #
+      # @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=495
+      def get_loved_tracks( params )
+        LastFM.get( "chart.getLovedTracks", params )
+      end
+
+      # Get the top artists chart
+      #
+      # @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=496
+      def get_top_artists( params )
+        LastFM.get( "chart.getTopArtists", params )
+      end
+
+      # Get the top tags chart
+      #
+      # @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=497
+      def get_top_tags( params )
+        LastFM.get( "chart.getTopTags", params )
+      end
+
+      # Get the top tracks chart
+      #
+      # @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=498
+      def get_top_tracks( params )
+        LastFM.get( "chart.getTopTracks", params )
+      end
+
+    end
+  end
+end

data/lib/lastfm/event.rb

@@ -1,62 +1,128 @@
-module LastFM
-
-  # @attr [Fixnum] id
-  # @attr [String] title
-  # @attr [String] headliner
-  # @attr [Array<String>] artists
-  # @attr [LastFM::Venue] venue
-  # @attr [Time] start_date
-  # @attr [String] description
-  # @attr [Hash] images
-  # @attr [Fixnum] attendance
-  # @attr [Fixnum] reviews
-  # @attr [String] tag
-  # @attr [String] url  Last.fm url for the event
-  # @attr [String] website  Event website (different from Last.fm url)
-  # @attr [Boolean] cancelled
-  # @attr [Array<String>] tags
-  class Event < Struct.new(:id, :title, :headliner, :artists, :venue, :start_date, :description, :images, :attendance, :reviews, :tag, :url, :website, :cancelled, :tags)
-
-    def update_from_node(node)
-      case node.name.to_sym
-        when :id
-          self.id = node.content.to_i
-        when :title
-          self.title = node.content
-        when :artists # nested artists and headliner
-          node.find('*').each{|child| self.update_from_node(child)}
-        when :artist
-          self.artists ||= []
-          self.artists << node.content
-        when :headliner
-          self.headliner = node.content
-        when :venue
-          self.venue = LastFM::Venue.from_xml( node )
-        when :startDate
-          self.start_date = Time.parse(node.content) rescue nil
-        when :description
-          self.description = node.content
-        when :image
-          self.images ||= {}
-          self.images.merge!({node['size'].to_sym => node.content})
-        when :attendance
-          self.attendance = node.content.to_i
-        when :reviews
-          self.reviews = node.content.to_i
-        when :tag
-          self.tag = node.content
-        when :url
-          self.url = node.content
-        when :website
-          self.website = node.content
-        when :tickets
-          # ???
-        when :cancelled
-          self.cancelled = (node.content == '1')
-        when :tags
-          self.tags = node.find('*').each{|tag| tag.content}
-      end
-    end
-
-  end
-end
+module LastFM
+
+  # @attr [Fixnum] id
+  # @attr [String] title
+  # @attr [String] headliner
+  # @attr [Array<String>] artists
+  # @attr [LastFM::Venue] venue
+  # @attr [Time] start_date
+  # @attr [String] description
+  # @attr [Hash] images
+  # @attr [Fixnum] attendance
+  # @attr [Fixnum] reviews
+  # @attr [String] tag
+  # @attr [String] url  Last.fm url for the event
+  # @attr [String] website  Event website (different from Last.fm url)
+  # @attr [Boolean] cancelled
+  # @attr [Array<String>] tags
+  class Event < Struct.new(:id, :title, :headliner, :artists, :venue, :start_date, :description, :images, :attendance, :reviews, :tag, :url, :website, :cancelled, :tags)
+
+    def update_from_node(node)
+      case node.name.to_sym
+        when :id
+          self.id = node.content.to_i
+        when :title
+          self.title = node.content
+        when :artists # nested artists and headliner
+          node.find('*').each{|child| self.update_from_node(child)}
+        when :artist
+          self.artists ||= []
+          self.artists << node.content
+        when :headliner
+          self.headliner = node.content
+        when :venue
+          self.venue = LastFM::Venue.from_xml( node )
+        when :startDate
+          self.start_date = Time.parse(node.content) rescue nil
+        when :description
+          self.description = node.content
+        when :image
+          self.images ||= {}
+          self.images.merge!({node['size'].to_sym => node.content})
+        when :attendance
+          self.attendance = node.content.to_i
+        when :reviews
+          self.reviews = node.content.to_i
+        when :tag
+          self.tag = node.content
+        when :url
+          self.url = node.content
+        when :website
+          self.website = node.content
+        when :tickets
+          # ???
+        when :cancelled
+          self.cancelled = (node.content == '1')
+        when :tags
+          self.tags = node.find('*').each{|tag| tag.content}
+      end
+    end
+
+    # API Methods
+    class << self
+
+      # Set a user's attendance status for an event.
+      #
+      # @option params [Fixnum, required] :event    numeric last.fm event id
+      # @option params [Symbol, required] :status   attendance status. accepted values are :attending, :maybe_attending, and :not_attending
+      # @see http://www.last.fm/api/show?service=307
+      def attend( params )
+        LastFM.requires_authentication
+        status_codes = { attending: 0, maybe_attending: 1, not_attending: 2 }
+        params[:status] = status_codes[params[:status]] if params.include?(:status)
+        LastFM.post( "event.attend", params )
+      end
+
+      # Get a list of attendees for an event.
+      #
+      # @option params [Fixnum, required] :event    numeric last.fm event id
+      # @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=391
+      def get_attendees( params )
+        LastFM.get( "event.getAttendees", params )
+      end
+
+      # Get the metadata for an event on Last.fm. Includes attendance and lineup information.
+      #
+      # @option params [Fixnum, required] :event    numeric last.fm event id
+      # @see http://www.last.fm/api/show?service=292
+      def get_info( params )
+        LastFM.get( "event.getInfo", params )
+      end
+
+      # Get shouts for an event.
+      #
+      # @option params [Fixnum, required] :event    numeric last.fm event id
+      # @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=399
+      def get_shouts( params )
+        LastFM.get( "event.getShouts", params )
+      end
+
+      # Share an event with one or more Last.fm users or other friends.
+      #
+      # @option params [Fixnum,  required] :event       numeric last.fm event id
+      # @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=350
+      def share( params )
+        LastFM.requires_authentication
+        LastFM.post( "event.share", params )
+      end
+
+      # Shout in an event's shoutbox.
+      #
+      # @option params [Fixnum, required] :event      numeric last.fm event id
+      # @option params [String, required] :message    message to post to the shoutbox
+      # @see http://www.last.fm/api/show?service=409
+      def shout( params )
+        LastFM.requires_authentication
+        LastFM.post( "event.shout", params )
+      end
+
+    end
+  end
+end

data/lib/lastfm/geo.rb

@@ -0,0 +1,123 @@
+module LastFM
+  class Geo
+    class << self
+
+      # Get all events in a specific location by country or city name.
+      #
+      # @option params [String, optional] :location   location to retrieve events for
+      # @option params [String, optional] :lat        latitude value to retrieve events for
+      # @option params [String, optional] :long       longitude value to retrieve events for
+      # @option params [Fixnum, optional] :distance   find events within a specified radius (in kilometres)
+      # @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=270
+      def get_events( params )
+        LastFM.get( "geo.getEvents", !:secure, params )
+      end
+
+      # Get a chart of artists for a metro.
+      #
+      # @option params [String, required] :country    a country name, as defined by ISO 3166-1
+      # @option params [String, required] :metro      the metro's name
+      # @option params [Time,   optional] :start      beginning timestamp of the weekly range requested (see: Geo.get_weekly_chart_list)
+      # @option params [Time,   optional] :end        ending timestamp of the weekly range requested (see: Geo.get_weekly_chart_list)
+      # @see http://www.last.fm/api/show?service=421
+      def get_metro_artist_chart( params )
+        LastFM.get( "geo.getMetroArtistChart", params )
+      end
+
+      # Get a chart of hyped (up and coming) artists for a metro.
+      #
+      # @option params [String, required] :country    a country name, as defined by ISO 3166-1
+      # @option params [String, required] :metro      the metro's name
+      # @option params [Time,   optional] :start      beginning timestamp of the weekly range requested (see: Geo.get_weekly_chart_list)
+      # @option params [Time,   optional] :end        ending timestamp of the weekly range requested (see: Geo.get_weekly_chart_list)
+      # @see http://www.last.fm/api/show?service=420
+      def get_metro_hype_artist_chart( params )
+        LastFM.get( "geo.getMetroHypeArtistChart", params )
+      end
+
+      # Get a chart of hyped (up and coming) tracks for a metro.
+      #
+      # @option params [String, required] :country    a country name, as defined by ISO 3166-1
+      # @option params [String, required] :metro      the metro's name
+      # @option params [Time,   optional] :start      beginning timestamp of the weekly range requested (see: Geo.get_weekly_chart_list)
+      # @option params [Time,   optional] :end        ending timestamp of the weekly range requested (see: Geo.get_weekly_chart_list)
+      # @see http://www.last.fm/api/show?service=422
+      def get_metro_hype_track_chart( params )
+        LastFM.get( "geo.getMetroHypeTrackChart", params )
+      end
+
+      # Get a chart of tracks for a metro.
+      #
+      # @option params [String, required] :country    a country name, as defined by ISO 3166-1
+      # @option params [String, required] :metro      the metro's name
+      # @option params [Time,   optional] :start      beginning timestamp of the weekly range requested (see: Geo.get_weekly_chart_list)
+      # @option params [Time,   optional] :end        ending timestamp of the weekly range requested (see: Geo.get_weekly_chart_list)
+      # @see http://www.last.fm/api/show?service=423
+      def get_metro_track_chart( params )
+        LastFM.get( "geo.getMetroTrackChart", params )
+      end
+
+      # Get a chart of the artists which make that metro unique
+      #
+      # @option params [String, required] :country    a country name, as defined by ISO 3166-1
+      # @option params [String, required] :metro      the metro's name
+      # @option params [Time,   optional] :start      beginning timestamp of the weekly range requested (see: Geo.get_weekly_chart_list)
+      # @option params [Time,   optional] :end        ending timestamp of the weekly range requested (see: Geo.get_weekly_chart_list)
+      # @see http://www.last.fm/api/show?service=424
+      def get_metro_unique_artist_chart( params )
+        LastFM.get( "geo.getMetroUniqueArtistChart", params )
+      end
+
+      # Get a chart of the tracks which make that metro unique
+      #
+      # @option params [String, required] :country    a country name, as defined by ISO 3166-1
+      # @option params [String, required] :metro      the metro's name
+      # @option params [Time,   optional] :start      beginning timestamp of the weekly range requested (see: Geo.get_weekly_chart_list)
+      # @option params [Time,   optional] :end        ending timestamp of the weekly range requested (see: Geo.get_weekly_chart_list)
+      # @see http://www.last.fm/api/show?service=425
+      def get_metro_unique_track_chart( params )
+        LastFM.get( "geo.getMetroUniqueTrackChart", params )
+      end
+
+      # Get a list of available chart periods for this metro, expressed as date ranges which can be sent to the chart services.
+      #
+      # @option params [String, required] :metro    metro name to fetch the charts list for
+      # @see http://www.last.fm/api/show?service=426
+      def get_metro_weekly_chartlist( params )
+        LastFM.get( "geo.getMetroWeeklyChartlist", params )
+      end
+
+      # Get a list of valid countries and metros for use in the other webservices
+      #
+      # @option params [String, optional] :country    restrict results to metros from a particular country, as defined by ISO 3166-1
+      # @see http://www.last.fm/api/show?service=435
+      def get_metros( params )
+        LastFM.get( "geo.getMetros", params )
+      end
+
+      # Get the most popular artists on Last.fm by country
+      #
+      # @option params [String, required] :country    a country name, 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=297
+      def get_top_artists( params )
+        LastFM.get( "geo.getTopArtists", params )
+      end
+
+      # Get the most popular tracks on Last.fm by country
+      #
+      # @option params [String, required] :country    a country name, as defined by ISO 3166-1
+      # @option params [String, optional] :location   location to fetch the charts for
+      # @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=298
+      def get_top_tracks( params )
+        LastFM.get( "geo.getTopTracks", params )
+      end
+
+    end
+  end
+end

data/lib/lastfm/group.rb

@@ -0,0 +1,67 @@
+module LastFM
+  class Group
+    class << self
+
+      # Get the hype list for a group.
+      #
+      # @option params [String, required] :group    the last.fm group name
+      # @see http://www.last.fm/api/show?service=259
+      def get_hype( params )
+        LastFM.get( "group.getHype", params )
+      end
+
+      # Get the list of members for a group.
+      #
+      # @option params [String, required] :group    the last.fm group 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
+      # @see http://www.last.fm/api/show/?service=379
+      def get_members( params )
+        LastFM.get( "group.getMembers", params )
+      end
+
+      # Get an album chart for a group, for a given date range. If no date range
+      # is supplied, return the most recent.
+      #
+      # @option params [String, required] :group    the last.fm group name
+      # @option params [Time,   optional] :from     date at which the chart should start from (see: Group.get_weekly_chart_list)
+      # @option params [Time,   optional] :to       date at which the chart should end on (see: Group.get_weekly_chart_list)
+      # @see http://www.last.fm/api/show/?service=293
+      def get_weekly_album_chart( params )
+        LastFM.get( "group.getWeeklyAlbumChart", params )
+      end
+
+      # Get an artist chart for a group, for a given date range. If no date range
+      # is supplied, return the most recent.
+      #
+      # @option params [String, required] :group    the last.fm group name
+      # @option params [Time,   optional] :from     date at which the chart should start from (see: Group.get_weekly_chart_list)
+      # @option params [Time,   optional] :to       date at which the chart should end on (see: Group.get_weekly_chart_list)
+      # @see http://www.last.fm/api/show/?service=294
+      def get_weekly_artist_chart( params )
+        LastFM.get( "group.getWeeklyArtistChart", params )
+      end
+
+      # Get the list of available charts for a group, expressed as date ranges
+      # which can be sent to the chart services.
+      #
+      # @option params [String, required] :group    the last.fm group name
+      # @see http://www.last.fm/api/show/?service=295
+      def get_weekly_chart_list( params )
+        LastFM.get( "group.getWeeklyChartList", params )
+      end
+
+      # Get a track chart for a group, for a given date range. If no date range
+      # is supplied, return the most recent.
+      #
+      # @option params [String, required] :group    the last.fm group name
+      # @option params [Time,   optional] :from     date at which the chart should start from (see: Group.get_weekly_chart_list)
+      # @option params [Time,   optional] :to       date at which the chart should end on (see: Group.get_weekly_chart_list)
+      # @see http://www.last.fm/api/show/?service=296
+      def get_weekly_track_chart( params )
+        LastFM.get( "group.getWeeklyTrackChart", params )
+      end
+
+    end
+  end
+end

data/lib/lastfm/library.rb

@@ -0,0 +1,115 @@
+module LastFM
+  class Library
+    class << self
+
+      # Add an album or collection of albums to a user's Last.fm library.
+      #
+      # @option params [Array, required] :artists   the artist or collection of artists to add
+      # @option params [Array, required] :albums    the album or collection of albums to add. the indices of the albums that you pass MUST correspond to those of the artists
+      # @see http://www.last.fm/api/show?service=370
+      def add_album( params )
+        LastFM.requires_authentication
+        # convert :artists and :albums to individual artist[i] and album[i]
+        Array(params.delete(:artists)).each_with_index{|val, i| params["artist[#{i}]"] = val}
+        Array(params.delete(:albums)).each_with_index{|val, i| params["album[#{i}]"] = val}
+        LastFM.post( "library.addAlbum", params )
+      end
+
+      # Add an artist or collection of artists to a user's Last.fm library.
+      #
+      # @option params [Array, required] :artists   the artist or collection of artists to add
+      # @see http://www.last.fm/api/show?service=371
+      def add_artist( params )
+        LastFM.requires_authentication
+        Array(params.delete(:artists)).each_with_index{|val, i| params["artist[#{i}]"] = val}
+        LastFM.post( "library.addArtist", params )
+      end
+
+      # Add a track or collection of tracks to a user's Last.fm library.
+      #
+      # @option params [Array, required] :artists   the artist or collection of artists to add
+      # @option params [Array, required] :tracks    the track or collection of tracks to add. the indices of the tracks that you pass MUST correspond to those of the artists
+      # @see http://www.last.fm/api/show?service=372
+      def add_track( params )
+        LastFM.requires_authentication
+        Array(params.delete(:artists)).each_with_index{|val, i| params["artist[#{i}]"] = val}
+        Array(params.delete(:tracks)).each_with_index{|val, i| params["track[#{i}]"] = val}
+        LastFM.post( "library.addTrack", params )
+      end
+
+      # A paginated list of all the albums in a user's library, with play counts and tag counts.
+      #
+      # @option params [String, requried] :user     the user whose library you want to fetch
+      # @option params [String, optional] :artist   an artist by which to filter albums
+      # @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=321
+      def get_albums( params )
+        LastFM.get( "library.getAlbums", params )
+      end
+
+      # A paginated list of all the artists in a user's library, with play counts and tag counts.
+      #
+      # @option params [String, requried] :user     the user whose library you want to fetch
+      # @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=322
+      def get_artists( params )
+         LastFM.get( "library.getArtists", params )
+      end
+
+      # A paginated list of all the tracks in a user's library, with play counts and tag counts.
+      #
+      # @option params [String, requried] :user     the user whose library you want to fetch
+      # @option params [String, optional] :artist   an artist by which to filter track
+      # @option params [String, optional] :album    an album by which to filter tracks (requires an associated 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=323
+      def get_tracks( params )
+        LastFM.get( "library.getTracks", params )
+      end
+
+      # Remove an album from a user's Last.fm library.
+      #
+      # @option params [String, required] :artist   the artist that composed the album
+      # @option params [String, required] :album    the name of the album to remove
+      # @see http://www.last.fm/api/show?service=523
+      def remove_album( params )
+        LastFM.requires_authentication
+        LastFM.post( "library.removeAlbum", params )
+      end
+
+      # Remove an artist from a user's Last.fm library.
+      #
+      # @option params [String, required] :artist   the name of the artist to remove
+      # @see http://www.last.fm/api/show?service=524
+      def remove_artist( params )
+        LastFM.requires_authentication
+        LastFM.post( "library.removeArtist", params )
+      end
+
+      # Remove a scrobble from a user's Last.fm library.
+      #
+      # @option params [String, required] :artist       the artist that composed the album
+      # @option params [String, required] :track        the name of the track to remove
+      # @option params [Time,   required] :timestamp    the unix timestamp of the scrobble to remove
+      # @see http://www.last.fm/api/show?service=525
+      def remove_scrobble( params )
+        LastFM.requires_authentication
+        LastFM.post( "library.removeScrobble", params )
+      end
+
+      # Remove a track from a user's Last.fm library.
+      #
+      # @option params [String, required] :artist   the artist that composed the track
+      # @option params [String, required] :track    the name of the track to remove
+      # @see http://www.last.fm/api/show?service=526
+      def remove_track( params )
+        LastFM.requires_authentication
+        LastFM.post( "library.removeTrack", params )
+      end
+
+    end
+  end
+end

data/lib/lastfm/playlist.rb

@@ -0,0 +1,38 @@
+module LastFM
+  class Playlist
+    class << self
+
+      # Add a track to a Last.fm user's playlist
+      #
+      # @option params [String, required] :playlist_id    the id of the playlist (see: User.get_playlists)
+      # @option params [String, required] :track          the track name to add to the playlist
+      # @option params [String, required] :artist         the artist that corresponds to the track to be added
+      # @see http://www.last.fm/api/show?service=337
+      def add_track( params )
+        LastFM.requires_authentication
+        LastFM.post( "playlist.addTrack", params )
+      end
+
+      # Create a Last.fm playlist on behalf of a user.
+      #
+      # @option params [String, optional] :title          title for the playlist
+      # @option params [String, optional] :description    description for the playlist
+      # @see http://www.last.fm/api/show?service=365
+      def create( params )
+        LastFM.requires_authentication
+        LastFM.post( "playlist.create", params )
+      end
+
+      # Fetch XSPF playlists using a lastfm playlist url.
+      #
+      # @option params [String,  required] :playlist_url    lastfm protocol playlist url (lastfm://playlist/...)
+      # @option params [Boolean, optional] :steaming        whether to return mp3 links for song previews
+      # @see http://www.last.fm/api/show?service=271
+      # @deprecated documentation removed from last.fm/api, but method calls still work
+      def fetch( params )
+        LastFM.get( "playlist.fetch", params )
+      end
+
+    end
+  end
+end