liblastfm 0.0.3.2 → 0.0.3.3

raw patch · 15 files changed

+528/−1 lines, 15 files

Files

• docs/album.docs +37/−0
• docs/artist.docs +73/−0
• docs/chart.docs +25/−0
• docs/event.docs +25/−0
• docs/geo.docs +45/−0
• docs/group.docs +25/−0
• docs/library.docs +41/−0
• docs/playlist.docs +9/−0
• docs/radio.docs +13/−0
• docs/tag.docs +37/−0
• docs/tasteometer.docs +5/−0
• docs/track.docs +77/−0
• docs/user.docs +101/−0
• docs/venue.docs +13/−0
• liblastfm.cabal +2/−1

@@ -0,0 +1,37 @@+/* THIS FILE IS NOT INTENDED FOR USER READING. USE HADDOCK DOCUMENTATION INSTEAD. */++#define __addTags__ \+-- | Tag an album using a list of user supplied tags. \+More: <http://www.last.fm/api/show/album.addTags>++#define __getBuyLinks__ \+-- | Get a list of Buy Links for a particular Album. It is required that you supply either the artist and track params or the mbid param. \+More: <http://www.last.fm/api/show/album.getBuylinks>++#define __getInfo__ \+-- | Get the metadata for an album on Last.fm using the album name or a musicbrainz id. See playlist.fetch on how to get the album playlist. \+More: <http://www.last.fm/api/show/album.getInfo>++#define __getShouts__ \+-- | Get shouts for this album. \+More: <http://www.last.fm/api/show/album.getShouts>++#define __getTags__ \+-- | Get the tags applied by an individual user to an album on Last.fm. \+More: <http://www.last.fm/api/show/album.getTags>++#define __getTopTags__ \+-- | Get the top tags for an album on Last.fm, ordered by popularity. \+More: <http://www.last.fm/api/show/album.getTopTags>++#define __removeTag__ \+-- | Remove a user's tag from an album. \+More: <http://www.last.fm/api/show/album.removeTag>++#define __search__ \+-- | Search for an album by name. Returns album matches sorted by relevance. \+More: <http://www.last.fm/api/show/album.search>++#define __share__ \+-- | Share an album with one or more Last.fm users or other friends. \+More: <http://www.last.fm/api/show/album.share>

@@ -0,0 +1,73 @@+/* THIS FILE IS NOT INTENDED FOR USER READING. USE HADDOCK DOCUMENTATION INSTEAD. */++#define __addTags__ \+-- | Tag an album using a list of user supplied tags. \+More: <http://www.last.fm/api/show/artist.addTags>++#define __getCorrection__ \+-- | Use the last.fm corrections data to check whether the supplied artist has a correction to a canonical artist \+More: <http://www.last.fm/api/show/artist.getCorrection>++#define __getEvents__ \+-- | Get a list of upcoming events for this artist. \+More: <http://www.last.fm/api/show/artist.getEvents>++#define __getImages__ \+-- | Get Images for this artist in a variety of sizes. \+More: <http://www.last.fm/api/show/artist.getImages>++#define __getInfo__ \+-- | Get the metadata for an artist. Includes biography. \+More: <http://www.last.fm/api/show/artist.getInfo>++#define __getPastEvents__ \+-- | Get a paginated list of all the events this artist has played at in the past. \+More: <http://www.last.fm/api/show/artist.getPastEvents>++#define __getPodcast__ \+-- | Get a podcast of free mp3s based on an artist. \+More: <http://www.last.fm/api/show/artist.getPodcast>++#define __getShouts__ \+-- | Get shouts for this artist. Also available as an rss feed. \+More: <http://www.last.fm/api/show/artist.getShouts>++#define __getSimilar__ \+-- | Get all the artists similar to this artist. \+More: <http://www.last.fm/api/show/artist.getSimilar>++#define __getTags__ \+-- | 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. \+More: <http://www.last.fm/api/show/artist.getTags>++#define __getTopAlbums__ \+-- | Get the top albums for an artist on Last.fm, ordered by popularity. \+More: <http://www.last.fm/api/show/artist.getTopAlbums>++#define __getTopFans__ \+-- | Get the top fans for an artist on Last.fm, based on listening data. \+More: <http://www.last.fm/api/show/artist.getTopFans>++#define __getTopTags__ \+-- | Get the top tags for an artist on Last.fm, ordered by popularity. \+More: <http://www.last.fm/api/show/artist.getTopTags>++#define __getTopTracks__ \+-- | Get the top tracks by an artist on Last.fm, ordered by popularity. \+More: <http://www.last.fm/api/show/artist.getTopTracks>++#define __removeTag__ \+-- | Remove a user's tag from an artist. \+More: <http://www.last.fm/api/show/artist.removeTag>++#define __search__ \+-- | Search for an artist by name. Returns artist matches sorted by relevance. \+More: <http://www.last.fm/api/show/artist.search>++#define __share__ \+-- | Share an artist with Last.fm users or other friends. \+More: <http://www.last.fm/api/show/artist.share>++#define __shout__ \+-- | Shout in this artist's shoutbox. \+More: <http://www.last.fm/api/show/artist.shout>

