rscrobbler 0.1.0 → 0.2.0

data/lib/lastfm/api/event.rb

@@ -0,0 +1,71 @@
+module LastFM
+  module Api
+    class Event
+      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
+end

data/lib/lastfm/api/geo.rb

@@ -0,0 +1,125 @@
+module LastFM
+  module Api
+    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
+end

data/lib/lastfm/api/group.rb

@@ -0,0 +1,69 @@
+module LastFM
+  module Api
+    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
+end

data/lib/lastfm/api/library.rb

@@ -0,0 +1,117 @@
+module LastFM
+  module Api
+    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 
+end

data/lib/lastfm/api/playlist.rb

@@ -0,0 +1,40 @@
+module LastFM
+  module Api
+    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 
+end

data/lib/lastfm/api/radio.rb

@@ -0,0 +1,41 @@
+module LastFM
+  module Api
+    class Radio
+      class << self
+
+        # Fetch new radio content periodically in an XSPF format.
+        #
+        # @option params [Boolean, optional] :discovery           whether to request last.fm content in discovery mode
+        # @option params [Boolean, optional] :rtp                 whether the user is scrobbling or not during this session (helps content generation)
+        # @option params [Boolean, optional] :buylinks            whether the response should contain links for purchase/download
+        # @option params [String,  optional] :speed_multiplier    the rate at which to provide the stream (supported multipliers are 1.0 and 2.0)
+        # @option params [String,  optional] :bitrate             what bitrate to stream content at, in kbps (supported bitrates are 64 and 128)
+        # @see http://www.last.fm/api/show?service=256
+        def get_playlist( params )
+          LastFM.requires_authentication
+          LastFM.get( "radio.getPlaylist", params, :secure )
+        end
+
+        # Resolve the name of a resource into a station depending
+        # on which resource it is most likely to represent.
+        #
+        # @option params [String, required] :name   the tag or artist name to resolve
+        # @see http://www.last.fm/api/show?service=418
+        def search( params )
+          LastFM.get( "radio.search", params )
+        end
+
+        # Tune in to a Last.fm radio station.
+        #
+        # @option params [String, required] :station    a 'lastfm://...' radio url
+        # @option params [String, optional] :lang       the language to return the station name in, expressed as an ISO 639 alpha-2 code
+        # @see http://www.last.fm/api/show?service=160
+        def tune( params )
+          LastFM.requires_authentication
+          LastFM.post( "radio.tune", params )
+        end
+
+      end
+    end
+  end 
+end

data/lib/lastfm/api/tag.rb