@@ -0,0 +1,25 @@+/* THIS FILE IS NOT INTENDED FOR USER READING. USE HADDOCK DOCUMENTATION INSTEAD. */++#define __getHypedArtists__ \+-- | Get the hyped artists chart. \+More: <http://www.last.fm/api/show/chart.getHypedArtists>++#define __getHypedTracks__ \+-- | Get the hyped tracks chart. \+More: <http://www.last.fm/api/show/chart.getHypedTracks>++#define __getLovedTracks__ \+-- | Get the most loved tracks chart. \+More: <http://www.last.fm/api/show/chart.getLovedTracks>++#define __getTopArtists__ \+-- | Get the top artists chart. \+More: <http://www.last.fm/api/show/chart.getTopArtists>++#define __getTopTags__ \+-- | Get top tags chart. \+More: <http://www.last.fm/api/show/chart.getTopTags>++#define __getTopTracks__ \+-- | Get the top tracks chart. \+More: <http://www.last.fm/api/show/chart.getTopTracks>

@@ -0,0 +1,25 @@+/* THIS FILE IS NOT INTENDED FOR USER READING. USE HADDOCK DOCUMENTATION INSTEAD. */++#define __attend__ \+-- | Set a user's attendance status for an event. \+More: <http://www.last.fm/api/show/event.attend>++#define __getAttendees__ \+-- | Get a list of attendees for an event. \+More: <http://www.last.fm/api/show/event.getAttendees>++#define __getInfo__ \+-- | Get the metadata for an event on Last.fm. Includes attendance and lineup information. \+More: <http://www.last.fm/api/show/event.getInfo>++#define __getShouts__ \+-- | Get shouts for this event. \+More: <http://www.last.fm/api/show/event.getShouts>++#define __share__ \+-- | Share an event with one or more Last.fm users or other friends. \+More: <http://www.last.fm/api/show/event.share>++#define __shout__ \+-- | Shout in this event's shoutbox. \+More: <http://www.last.fm/api/show/event.shout>

@@ -0,0 +1,45 @@+/* THIS FILE IS NOT INTENDED FOR USER READING. USE HADDOCK DOCUMENTATION INSTEAD. */++#define __getEvents__ \+-- | Get all events in a specific location by country or city name. \+More: <http://www.last.fm/api/show/geo.getEvents>++#define __getMetroArtistChart__ \+-- | Get a chart of artists for a metro. \+More: <http://www.last.fm/api/show/geo.getMetroArtistChart>++#define __getMetroHypeArtistChart__ \+-- | Get a chart of hyped (up and coming) artists for a metro. \+More: <http://www.last.fm/api/show/geo.getMetroHypeArtistChart>++#define __getMetroHypeTrackChart__ \+-- | Get a chart of hyped (up and coming) tracks for a metro. \+More: <http://www.last.fm/api/show/geo.getMetroHypeTrackChart>++#define __getMetroTrackChart__ \+-- | Get a chart of tracks for a metro. \+More: <http://www.last.fm/api/show/geo.getMetroTrackChart>++#define __getMetroUniqueArtistChart__ \+-- | Get a chart of the artists which make that metro unique. \+More: <http://www.last.fm/api/show/geo.getMetroUniqueArtistChart>++#define __getMetroUniqueTrackChart__ \+-- | Get a chart of the tracks which make that metro unique. \+More: <http://www.last.fm/api/show/geo.getMetroUniqueTrackChart>++#define __getMetroWeeklyChartlist__ \+-- | Get a list of available chart periods for this metro, expressed as date ranges which can be sent to the chart services. \+More: <http://www.last.fm/api/show/geo.getMetroWeeklyChartlist>++#define __getMetros__ \+-- | Get a list of valid countries and metros for use in the other webservices. \+More: <http://www.last.fm/api/show/geo.getMetros>++#define __getTopArtists__ \+-- | Get the most popular artists on Last.fm by country. \+More: <http://www.last.fm/api/show/geo.getTopArtists>++#define __getTopTracks__ \+-- | Get the most popular tracks on Last.fm last week by country. \+More: <http://www.last.fm/api/show/geo.getTopTracks>

@@ -0,0 +1,25 @@+/* THIS FILE IS NOT INTENDED FOR USER READING. USE HADDOCK DOCUMENTATION INSTEAD. */++#define __getHype__ \+-- | Get the hype list for a group. \+More: <http://www.last.fm/api/show/group.getHype>++#define __getMembers__ \+-- | Get a list of members for this group. \+More: <http://www.last.fm/api/show/group.getMembers>++#define __getWeeklyAlbumChart__ \+-- | Get an album chart for a group, for a given date range. If no date range is supplied, it will return the most recent album chart for this group. \+More: <http://www.last.fm/api/show/group.getWeeklyAlbumChart>++#define __getWeeklyArtistChart__ \+-- | Get an artist chart for a group, for a given date range. If no date range is supplied, it will return the most recent artist chart for this group. \+More: <http://www.last.fm/api/show/group.getWeeklyArtistChart>++#define __getWeeklyChartList__ \+-- | Get a list of available charts for this group, expressed as date ranges which can be sent to the chart services. \+More: <http://www.last.fm/api/show/group.getWeeklyChartList>++#define __getWeeklyTrackChart__ \+-- | Get a track chart for a group, for a given date range. If no date range is supplied, it will return the most recent track chart for this group. \+More: <http://www.last.fm/api/show/group.getWeeklyTrackChart>

@@ -0,0 +1,41 @@+/* THIS FILE IS NOT INTENDED FOR USER READING. USE HADDOCK DOCUMENTATION INSTEAD. */++#define __addAlbum__ \+-- | Add an album or collection of albums to a user's Last.fm library. \+More: <http://www.last.fm/api/show/library.addAlbum>++#define __addArtist__ \+-- | Add an artist to a user's Last.fm library. \+More: <http://www.last.fm/api/show/library.addArtist>++#define __addTrack__ \+-- | Add a track to a user's Last.fm library. \+More: <http://www.last.fm/api/show/library.addTrack>++#define __getAlbums__ \+-- | A paginated list of all the albums in a user's library, with play counts and tag counts. \+More: <http://www.last.fm/api/show/library.getAlbums>++#define __getArtists__ \+-- | A paginated list of all the artists in a user's library, with play counts and tag counts. \+More: <http://www.last.fm/api/show/library.getArtists>++#define __getTracks__ \+-- | A paginated list of all the tracks in a user's library, with play counts and tag counts. \+More: <http://www.last.fm/api/show/library.getTracks>++#define __removeAlbum__ \+-- | Remove an album from a user's Last.fm library. \+More: <http://www.last.fm/api/show/library.removeAlbum>++#define __removeArtist__ \+-- | Remove an artist from a user's Last.fm library. \+More: <http://www.last.fm/api/show/library.removeArtist>++#define __removeScrobble__ \+-- | Remove a scrobble from a user's Last.fm library. \+More: <http://www.last.fm/api/show/library.removeScrobble>++#define __removeTrack__ \+-- | Remove a track from a user's Last.fm library. \+More: <http://www.last.fm/api/show/library.removeTrack>