@@ -0,0 +1,120 @@
+module LastFM
+  module Api
+    class Tag
+      class << self
+
+        # Get the metadata for a tag.
+        #
+        # @option params [String, required] :tag    the tag name
+        # @option params [String, optional] :lang   the language to return the summary in, expressed as an ISO 639 alpha-2 code
+        # @return [LastFM::Tag] tag constructed from the metadata contained in the response
+        # @see http://www.last.fm/api/show?service=452
+        def get_info( params )
+          xml = LastFM.get( "tag.getInfo", params )
+          LastFM::Tag.from_xml( xml )
+        end
+
+        # Search for tags similar to this one. Returns tags ranked by similarity, based on listening data.
+        #
+        # @option params [String, required] tag   the tag name
+        # @return [Array<LastFM::Tag>] similar tags, ordered by similarity
+        # @see http://www.last.fm/api/show?service=311
+        def get_similar( params )
+          xml = LastFM.get( "tag.getSimilar", params )
+          xml.find('similartags/tag').map do |tag|
+            LastFM::Tag.from_xml( tag )
+          end
+        end
+
+        # Get the top albums tagged with a tag, ordered by tag count.
+        #
+        # @option params [String, required] :tag      the tag 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, ordered by tag count
+        # @see http://www.last.fm/api/show?service=283
+        def get_top_albums( params )
+          xml = LastFM.get( "tag.getTopAlbums", params )
+          xml.find('topalbums/album').map do |album|
+            LastFM::Album.from_xml( album )
+          end
+        end
+
+        # Get the top artists tagged with a tag, ordered by tag count.
+        #
+        # @option params [String, required] :tag      the tag 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::Artist]] list of artists, ordered by tag count
+        # @see http://www.last.fm/api/show?service=284
+        def get_top_artists( params )
+          xml = LastFM.get( "tag.getTopArtists", params )
+          xml.find('topartists/artist').map do |artist|
+            LastFM::Artist.from_xml( artist )
+          end
+        end
+
+        # Fetches the top global tags on Last.fm, sorted by popularity (number of times used).
+        #
+        # @return [Array<LastFM::Tag>] list of tags ordered by popularity
+        # @see http://www.last.fm/api/show?service=276
+        def get_top_tags
+          xml = LastFM.get( "tag.getTopTags" )
+          xml.find('toptags/tag').map do |tag|
+            LastFM::Tag.from_xml( tag )
+          end
+        end
+
+        # Get the top tracks tagged with a tag, ordered by tag count.
+        #
+        # @option params [String, required] :tag      the tag 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::Track]] list of tracks, ordered by tag count
+        # @see http://www.last.fm/api/show?service=285
+        def get_top_tracks( params )
+          xml = LastFM.get( "tag.getTopTracks", params )
+          xml.find('toptracks/track').map do |track|
+            LastFM::Track.from_xml( track )
+          end
+        end
+
+        # Get an artist chart for a tag, for a given date range. If no date range is
+        # supplied, it will return the most recent artist chart for this tag.
+        #
+        # @option params [String, required] :tag      the tag name
+        # @option params [String, optional] :from     date at which the chart should start from (see: Tag.get_weekly_chart_list)
+        # @option params [String, optional] :to       date at which the chart should end on (see: Tag.get_weekly_chart_list)
+        # @option params [Fixnum, optional] :limit    the number of results to fetch. defaults to 50
+        # @see http://www.last.fm/api/show?service=358
+        def get_weekly_artist_chart( params )
+          LastFM.get( "tag.getWeeklyArtistChart", params )
+        end
+
+        # Get a list of available charts for this tag, expressed as date
+        # ranges which can be sent to the chart services.
+        #
+        # @option params [String, required] :tag    the tag name
+        # @see http://www.last.fm/api/show?service=359
+        def get_weekly_chart_list( params )
+          LastFM.get( "tag.getWeeklyChartList", params )
+        end
+
+        # Search for a tag by name. Returns matches sorted by relevance.
+        #
+        # @option params [String, required] :tag      the tag 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::Tag>] list of tags sorted by relevance
+        # @see http://www.last.fm/api/show?service=273
+        def search( params )
+          xml = LastFM.get( "tag.search", params )
+          xml.find('results/tagmatches/tag').map do |tag|
+            LastFM::Tag.from_xml( tag )
+          end
+        end
+
+      end
+    end
+  end 
+end

data/lib/lastfm/api/tasteometer.rb

@@ -0,0 +1,37 @@
+module LastFM
+  module Api
+    class Tasteometer
+      class << self
+
+        # Get a Tasteometer score from two inputs, along with a list of shared
+        # artists. If the input is a User some additional information is returned.
+        #
+        # @option params [Array,  required] :types    two types are required for comparison. accepted types are 'user' and 'artists'
+        # @option params [Array,  required] :values   values for the corresponding types. accepted values are Last.fm usernames, or arrays of artist names (up to 100 artists)
+        # @option params [Fixnum, optional] :limit    how many shared artists to display. default is 5
+        # @see http://www.last.fm/api/show?service=258
+        def compare( params )
+          Array(params.delete(:types)).each_with_index{|val, i| params["type[#{i}]"] = val}
+          Array(params.delete(:values)).each_with_index{|val, i| params["value[#{i}]"] = val}
+          LastFM.get( "tasteometer.compare", params )
+        end
+
+        # Get the scores between every user in a group of users, plus shared artists.
+        # Cuts off any similarities below a cutoff. Also returns a list of all users
+        # in the comparison and a small amount of metadata about each. Can take the
+        # list of users from a group, or a users friends.
+        #
+        # @option params [String, required] :source             what source we're using for the comparison. accepted sources are 'user' and 'group'
+        # @option params [String, required] :value              name of the source we're using. should be either a Last.fm username or group name
+        # @option params [Float,  optional] :cutoff             the minimum level over which comparisons should be returned. default is 0.2
+        # @option params [Fixnum, optional] :connection_limit   the maximum number of connections each user should have. default is 6
+        # @see http://www.last.fm/api/show?service=500
+        # @deprecated This service has been deprecated and is no longer available
+        def compare_group(params)
+          LastFM.get( "tasteometer.compareGroup", params )
+        end
+
+      end
+    end
+  end 
+end