@@ -0,0 +1,9 @@+/* THIS FILE IS NOT INTENDED FOR USER READING. USE HADDOCK DOCUMENTATION INSTEAD. */++#define __addTrack__ \+-- | Add a track to a Last.fm user's playlist. \+More: <http://www.last.fm/api/show/playlist.addTrack>++#define __create__ \+-- | Create a Last.fm playlist on behalf of a user. \+More: <http://www.last.fm/api/show/playlist.create>

@@ -0,0 +1,13 @@+/* THIS FILE IS NOT INTENDED FOR USER READING. USE HADDOCK DOCUMENTATION INSTEAD. */++#define __getPlaylist__ \+-- | Fetch new radio content periodically in an XSPF format. \+More: <http://www.last.fm/api/show/radio.getPlaylist>++#define __search__ \+-- | Resolve the name of a resource into a station depending on which resource it is most likely to represent. \+More: <http://www.last.fm/api/show/radio.search>++#define __tune__ \+-- | Tune in to a Last.fm radio station. \+More: <http://www.last.fm/api/show/radio.tune>

@@ -0,0 +1,37 @@+/* THIS FILE IS NOT INTENDED FOR USER READING. USE HADDOCK DOCUMENTATION INSTEAD. */++#define __getInfo__ \+-- | Get the metadata for a tag. \+More: <http://www.last.fm/api/show/tag.getInfo>++#define __getSimilar__ \+-- | Search for tags similar to this one. Returns tags ranked by similarity, based on listening data. \+More: <http://www.last.fm/api/show/tag.getSimilar>++#define __getTopAlbums__ \+-- | Get the top albums tagged by this tag, ordered by tag count. \+More: <http://www.last.fm/api/show/tag.getTopAlbums>++#define __getTopArtists__ \+-- | Get the top artists tagged by this tag, ordered by tag count. \+More: <http://www.last.fm/api/show/tag.getTopArtists>++#define __getTopTags__ \+-- | Fetches the top global tags on Last.fm, sorted by popularity (number of times used). \+More: <http://www.last.fm/api/show/tag.getTopTags>++#define __getTopTracks__ \+-- | Get the top tracks tagged by this tag, ordered by tag count. \+More: <http://www.last.fm/api/show/tag.getTopTracks>++#define __getWeeklyArtistChart__ \+-- | 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. \+More: <http://www.last.fm/api/show/tag.getWeeklyArtistChart>++#define __getWeeklyChartList__ \+-- | Get a list of available charts for this tag, expressed as date ranges which can be sent to the chart services. \+More: <http://www.last.fm/api/show/tag.getWeeklyChartList>++#define __search__ \+-- | Search for a tag by name. Returns matches sorted by relevance. \+More: <http://www.last.fm/api/show/tag.search>

@@ -0,0 +1,5 @@+/* THIS FILE IS NOT INTENDED FOR USER READING. USE HADDOCK DOCUMENTATION INSTEAD. */++#define __compare__ \+-- | 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. \+More: <http://www.last.fm/api/show/tasteometer.compare>

@@ -0,0 +1,77 @@+/* THIS FILE IS NOT INTENDED FOR USER READING. USE HADDOCK DOCUMENTATION INSTEAD. */++#define __addTags__ \+-- | Tag a track using a list of user supplied tags. \+More: <http://www.last.fm/api/show/track.addTags>++#define __ban__ \+-- | Ban a track for a given user profile. \+More: <http://www.last.fm/api/show/track.ban>++#define __getBuyLinks__ \+-- | Get a list of Buy Links for a particular track. \+More: <http://www.last.fm/api/show/track.getBuylinks>++#define __getCorrection__ \+-- | Use the last.fm corrections data to check whether the supplied track has a correction to a canonical track. \+More: <http://www.last.fm/api/show/track.getCorrection>++#define __getFingerprintMetadata__ \+-- | 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. \+More: <http://www.last.fm/api/show/track.getFingerprintMetadata>++#define __getInfo__ \+-- | Get the metadata for a track on Last.fm. \+More: <http://www.last.fm/api/show/track.getInfo>++#define __getShouts__ \+-- | Get shouts for this track. Also available as an rss feed. \+More: <http://www.last.fm/api/show/track.getShouts>++#define __getSimilar__ \+-- | Get the similar tracks for this track on Last.fm, based on listening data. \+More: <http://www.last.fm/api/show/track.getSimilar>++#define __getTags__ \+-- | Get the tags applied by an individual user to a track on Last.fm. \+More: <http://www.last.fm/api/show/track.getTags>++#define __getTopFans__ \+-- | Get the top fans for this track on Last.fm, based on listening data. \+More: <http://www.last.fm/api/show/track.getTopFans>++#define __getTopTags__ \+-- | Get the top tags for this track on Last.fm, ordered by tag count. \+More: <http://www.last.fm/api/show/track.getTopTags>++#define __love__ \+-- | Love a track for a user profile. \+More: <http://www.last.fm/api/show/track.love>++#define __removeTag__ \+-- | Remove a user's tag from a track. \+More: <http://www.last.fm/api/show/track.removeTag>++#define __scrobble__ \+-- | Used to add a track-play to a user's profile. \+More: <http://www.last.fm/api/show/track.scrobble>++#define __search__ \+-- | Search for a track by track name. Returns track matches sorted by relevance. \+More: <http://www.last.fm/api/show/track.search>++#define __share__ \+-- | Share a track twith one or more Last.fm users or other friends. \+More: <http://www.last.fm/api/show/track.share>++#define __unban__ \+-- | Unban a track for a user profile. \+More: <http://www.last.fm/api/show/track.unban>++#define __unlove__ \+-- | Unlove a track for a user profile. \+More: <http://www.last.fm/api/show/track.unlove>++#define __updateNowPlaying__ \+-- | Used to notify Last.fm that a user has started listening to a track. Parameter names are case sensitive. \+More: <http://www.last.fm/api/show/track.updateNowPlaying>

@@ -0,0 +1,101 @@+/* THIS FILE IS NOT INTENDED FOR USER READING. USE HADDOCK DOCUMENTATION INSTEAD. */++#define __getArtistTracks__ \+-- | Get a list of tracks by a given artist scrobbled by this user, including scrobble time. Can be limited to specific timeranges, defaults to all time. \+More: <http://www.last.fm/api/show/user.getArtistTracks>++#define __getBannedTracks__ \+-- | Returns the tracks banned by the user. \+More: <http://www.last.fm/api/show/user.getBannedTracks>++#define __getEvents__ \+-- | Get a list of upcoming events that this user is attending. \+More: <http://www.last.fm/api/show/user.getEvents>++#define __getFriends__ \+-- | Get a list of the user's friends on Last.fm. \+More: <http://www.last.fm/api/show/user.getFriends>++#define __getInfo__ \+-- | Get information about a user profile. \+More: <http://www.last.fm/api/show/user.getInfo>++#define __getLovedTracks__ \+-- | Get tracks loved by a user. \+More: <http://www.last.fm/api/show/user.getLovedTracks>++#define __getNeighbours__ \+-- | Get a list of a user's neighbours on Last.fm. \+More: <http://www.last.fm/api/show/user.getNeighbours>++#define __getNewReleases__ \+-- | Gets a list of forthcoming releases based on a user's musical taste. \+More: <http://www.last.fm/api/show/user.getNewReleases>++#define __getPastEvents__ \+-- | Get a paginated list of all events a user has attended in the past. \+More: <http://www.last.fm/api/show/user.getPastEvents>++#define __getPersonalTags__ \+-- | Get the user's personal tags. \+More: <http://www.last.fm/api/show/user.getPersonalTags>++#define __getPlaylists__ \+-- | Get a list of a user's playlists on Last.fm. \+More: <http://www.last.fm/api/show/user.getPlaylists>++#define __getRecentStations__ \+-- | Get a list of the recent Stations listened to by this user. \+More: <http://www.last.fm/api/show/user.getRecentStations>++#define __getRecentTracks__ \+-- | Get a list of the recent tracks listened to by this user. Also includes the currently playing track with the nowplaying="true" attribute if the user is currently listening. \+More: <http://www.last.fm/api/show/user.getRecentTracks>++#define __getRecommendedArtists__ \+-- | Get Last.fm artist recommendations for a user. \+More: <http://www.last.fm/api/show/user.getRecommendedArtists>++#define __getRecommendedEvents__ \+-- | Get a paginated list of all events recommended to a user by Last.fm, based on their listening profile. \+More: <http://www.last.fm/api/show/user.getRecommendedEvents>++#define __getShouts__ \+-- | Get shouts for this user. Also available as an rss feed. \+More: <http://www.last.fm/api/show/user.getShouts>++#define __getTopAlbums__ \+-- | Get the top albums listened to by a user. You can stipulate a time period. Sends the overall chart by default. \+More: <http://www.last.fm/api/show/user.getTopAlbums>++#define __getTopArtists__ \+-- | Get the top artists listened to by a user. You can stipulate a time period. Sends the overall chart by default. \+More: <http://www.last.fm/api/show/user.getTopArtists>++#define __getTopTags__ \+-- | Get the top tags used by this user. \+More: <http://www.last.fm/api/show/user.getTopTags>++#define __getTopTracks__ \+-- | Get the top tracks listened to by a user. You can stipulate a time period. Sends the overall chart by default. \+More: <http://www.last.fm/api/show/user.getTopTracks>++#define __getWeeklyAlbumChart__ \+-- | Get an album chart for a user profile, for a given date range. If no date range is supplied, it will return the most recent album chart for this user. \+More: <http://www.last.fm/api/show/user.getWeeklyAlbumChart>++#define __getWeeklyArtistChart__ \+-- | Get an artist chart for a user profile, for a given date range. If no date range is supplied, it will return the most recent artist chart for this user. \+More: <http://www.last.fm/api/show/user.getWeeklyArtistChart>++#define __getWeeklyChartList__ \+-- | Get a list of available charts for this user, expressed as date ranges which can be sent to the chart services. \+More: <http://www.last.fm/api/show/user.getWeeklyChartList>++#define __getWeeklyTrackChart__ \+-- | Get a track chart for a user profile, for a given date range. If no date range is supplied, it will return the most recent track chart for this user. \+More: <http://www.last.fm/api/show/user.getWeeklyTrackChart>++#define __shout__ \+-- | Shout on this user's shoutbox. \+More: <http://www.last.fm/api/show/user.shout>

@@ -0,0 +1,13 @@+/* THIS FILE IS NOT INTENDED FOR USER READING. USE HADDOCK DOCUMENTATION INSTEAD. */++#define __getEvents__ \+-- | Get a list of upcoming events at this venue. \+More: <http://www.last.fm/api/show/venue.getEvents>++#define __getPastEvents__ \+-- | Get a paginated list of all the events held at this venue in the past. \+More: <http://www.last.fm/api/show/venue.getPastEvents>++#define __search__ \+-- | Search for a venue by venue name. \+More: <http://www.last.fm/api/show/venue.search>

@@ -1,5 +1,5 @@ Name: liblastfm-Version: 0.0.3.2+Version: 0.0.3.3 Synopsis: Wrapper to Lastfm API License: MIT License-file: LICENSE@@ -9,6 +9,7 @@ Description: Simple but complete wrapper to Lastfm API. Can send some stuff and receive reponses from Lastfm. JSON/XML parsing is an exercise for the user. Cabal-Version: >= 1.6 Build-Type: Simple+Extra-Source-Files: docs/*.docs  Library   Build-Depends: base >= 3 && < 5, template-haskell >= 2.5 && < 2.8, bytestring == 0.9.*, mtl == 2.*, curl == 1.3.7, pureMD5 == 2.1.*, urlencoded == 0.3.*, aeson == 0.6.*, xml == 1.3.12, utf8-string == 0.3.*