-- Hoogle documentation, generated by Haddock
-- See Hoogle, http://www.haskell.org/hoogle/


-- | Lastfm API interface
--   
--   Provides interface to Lastfm REST API, supports XML and JSON formats.
@package liblastfm
@version 0.7.0


-- | liblastfm internals
--   
--   You shouldn't need to import this module unless you are doing
--   something interesting.
module Lastfm.Internal

-- | Lastfm API request data type
--   
--   <tt>a</tt> is the authentication state. Can be <a>Ready</a>, which
--   means this <a>Request</a> is ready to be sent, or <a>Sign</a>, if the
--   request signature hasn't been computed yet
--   
--   <tt>f</tt> is the response format (liblastfm supports both <a>JSON</a>
--   and <a>XML</a>)
newtype Request f a
Request :: Const (Dual (Endo (R f))) a -> Request f a
[unRequest] :: Request f a -> Const (Dual (Endo (R f))) a

-- | Response format: either JSON or XML
data Format
JSON :: Format
XML :: Format

-- | Request that is ready to be sent
data Ready

-- | Request that requires signing procedure
data Sign

-- | Lastfm API request data type
--   
--   low-level representation
data R (f :: Format)
R :: {-# UNPACK #-} !Text -> {-# UNPACK #-} !ByteString -> !(Map Text Text) -> R
[_host] :: R -> {-# UNPACK #-} !Text
[_method] :: R -> {-# UNPACK #-} !ByteString
[_query] :: R -> !(Map Text Text)

-- | Wrapping to interesting <a>Monoid</a> (<a>R</a> -&gt; <a>R</a>)
--   instance
wrap :: (R f -> R f) -> Request f a

-- | Unwrapping from interesting <a>Monoid</a> (<a>R</a> -&gt; <a>R</a>)
--   instance
unwrap :: Request f a -> R f -> R f

-- | Construct String from request for networking
render :: R f -> String
coerce :: Request f a -> Request f b

-- | Absorbing a bunch of queries, useful in batch operations
absorbQuery :: Foldable t => t (Request f b) -> Request f a

-- | Transforming Request to the "array notation"
indexedWith :: Int -> Request f a -> Request f a
instance GHC.Base.Functor (Lastfm.Internal.Request f)
instance GHC.Base.Applicative (Lastfm.Internal.Request f)
instance Data.Foldable.Foldable (Lastfm.Internal.Request f)
instance Data.Traversable.Traversable (Lastfm.Internal.Request f)
instance Data.Serialize.Serialize (Lastfm.Internal.R f)


-- | Request construction
module Lastfm.Request

-- | Lastfm API request data type
--   
--   <tt>a</tt> is the authentication state. Can be <a>Ready</a>, which
--   means this <a>Request</a> is ready to be sent, or <a>Sign</a>, if the
--   request signature hasn't been computed yet
--   
--   <tt>f</tt> is the response format (liblastfm supports both <a>JSON</a>
--   and <a>XML</a>)
data Request f a

-- | Lastfm API request data type
--   
--   low-level representation
data R (f :: Format)

-- | Request that is ready to be sent
data Ready

-- | Request that requires signing procedure
data Sign

-- | Response format: either JSON or XML
data Format
JSON :: Format
XML :: Format

-- | Change request API method
--   
--   Primarily used in API call wrappers, not intended for usage by library
--   user
api :: Text -> Request f a

-- | Change html _method to POST
--   
--   Primarily used in API call wrappers, not intended for usage by library
--   user
post :: Request f a

-- | Change html _method to GET
--   
--   Primarily used in API call wrappers, not intended for usage by library
--   user
get :: Request f a

-- | Change API response format to JSON
--   
--   This is a little helper. It's actually enough to specialize Format
--   manually
json :: Request  'JSON a

-- | Change API response format to XML
--   
--   This is a little helper. It's actually enough to specialize Format
--   manually
xml :: Request  'XML a
data APIKey

-- | Change request API key
apiKey :: Text -> Request f APIKey
data SessionKey

-- | Change request session key
sessionKey :: Text -> Request f SessionKey
data Token

-- | Add token parameter
token :: Text -> Request f Token
data Callback

-- | Add callback link parameter
callback :: Text -> Request f Callback
data Artist

-- | Add artist parameter
artist :: Text -> Request f Artist

-- | Add artists parameter
artists :: [Text] -> Request f [Artist]
data Album

-- | Add album parameter
album :: Text -> Request f Album
data MBID

-- | Add MBID parameter
mbid :: Text -> Request f MBID
data Country

-- | Add country parameter
country :: Text -> Request f Country
data Autocorrect

-- | Add autocorrect parameter
autocorrect :: Bool -> Request f Autocorrect
data Event

-- | Add event parameter
event :: Int64 -> Request f Event
data Status
Attending :: Status
Maybe :: Status
NotAttending :: Status

-- | Add status parameter
status :: Status -> Request f Status
data From

-- | Add from parameter
from :: Int64 -> Request f From
data To

-- | Add to parameter
to :: Int64 -> Request f To
data Group

-- | Add group parameter
group :: Text -> Request f Group
data Language

-- | Add language parameter
language :: Text -> Request f Language
data Distance

-- | Add distance parameter
distance :: Int64 -> Request f Distance
data Longitude

-- | Add longitude parameter
longitude :: Text -> Request f Longitude
data Latitude

-- | Add latitude parameter
latitude :: Text -> Request f Latitude
data Location

-- | Add location parameter
location :: Text -> Request f Location
data Start

-- | Add start parameter
start :: Int64 -> Request f Start
data End

-- | Add end parameter
end :: Int64 -> Request f End
data Festivals

-- | Add festivalsonly parameter
festivalsonly :: Bool -> Request f Festivals
data StartTimestamp

-- | Add startTimestamp parameter
startTimestamp :: Int64 -> Request f StartTimestamp
data EndTimestamp

-- | Add endTimestamp parameter
endTimestamp :: Int64 -> Request f EndTimestamp
data Metro

-- | Add metro parameter
metro :: Text -> Request f Metro
data Tag

-- | Add tags parameter
tags :: [Text] -> Request f [Tag]

-- | Add tag parameter
tag :: Text -> Request f Tag
data Track

-- | Add track parameter
track :: Text -> Request f Track
data Timestamp

-- | Add timestamp parameter
timestamp :: Int64 -> Request f Timestamp
data Fingerprint

-- | Add fingerprint parameter
fingerprint :: Int64 -> Request f Fingerprint
data AlbumArtist

-- | Add albumArtist parameter
albumArtist :: Text -> Request f AlbumArtist
data Duration

-- | Add duration parameter
duration :: Int64 -> Request f Duration
data TrackNumber

-- | Add trackNumber parameter
trackNumber :: Int64 -> Request f TrackNumber
data Playlist

-- | Add playlistID parameter
playlist :: Int64 -> Request f Playlist
data Title

-- | Add title parameter
title :: Text -> Request f Title
data Description

-- | Add description parameter
description :: Text -> Request f Description
data ChosenByUser

-- | Add chosenByUser parameter
chosenByUser :: Bool -> Request f ChosenByUser
data Context

-- | Add context parameter
context :: Text -> Request f Context
data StreamId

-- | Add streamId parameter
streamId :: Int64 -> Request f StreamId
data RecentTracks

-- | Add recentTracks parameter
recentTracks :: Bool -> Request f RecentTracks
data Recipient

-- | Add recipient parameter
recipient :: Text -> Request f Recipient
data Username

-- | Add username parameter
username :: Text -> Request f Username
data User

-- | Add user parameter
user :: Text -> Request f User
data Password

-- | Add password parameter
password :: Text -> Request f Password
data Public

-- | Add public parameter
public :: Bool -> Request f Public
data Message

-- | Add message parameter
message :: Text -> Request f Message
data Page

-- | Add page parameter
page :: Int64 -> Request f Page
data Limit

-- | Add limit parameter
limit :: Int64 -> Request f Limit
data TaggingType

-- | Add taggingType parameter
taggingType :: Text -> Request f TaggingType
data UseRecs

-- | Add useRecs parameter
useRecs :: Bool -> Request f UseRecs
data Venue

-- | Add venue parameter
venue :: Int64 -> Request f Venue
data VenueName

-- | Add venue parameter
venueName :: Text -> Request f VenueName
data Discovery

-- | Add group parameter
discovery :: Bool -> Request f Discovery
data RTP

-- | Add rtp parameter
rtp :: Bool -> Request f RTP
data BuyLinks

-- | Add buyLinks parameter
buyLinks :: Bool -> Request f BuyLinks
data Multiplier
M1 :: Multiplier
M2 :: Multiplier

-- | Add multiplier parameter
multiplier :: Multiplier -> Request f Multiplier
data Bitrate
B64 :: Bitrate
B128 :: Bitrate

-- | Add bitrate parameter
bitrate :: Bitrate -> Request f Bitrate
data Name

-- | Add name parameter
name :: Text -> Request f Name
data Station

-- | Add station parameter
station :: Text -> Request f Station
class Targeted a

-- | Add comparison parameter
comparison :: Targeted a => Int64 -> Request f a -> Request f a
data Scrobble
data LibraryAlbum
data LibraryArtist
instance Lastfm.Request.Targeted [Lastfm.Request.Artist]
instance Lastfm.Request.Targeted Lastfm.Request.User
instance Lastfm.Request.Argument Data.Text.Internal.Text
instance Lastfm.Request.Argument GHC.Types.Bool
instance Lastfm.Request.Argument GHC.Int.Int64
instance Lastfm.Request.Argument a => Lastfm.Request.Argument [a]


-- | Lastfm radio API
--   
--   This module is intended to be imported qualified:
--   
--   <pre>
--   import qualified Lastfm.Radio as Radio
--   </pre>
module Lastfm.Radio

-- | Fetch new radio content periodically in an XSPF format.
--   
--   Optional: <a>discovery</a>, <a>rtp</a>, <a>buyLinks</a>
--   
--   <a>http://www.last.fm/api/show/radio.getPlaylist</a>
getPlaylist :: Request f (Multiplier -> Bitrate -> APIKey -> SessionKey -> Sign)

-- | Resolve the name of a resource into a station depending on which
--   resource it is most likely to represent.
--   
--   <a>http://www.last.fm/api/show/radio.search</a>
search :: Request f (Name -> APIKey -> Ready)

-- | Tune in to a Last.fm radio station.
--   
--   Optional: <a>language</a>
--   
--   <a>http://www.last.fm/api/show/radio.tune</a>
tune :: Request f (Station -> APIKey -> SessionKey -> Sign)


-- | Lastfm playlist API
--   
--   This module is intended to be imported qualified:
--   
--   <pre>
--   import qualified Lastfm.Playlist as Playlist
--   </pre>
module Lastfm.Playlist

-- | Add a track to a Last.fm user's playlist
--   
--   <a>http://www.last.fm/api/show/playlist.addTrack</a>
addTrack :: Request f (Playlist -> Artist -> Track -> APIKey -> SessionKey -> Sign)

-- | Create a Last.fm playlist on behalf of a user
--   
--   Optional: <a>title</a>, <a>description</a>
--   
--   <a>http://www.last.fm/api/show/playlist.create</a>
create :: Request f (APIKey -> SessionKey -> Sign)


-- | Lastfm library API
--   
--   This module is intended to be imported qualified:
--   
--   <pre>
--   import qualified Lastfm.Library as Library
--   </pre>
module Lastfm.Library

-- | Add an album or collection of albums to a user's Last.fm library
--   
--   <a>http://www.last.fm/api/show/library.addAlbum</a>
addAlbum :: NonEmpty (Request f LibraryAlbum) -> Request f (APIKey -> SessionKey -> Sign)

-- | What artist to add to library?
albumItem :: Request f (Artist -> Album -> LibraryAlbum)

-- | Add an artist to a user's Last.fm library
--   
--   <a>http://www.last.fm/api/show/library.addArtist</a>
addArtist :: NonEmpty (Request f LibraryArtist) -> Request f (APIKey -> SessionKey -> Sign)

-- | What album to add to library?
artistItem :: Request f (Artist -> LibraryArtist)

-- | Add a track to a user's Last.fm library
--   
--   <a>http://www.last.fm/api/show/library.addTrack</a>
addTrack :: Request f (Artist -> Track -> APIKey -> SessionKey -> Sign)

-- | A paginated list of all the albums in a user's library, with play
--   counts and tag counts.
--   
--   Optional: <a>artist</a>, <a>limit</a>, <a>page</a>
--   
--   <a>http://www.last.fm/api/show/library.getAlbums</a>
getAlbums :: Request f (User -> APIKey -> Ready)

-- | A paginated list of all the artists in a user's library, with play
--   counts and tag counts.
--   
--   Optional: <a>limit</a>, <a>page</a>
--   
--   <a>http://www.last.fm/api/show/library.getArtists</a>
getArtists :: Request f (User -> APIKey -> Ready)

-- | A paginated list of all the tracks in a user's library, with play
--   counts and tag counts.
--   
--   Optional: <a>artist</a>, <a>album</a>, <a>page</a>, <a>limit</a>
--   
--   <a>http://www.last.fm/api/show/library.getTracks</a>
getTracks :: Request f (User -> APIKey -> Ready)

-- | Remove an album from a user's Last.fm library
--   
--   <a>http://www.last.fm/api/show/library.removeAlbum</a>
removeAlbum :: Request f (Artist -> Album -> APIKey -> SessionKey -> Sign)

-- | Remove an artist from a user's Last.fm library
--   
--   <a>http://www.last.fm/api/show/library.removeArtist</a>
removeArtist :: Request f (Artist -> APIKey -> SessionKey -> Sign)

-- | Remove a scrobble from a user's Last.fm library
--   
--   <a>http://www.last.fm/api/show/library.removeScrobble</a>
removeScrobble :: Request f (Artist -> Track -> Timestamp -> APIKey -> SessionKey -> Sign)

-- | Remove a track from a user's Last.fm library
--   
--   <a>http://www.last.fm/api/show/library.removeTrack</a>
removeTrack :: Request f (Artist -> Track -> APIKey -> SessionKey -> Sign)


-- | Lastfm group API
--   
--   This module is intended to be imported qualified:
--   
--   <pre>
--   import qualified Lastfm.Group as Group
--   </pre>
module Lastfm.Group

-- | Get the hype list for a group
--   
--   <a>http://www.last.fm/api/show/group.getHype</a>
getHype :: Request f (Group -> APIKey -> Ready)

-- | Get a list of members for this group.
--   
--   Optional: <a>page</a>, <a>limit</a>
--   
--   <a>http://www.last.fm/api/show/group.getMembers</a>
getMembers :: Request f (Group -> APIKey -> Ready)

-- | 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.
--   
--   Optional: <a>from</a>, <a>to</a>
--   
--   <a>http://www.last.fm/api/show/group.getWeeklyAlbumChart</a>
getWeeklyAlbumChart :: Request f (Group -> APIKey -> Ready)

-- | Get an artist 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.
--   
--   Optional: <a>from</a>, <a>to</a>
--   
--   <a>http://www.last.fm/api/show/group.getWeeklyArtistChart</a>
getWeeklyArtistChart :: Request f (Group -> APIKey -> Ready)

-- | Get a list of available charts for this group, expressed as date
--   ranges which can be sent to the chart services.
--   
--   <a>http://www.last.fm/api/show/group.getWeeklyChartList</a>
getWeeklyChartList :: Request f (Group -> APIKey -> Ready)

-- | Get a track 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.
--   
--   Optional: <a>from</a>, <a>to</a>
--   
--   <a>http://www.last.fm/api/show/group.getWeeklyTrackChart</a>
getWeeklyTrackChart :: Request f (Group -> APIKey -> Ready)


-- | Lastfm geo API
--   
--   This module is intended to be imported qualified:
--   
--   <pre>
--   import qualified Lastfm.Geo as Geo
--   </pre>
module Lastfm.Geo

-- | Get all events in a specific location by country or city name.
--   
--   Optional: <a>longitude</a>, <a>latitude</a>, <a>location</a>,
--   <a>distance</a>, <a>page</a>, <a>tag</a>, <a>festivalsonly</a>,
--   <a>limit</a>
--   
--   <a>http://www.last.fm/api/show/geo.getEvents</a>
getEvents :: Request f (APIKey -> Ready)

-- | Get a chart of artists for a metro
--   
--   Optional: <a>start</a>, <a>end</a>, <a>page</a>, <a>limit</a>
--   
--   <a>http://www.last.fm/api/show/geo.getMetroArtistChart</a>
getMetroArtistChart :: Request f (Metro -> Country -> APIKey -> Ready)

-- | Get a chart of hyped (up and coming) artists for a metro
--   
--   Optional: <a>start</a>, <a>end</a>, <a>page</a>, <a>limit</a>
--   
--   <a>http://www.last.fm/api/show/geo.getMetroHypeArtistChart</a>
getMetroHypeArtistChart :: Request f (Metro -> Country -> APIKey -> Ready)

-- | Get a chart of tracks for a metro
--   
--   Optional: <a>start</a>, <a>end</a>, <a>page</a>, <a>limit</a>
--   
--   <a>http://www.last.fm/api/show/geo.getMetroHypeTrackChart</a>
getMetroHypeTrackChart :: Request f (Metro -> Country -> APIKey -> Ready)

-- | Get a chart of tracks for a metro
--   
--   Optional: <a>start</a>, <a>end</a>, <a>page</a>, <a>limit</a>
--   
--   <a>http://www.last.fm/api/show/geo.getMetroTrackChart</a>
getMetroTrackChart :: Request f (Metro -> Country -> APIKey -> Ready)

-- | Get a chart of the artists which make that metro unique
--   
--   Optional: <a>start</a>, <a>end</a>, <a>page</a>, <a>limit</a>
--   
--   <a>http://www.last.fm/api/show/geo.getMetroUniqueArtistChart</a>
getMetroUniqueArtistChart :: Request f (Metro -> Country -> APIKey -> Ready)

-- | Get a chart of tracks for a metro
--   
--   Optional: <a>start</a>, <a>end</a>, <a>page</a>, <a>limit</a>
--   
--   <a>http://www.last.fm/api/show/geo.getMetroUniqueTrackChart</a>
getMetroUniqueTrackChart :: Request f (Metro -> Country -> APIKey -> Ready)

-- | Get a list of available chart periods for this metro, expressed as
--   date ranges which can be sent to the chart services.
--   
--   <a>http://www.last.fm/api/show/geo.getMetroWeeklyChartlist</a>
getMetroWeeklyChartlist :: Request f (Metro -> APIKey -> Ready)

-- | Get a list of valid countries and metros for use in the other
--   webservices
--   
--   Optional: <a>country</a>
--   
--   <a>http://www.last.fm/api/show/geo.getMetros</a>
getMetros :: Request f (APIKey -> Ready)

-- | Get the most popular artists on Last.fm by country
--   
--   Optional: <a>limit</a>, <a>page</a>
--   
--   <a>http://www.last.fm/api/show/geo.getTopArtists</a>
getTopArtists :: Request f (Country -> APIKey -> Ready)

-- | Get the most popular tracks on Last.fm last week by country
--   
--   Optional: <a>limit</a>, <a>page</a>
--   
--   <a>http://www.last.fm/api/show/geo.getTopTracks</a>
getTopTracks :: Request f (Country -> APIKey -> Ready)


-- | Lastfm event API
--   
--   This module is intended to be imported qualified:
--   
--   <pre>
--   import qualified Lastfm.Event as Event
--   </pre>
module Lastfm.Event

-- | Set a user's attendance status for an event.
--   
--   <a>http://www.last.fm/api/show/event.attend</a>
attend :: Request f (Event -> Status -> APIKey -> SessionKey -> Sign)

-- | Get a list of attendees for an event.
--   
--   Optional: <a>page</a>, <a>limit</a>
--   
--   <a>http://www.last.fm/api/show/event.getAttendees</a>
getAttendees :: Request f (Event -> APIKey -> Ready)

-- | Get the metadata for an event on Last.fm. Includes attendance and
--   lineup information.
--   
--   <a>http://www.last.fm/api/show/event.getInfo</a>
getInfo :: Request f (Event -> APIKey -> Ready)

-- | Get shouts for this event. Also available as an rss feed.
--   
--   Optional: <a>page</a>, <a>limit</a>
--   
--   <a>http://www.last.fm/api/show/event.getShouts</a>
getShouts :: Request f (Event -> APIKey -> Ready)

-- | Share an event with one or more Last.fm users or other friends.
--   
--   Optional: <a>public</a>, <a>message</a>
--   
--   <a>http://www.last.fm/api/show/event.share</a>
share :: Request f (Event -> Recipient -> APIKey -> SessionKey -> Sign)

-- | Shout in this event's shoutbox
--   
--   <a>http://www.last.fm/api/show/event.shout</a>
shout :: Request f (Event -> Message -> APIKey -> SessionKey -> Sign)


-- | Lastfm chart API
--   
--   This module is intended to be imported qualified:
--   
--   <pre>
--   import qualified Lastfm.Chart as Chart
--   </pre>
module Lastfm.Chart

-- | Get the hyped artists chart
--   
--   Optional: <a>page</a>, <a>limit</a>
--   
--   <a>http://www.last.fm/api/show/chart.getHypedArtists</a>
getHypedArtists :: Request f (APIKey -> Ready)

-- | Get the top artists chart
--   
--   Optional: <a>page</a>, <a>limit</a>
--   
--   <a>http://www.last.fm/api/show/chart.getHypedTracks</a>
getHypedTracks :: Request f (APIKey -> Ready)

-- | Get the most loved tracks chart
--   
--   Optional: <a>page</a>, <a>limit</a>
--   
--   <a>http://www.last.fm/api/show/chart.getLovedTracks</a>
getLovedTracks :: Request f (APIKey -> Ready)

-- | Get the top artists chart
--   
--   Optional: <a>page</a>, <a>limit</a>
--   
--   <a>http://www.last.fm/api/show/chart.getTopArtists</a>
getTopArtists :: Request f (APIKey -> Ready)

-- | Get the top artists chart
--   
--   Optional: <a>page</a>, <a>limit</a>
--   
--   <a>http://www.last.fm/api/show/chart.getTopTags</a>
getTopTags :: Request f (APIKey -> Ready)

-- | Get the top tracks chart
--   
--   Optional: <a>page</a>, <a>limit</a>
--   
--   <a>http://www.last.fm/api/show/chart.getTopTracks</a>
getTopTracks :: Request f (APIKey -> Ready)


-- | Lastfm authentication procedure helpers
--   
--   Basically, lastfm provides 3 ways to authenticate user:
--   
--   <ul>
--   <li>web application - <a>http://www.last.fm/api/webauth</a></li>
--   <li>desktop application -
--   <a>http://www.last.fm/api/desktopauth</a></li>
--   <li>modile application - <a>http://www.last.fm/api/mobileauth</a></li>
--   </ul>
--   
--   Note that you can use any of them in your application despite their
--   names
--   
--   How to get session key for yourself for debug with GHCi:
--   
--   <pre>
--   &gt;&gt;&gt; import Lastfm
--   
--   &gt;&gt;&gt; import Lastfm.Authentication
--   
--   &gt;&gt;&gt; :set -XOverloadedStrings
--   
--   &gt;&gt;&gt; con &lt;- newConnection
--   
--   &gt;&gt;&gt; lastfm con $ getToken &lt;*&gt; apiKey "__API_KEY__" &lt;* json
--   Right (Object (fromList [("token",String "__TOKEN__")]))
--   
--   &gt;&gt;&gt; putStrLn . link $ apiKey "__API_KEY__" &lt;* token "__TOKEN__"
--   http://www.last.fm/api/auth/?api_key=__API_KEY__&amp;token=__TOKEN__
--   
--   &gt;&gt;&gt; -- Click that link ^^^
--   
--   &gt;&gt;&gt; lastfm con $ sign "__SECRET__" $ getSession &lt;*&gt; token "__TOKEN__" &lt;*&gt; apiKey "__API_KEY__"  &lt;* json
--   Right (Object (fromList [("session",Object (fromList [("subscriber",String "0"),("key",String "__SESSION_KEY__"),("name",String "__USER__")]))]))
--   </pre>
module Lastfm.Authentication

-- | Get authorization token
getToken :: Request f (APIKey -> Ready)

-- | Get session key
getSession :: Request f (Token -> APIKey -> Sign)

-- | Get session key
getMobileSession :: Request f (Username -> Password -> APIKey -> Sign)

-- | Construct link user should follow to approve application
link :: Request f a -> String


-- | Lastfm artist API
--   
--   This module is intended to be imported qualified:
--   
--   <pre>
--   import qualified Lastfm.Artist as Artist
--   </pre>
module Lastfm.Artist

-- | Unify (<a>Artist</a> -&gt; …) and (<a>MBID</a> -&gt; …)
class ArtistOrMBID r a

-- | Tag an artist with one or more user supplied tags.
--   
--   <a>http://www.last.fm/api/show/artist.addTags</a>
addTags :: Request f (Artist -> [Tag] -> APIKey -> SessionKey -> Sign)

-- | Use the last.fm corrections data to check whether the supplied artist
--   has a correction to a canonical artist
--   
--   <a>http://www.last.fm/api/show/artist.getCorrection</a>
getCorrection :: Request f (Artist -> APIKey -> Ready)

-- | Get a list of upcoming events for this artist. Easily integratable
--   into calendars, using the ical standard (see feeds section below).
--   
--   Optional: <a>autocorrect</a>, <a>limit</a>, <tt>pages</tt>,
--   <a>festivalsonly</a>
--   
--   <a>http://www.last.fm/api/show/artist.getEvents</a>
getEvents :: ArtistOrMBID Ready a => Request f (a -> APIKey -> Ready)

-- | Get the metadata for an artist. Includes biography.
--   
--   Optional: <a>language</a>, <a>autocorrect</a>, <a>username</a>
--   
--   <a>http://www.last.fm/api/show/artist.getInfo</a>
getInfo :: ArtistOrMBID Ready a => Request f (a -> APIKey -> Ready)

-- | Get a paginated list of all the events this artist has played at in
--   the past.
--   
--   Optional: <a>page</a>, <a>autocorrect</a>, <a>limit</a>
--   
--   <a>http://www.last.fm/api/show/artist.getPastEvents</a>
getPastEvents :: ArtistOrMBID Ready a => Request f (a -> APIKey -> Ready)

-- | Get a podcast of free mp3s based on an artist
--   
--   Optional: <a>autocorrect</a>
--   
--   <a>http://www.last.fm/api/show/artist.getPodcast</a>
getPodcast :: ArtistOrMBID Ready a => Request f (a -> APIKey -> Ready)

-- | Get shouts for this artist. Also available as an rss feed.
--   
--   Optional:<a>autocorrect</a>, <a>limit</a>, <a>page</a>
--   
--   <a>http://www.last.fm/api/show/artist.getShouts</a>
getShouts :: ArtistOrMBID Ready a => Request f (a -> APIKey -> Ready)

-- | Get all the artists similar to this artist
--   
--   Optional: <a>limit</a>, <a>autocorrect</a>
--   
--   <a>http://www.last.fm/api/show/artist.getSimilar</a>
getSimilar :: ArtistOrMBID Ready a => Request f (a -> APIKey -> Ready)

-- | Get the tags applied by an individual user to an artist on Last.fm. If
--   accessed as an authenticated service <i>and</i> you don't supply a
--   user parameter then this service will return tags for the
--   authenticated user. To retrieve the list of top tags applied to an
--   artist by all users use <a>getTopTags</a>.
--   
--   Optional: <a>user</a>, <a>autocorrect</a>
--   
--   <a>http://www.last.fm/api/show/artist.getTags</a>
getTags :: ArtistOrMBID r a => Request f (a -> APIKey -> r)

-- | Get the top albums for an artist on Last.fm, ordered by popularity.
--   
--   Optional: <a>autocorrect</a>, <a>page</a>, <a>limit</a>
--   
--   <a>http://www.last.fm/api/show/artist.getTopAlbums</a>
getTopAlbums :: ArtistOrMBID Ready a => Request f (a -> APIKey -> Ready)

-- | Get the top fans for an artist on Last.fm, based on listening data.
--   
--   Optional: <a>autocorrect</a>
--   
--   <a>http://www.last.fm/api/show/artist.getTopFans</a>
getTopFans :: ArtistOrMBID Ready a => Request f (a -> APIKey -> Ready)

-- | Get the top tags for an artist on Last.fm, ordered by popularity.
--   
--   Optional: <a>autocorrect</a>
--   
--   <a>http://www.last.fm/api/show/artist.getTopTags</a>
getTopTags :: ArtistOrMBID Ready a => Request f (a -> APIKey -> Ready)

-- | Get the top tracks by an artist on Last.fm, ordered by popularity
--   
--   Optional: <a>autocorrect</a>, <a>page</a>, <a>limit</a>
--   
--   <a>http://www.last.fm/api/show/artist.getTopTracks</a>
getTopTracks :: ArtistOrMBID Ready a => Request f (a -> APIKey -> Ready)

-- | Remove a user's tag from an artist.
--   
--   <a>http://www.last.fm/api/show/artist.removeTag</a>
removeTag :: Request f (Artist -> Tag -> APIKey -> SessionKey -> Sign)

-- | Search for an artist by name. Returns artist matches sorted by
--   relevance.
--   
--   Optional: <a>limit</a>, <a>page</a>
--   
--   <a>http://www.last.fm/api/show/artist.search</a>
search :: Request f (Artist -> APIKey -> Ready)

-- | Share an artist with Last.fm users or other friends.
--   
--   Optional: <a>message</a>, <a>public</a>
--   
--   <a>http://www.last.fm/api/show/artist.share</a>
share :: Request f (Artist -> Recipient -> APIKey -> SessionKey -> Sign)

-- | Shout in this artist's shoutbox
--   
--   <a>http://www.last.fm/api/show/artist.shout</a>
shout :: Request f (Artist -> Message -> APIKey -> SessionKey -> Sign)
instance Lastfm.Artist.ArtistOrMBID r Lastfm.Request.MBID
instance Lastfm.Artist.ArtistOrMBID r Lastfm.Request.Artist


-- | Lastfm album API
--   
--   This module is intended to be imported qualified:
--   
--   <pre>
--   import qualified Lastfm.Album as Album
--   </pre>
module Lastfm.Album

-- | Unify (<a>Artist</a> -&gt; <a>Album</a> -&gt; …) and (<a>MBID</a>
--   -&gt; …)
class ArtistAlbumOrMBID r a | a -> r

-- | Tag an album using a list of user supplied tags.
--   
--   <a>http://www.last.fm/api/show/album.addTags</a>
addTags :: Request f (Artist -> Album -> [Tag] -> APIKey -> SessionKey -> Sign)

-- | 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 parameter.
--   
--   Optional: <a>autocorrect</a>
--   
--   <a>http://www.last.fm/api/show/album.getBuylinks</a>
getBuyLinks :: ArtistAlbumOrMBID Ready a => Request f (Country -> a)

-- | 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.
--   
--   Optional: <a>autocorrect</a>, <a>username</a>, <a>language</a>
--   
--   <a>http://www.last.fm/api/show/album.getInfo</a>
getInfo :: ArtistAlbumOrMBID Ready a => Request f a

-- | Get shouts for this album.
--   
--   Optional: <a>autocorrect</a>, <a>limit</a>, <a>page</a>
--   
--   <a>http://www.last.fm/api/show/album.getShouts</a>
getShouts :: ArtistAlbumOrMBID Ready a => Request f a

-- | Get the tags applied by an individual user to an album on Last.fm.
--   
--   Optional: <a>autocorrect</a>, <a>user</a>
--   
--   <a>http://www.last.fm/api/show/album.getTags</a>
getTags :: ArtistAlbumOrMBID r a => Request f a

-- | Get the top tags for an album on Last.fm, ordered by popularity.
--   
--   Optional: <a>autocorrect</a>
--   
--   <a>http://www.last.fm/api/show/album.getTopTags</a>
getTopTags :: ArtistAlbumOrMBID Ready a => Request f a

-- | Remove a user's tag from an album.
--   
--   <a>http://www.last.fm/api/show/album.removeTag</a>
removeTag :: Request f (Artist -> Album -> Tag -> APIKey -> SessionKey -> Sign)

-- | Search for an album by name. Returns album matches sorted by
--   relevance.
--   
--   Optional: <a>limit</a>, <a>page</a>
--   
--   <a>http://www.last.fm/api/show/album.search</a>
search :: Request f (Album -> APIKey -> Ready)

-- | Share an album with one or more Last.fm users or other friends.
--   
--   Optional: <a>public</a>, <a>message</a>, <a>recipient</a>
--   
--   <a>http://www.last.fm/api/show/album.share</a>
share :: Request f (Album -> Artist -> Recipient -> APIKey -> SessionKey -> Sign)
instance Lastfm.Album.ArtistAlbumOrMBID r (Lastfm.Request.MBID -> Lastfm.Request.APIKey -> r)
instance Lastfm.Album.ArtistAlbumOrMBID r (Lastfm.Request.Artist -> Lastfm.Request.Album -> Lastfm.Request.APIKey -> r)


-- | Request sending and Response parsing
module Lastfm.Response

-- | Application secret
newtype Secret
Secret :: Text -> Secret

-- | Sign the <a>Request</a> with the <a>Secret</a> so it's ready to be
--   sent
sign :: Secret -> Request f Sign -> Request f Ready

-- | Lastfm connection manager
data Connection

-- | Creating an HTTPS connection manager is expensive; it's advised to use
--   a single <a>Connection</a> for all communications with last.fm
withConnection :: MonadIO m => (Connection -> m a) -> m a

-- | Create a <a>Connection</a>. Note that there's no need to close the
--   connection manually, as it will be closed automatically when no longer
--   in use, that is, all the requests have been processed and it's about
--   to be garbage collected.
newConnection :: MonadIO m => m Connection

-- | Perform the <a>Request</a> and parse the response
lastfm :: Supported f r => Connection -> Request f Ready -> IO (Either LastfmError r)

-- | Perform the <a>Request</a> ignoring any responses
lastfm_ :: Supported f r => Connection -> Request f Ready -> IO (Either LastfmError ())

-- | <a>Supported</a> provides parsing for the chosen <a>Format</a>
--   
--   <a>JSON</a> is parsed to <a>Value</a> type from aeson, while
--   <a>XML</a> is parsed to <a>Document</a> from xml-conduit
class Supported f r | f -> r, r -> f

-- | Response format: either JSON or XML
data Format
JSON :: Format
XML :: Format

-- | Different ways last.fm response can be unusable
data LastfmError

-- | last.fm thinks it responded with something legible, but it really
--   isn't
LastfmBadResponse :: ByteString -> LastfmError

-- | last.fm error code and message string
LastfmEncodedError :: Int -> Text -> LastfmError

-- | wrapped http-conduit exception
LastfmHttpError :: HttpException -> LastfmError

-- | This is a <tt> Prism' <a>LastfmError</a> <a>ByteString</a> </tt> in
--   disguise
_LastfmBadResponse :: (Choice p, Applicative m, AsLastfmError e) => p ByteString (m ByteString) -> p e (m e)

-- | This is a <tt> Prism' <a>LastfmError</a> (<a>Int</a>, <a>String</a>)
--   </tt> in disguise
_LastfmEncodedError :: (Choice p, Applicative m, AsLastfmError e) => p (Int, Text) (m (Int, Text)) -> p e (m e)

-- | This is a <tt> Prism' <a>LastfmError</a> <a>HttpException</a> </tt> in
--   disguise
_LastfmHttpError :: (Choice p, Applicative m, AsLastfmError e) => p HttpException (m HttpException) -> p e (m e)
instance GHC.Classes.Eq Lastfm.Response.Secret
instance GHC.Show.Show Lastfm.Response.Secret
instance GHC.Show.Show Lastfm.Response.LastfmError
instance Data.String.IsString Lastfm.Response.Secret
instance Lastfm.Response.AsLastfmError Lastfm.Response.LastfmError
instance Lastfm.Response.AsLastfmError GHC.Exception.SomeException
instance Lastfm.Response.Supported 'Lastfm.Internal.JSON Data.Aeson.Types.Internal.Value
instance Lastfm.Response.Supported 'Lastfm.Internal.XML Text.XML.Document
instance GHC.Classes.Eq Lastfm.Response.LastfmError
instance GHC.Exception.Exception Lastfm.Response.LastfmError


-- | Lastfm API interface
module Lastfm


-- | Lastfm tag API
--   
--   This module is intended to be imported qualified:
--   
--   <pre>
--   import qualified Lastfm.Tag as Tag
--   </pre>
module Lastfm.Tag

-- | Get the metadata for a tag
--   
--   Optional: language
--   
--   <a>http://www.last.fm/api/show/tag.getInfo</a>
getInfo :: Request f (Tag -> APIKey -> Ready)

-- | Search for tags similar to this one. Returns tags ranked by
--   similarity, based on listening data.
--   
--   <a>http://www.last.fm/api/show/tag.getSimilar</a>
getSimilar :: Request f (Tag -> APIKey -> Ready)

-- | Get the top albums tagged by this tag, ordered by tag count.
--   
--   Optional: <a>limit</a>, <a>page</a>
--   
--   <a>http://www.last.fm/api/show/tag.getTopAlbums</a>
getTopAlbums :: Request f (Tag -> APIKey -> Ready)

-- | Get the top artists tagged by this tag, ordered by tag count.
--   
--   Optional: <a>limit</a>, <a>page</a>
--   
--   <a>http://www.last.fm/api/show/tag.getTopArtists</a>
getTopArtists :: Request f (Tag -> APIKey -> Ready)

-- | Fetches the top global tags on Last.fm, sorted by popularity (number
--   of times used)
--   
--   <a>http://www.last.fm/api/show/tag.getTopTags</a>
getTopTags :: Request f (APIKey -> Ready)

-- | Get the top tracks tagged by this tag, ordered by tag count.
--   
--   Optional: <a>limit</a>, <a>page</a>
--   
--   <a>http://www.last.fm/api/show/tag.getTopTracks</a>
getTopTracks :: Request f (Tag -> APIKey -> Ready)

-- | 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.
--   
--   Optional: <a>from</a>, <a>to</a>, <a>limit</a>
--   
--   <a>http://www.last.fm/api/show/tag.getWeeklyArtistChart</a>
getWeeklyArtistChart :: Request f (Tag -> APIKey -> Ready)

-- | Get a list of available charts for this tag, expressed as date ranges
--   which can be sent to the chart services.
--   
--   <a>http://www.last.fm/api/show/tag.getWeeklyChartList</a>
getWeeklyChartList :: Request f (Tag -> APIKey -> Ready)

-- | Search for a tag by name. Returns matches sorted by relevance.
--   
--   Optional: <a>limit</a>, <a>page</a>
--   
--   <a>http://www.last.fm/api/show/tag.search</a>
search :: Request f (Tag -> APIKey -> Ready)


-- | Lastfm tasteometer API
--   
--   This module is intended to be imported qualified:
--   
--   <pre>
--   import qualified Lastfm.Tasteometer as Tasteometer
--   </pre>
module Lastfm.Tasteometer

-- | 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.
--   
--   Optional: <a>limit</a>
--   
--   <a>http://www.last.fm/api/show/tasteometer.compare</a>
compare :: (Targeted u, Targeted v) => Request f u -> Request f v -> Request f (APIKey -> Ready)


-- | Lastfm track API
--   
--   This module is intended to be imported qualified:
--   
--   <pre>
--   import qualified Lastfm.Track as Track
--   </pre>
module Lastfm.Track

-- | Unify (<a>Artist</a> -&gt; <a>Track</a> -&gt; …) and (<a>MBID</a>
--   -&gt; …)
class ArtistTrackOrMBID a

-- | Tag a track using a list of user supplied tags.
--   
--   <a>http://www.last.fm/api/show/track.addTags</a>
addTags :: Request f (Artist -> Track -> [Tag] -> APIKey -> SessionKey -> Sign)

-- | Ban a track for a given user profile.
--   
--   <a>http://www.last.fm/api/show/track.ban</a>
ban :: Request f (Artist -> Track -> APIKey -> SessionKey -> Sign)

-- | Get a list of Buy Links for a particular track.
--   
--   Optional: <a>autocorrect</a>
--   
--   <a>http://www.last.fm/api/show/track.getBuylinks</a>
getBuyLinks :: ArtistTrackOrMBID t => Request f (Country -> t)

-- | Use the last.fm corrections data to check whether the supplied track
--   has a correction to a canonical track.
--   
--   <a>http://www.last.fm/api/show/track.getCorrection</a>
getCorrection :: Request f (Artist -> Track -> APIKey -> Ready)

-- | Retrieve track metadata associated with a fingerprint id generated by
--   the Last.fm Fingerprinter. Returns track elements, along with a
--   <tt>rank</tt> value between 0 and 1 reflecting the confidence for each
--   match.
--   
--   <a>http://www.last.fm/api/show/track.getFingerprintMetadata</a>
getFingerprintMetadata :: Request f (Fingerprint -> APIKey -> Ready)

-- | Get the metadata for a track on Last.fm.
--   
--   Optional: <a>autocorrect</a>, <a>username</a>
--   
--   <a>http://www.last.fm/api/show/track.getInfo</a>
getInfo :: ArtistTrackOrMBID t => Request f t

-- | Get shouts for this track. Also available as an rss feed.
--   
--   Optional: <a>autocorrect</a>, <a>limit</a>, <a>page</a>
--   
--   <a>http://www.last.fm/api/show/track.getShouts</a>
getShouts :: ArtistTrackOrMBID t => Request f t

-- | Get the similar tracks for this track on Last.fm, based on listening
--   data.
--   
--   Optional: <a>autocorrect</a>, <a>limit</a>
--   
--   <a>http://www.last.fm/api/show/track.getSimilar</a>
getSimilar :: ArtistTrackOrMBID t => Request f t

-- | Get the tags applied by an individual user to a track on Last.fm.
--   
--   Optional: <a>autocorrect</a>, <a>user</a>
--   
--   <a>http://www.last.fm/api/show/track.getTags</a>
getTags :: ArtistTrackOrMBID t => Request f t

-- | Get the top fans for this track on Last.fm, based on listening data.
--   
--   Optional: <a>autocorrect</a>
--   
--   <a>http://www.last.fm/api/show/track.getTopFans</a>
getTopFans :: ArtistTrackOrMBID t => Request f t

-- | Get the top tags for this track on Last.fm, ordered by tag count.
--   
--   Optional: <a>autocorrect</a>
--   
--   <a>http://www.last.fm/api/show/track.getTopTags</a>
getTopTags :: ArtistTrackOrMBID t => Request f t

-- | Love a track for a user profile.
--   
--   <a>http://www.last.fm/api/show/track.love</a>
love :: Request f (Artist -> Track -> APIKey -> SessionKey -> Sign)

-- | Remove a user's tag from a track.
--   
--   <a>http://www.last.fm/api/show/track.removeTag</a>
removeTag :: Request f (Artist -> Track -> Tag -> APIKey -> SessionKey -> Sign)

-- | Add played tracks to the user profile.
--   
--   Scrobbles 50 first list elements
--   
--   <a>http://www.last.fm/api/show/track.scrobble</a>
scrobble :: NonEmpty (Request f Scrobble) -> Request f (APIKey -> SessionKey -> Sign)

-- | What track to scrobble?
--   
--   Optional: <a>album</a>, <a>albumArtist</a>, <a>chosenByUser</a>,
--   <a>context</a>, <a>duration</a>, <a>mbid</a>, <a>streamId</a>,
--   <a>trackNumber</a>
item :: Request f (Artist -> Track -> Timestamp -> Scrobble)

-- | Search for a track by track name. Returns track matches sorted by
--   relevance.
--   
--   Optional: <a>artist</a>, <a>limit</a>, <a>page</a>
--   
--   <a>http://www.last.fm/api/show/track.search</a>
search :: Request f (Track -> APIKey -> Ready)

-- | Share a track twith one or more Last.fm users or other friends.
--   
--   Optional: <a>public</a>, <a>message</a>, <a>recipient</a>
--   
--   <a>http://www.last.fm/api/show/track.share</a>
share :: Request f (Artist -> Track -> Recipient -> APIKey -> SessionKey -> Sign)

-- | Unban a track for a user profile.
--   
--   <a>http://www.last.fm/api/show/track.unban</a>
unban :: Request f (Artist -> Track -> APIKey -> SessionKey -> Sign)

-- | Unlove a track for a user profile.
--   
--   <a>http://www.last.fm/api/show/track.unlove</a>
unlove :: Request f (Artist -> Track -> APIKey -> SessionKey -> Sign)

-- | Used to notify Last.fm that a user has started listening to a track.
--   Parameter names are case sensitive.
--   
--   Optional: <a>album</a>, <a>albumArtist</a>, <a>context</a>,
--   <a>duration</a>, <a>mbid</a>, <a>trackNumber</a>
--   
--   <a>http://www.last.fm/api/show/track.updateNowPlaying</a>
updateNowPlaying :: Request f (Artist -> Track -> APIKey -> SessionKey -> Sign)
instance Lastfm.Track.ArtistTrackOrMBID (Lastfm.Request.MBID -> Lastfm.Request.APIKey -> Lastfm.Internal.Ready)
instance Lastfm.Track.ArtistTrackOrMBID (Lastfm.Request.Artist -> Lastfm.Request.Track -> Lastfm.Request.APIKey -> Lastfm.Internal.Ready)


-- | Lastfm user API
--   
--   This module is intended to be imported qualified:
--   
--   <pre>
--   import qualified Lastfm.User as User
--   </pre>
module Lastfm.User

-- | 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.
--   
--   Optional: <a>startTimestamp</a>, <a>page</a>, <a>endTimestamp</a>
--   
--   <a>http://www.last.fm/api/show/user.getArtistTracks</a>
getArtistTracks :: Request f (User -> Artist -> APIKey -> Ready)

-- | Returns the tracks banned by the user
--   
--   Optional: <a>limit</a>, <a>page</a>
--   
--   <a>http://www.last.fm/api/show/user.getBannedTracks</a>
getBannedTracks :: Request f (User -> APIKey -> Ready)

-- | Get a list of upcoming events that this user is attending. Easily
--   integratable into calendars, using the ical standard (see 'more
--   formats' section below).
--   
--   Optional: <a>page</a>, <a>festivalsonly</a>, <a>limit</a>
--   
--   <a>http://www.last.fm/api/show/user.getEvents</a>
getEvents :: Request f (User -> APIKey -> Ready)

-- | Get a list of the user's friends on Last.fm.
--   
--   Optional: <tt>recenttracks</tt>, <a>limit</a>, <a>page</a>
--   
--   <a>http://www.last.fm/api/show/user.getFriends</a>
getFriends :: Request f (User -> APIKey -> Ready)

-- | Get information about a user profile.
--   
--   <a>http://www.last.fm/api/show/user.getInfo</a>
getInfo :: Request f (User -> APIKey -> Ready)

-- | Get the last 50 tracks loved by a user.
--   
--   Optional: <a>limit</a>, <a>page</a>
--   
--   <a>http://www.last.fm/api/show/user.getLovedTracks</a>
getLovedTracks :: Request f (User -> APIKey -> Ready)

-- | Get a list of a user's neighbours on Last.fm.
--   
--   Optional: <a>limit</a>
--   
--   <a>http://www.last.fm/api/show/user.getNeighbours</a>
getNeighbours :: Request f (User -> APIKey -> Ready)

-- | Gets a list of forthcoming releases based on a user's musical taste.
--   
--   Optional: <tt>userecs</tt>
--   
--   <a>http://www.last.fm/api/show/user.getNewReleases</a>
getNewReleases :: Request f (User -> APIKey -> Ready)

-- | Get a paginated list of all events a user has attended in the past.
--   
--   Optional: <a>page</a>, <a>limit</a>
--   
--   <a>http://www.last.fm/api/show/user.getPastEvents</a>
getPastEvents :: Request f (User -> APIKey -> Ready)

-- | Get the user's personal tags
--   
--   Optional: <tt>taggingtype</tt>, <a>limit</a>, <a>page</a>
--   
--   <a>http://www.last.fm/api/show/user.getPersonalTags</a>
getPersonalTags :: Request f (User -> Tag -> TaggingType -> APIKey -> Ready)

-- | Get a list of a user's playlists on Last.fm.
--   
--   <a>http://www.last.fm/api/show/user.getPlaylists</a>
getPlaylists :: Request f (User -> APIKey -> Ready)

-- | Get a list of the recent Stations listened to by this user.
--   
--   Optional: <a>limit</a>, <a>page</a>
--   
--   <a>http://www.last.fm/api/show/user.getRecentStations</a>
getRecentStations :: Request f (User -> APIKey -> SessionKey -> Sign)

-- | 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.
--   
--   Optional: <a>limit</a>, <a>page</a>, <a>from</a>, <tt>extended</tt>,
--   <a>to</a>
--   
--   <a>http://www.last.fm/api/show/user.getRecentTracks</a>
getRecentTracks :: Request f (User -> APIKey -> Ready)

-- | Get Last.fm artist recommendations for a user
--   
--   Optional: <a>page</a>, <a>limit</a>
--   
--   <a>http://www.last.fm/api/show/user.getRecommendedArtists</a>
getRecommendedArtists :: Request f (APIKey -> SessionKey -> Sign)

-- | Get a paginated list of all events recommended to a user by Last.fm,
--   based on their listening profile.
--   
--   Optional: <a>limit</a>, <a>page</a>, <a>latitude</a>,
--   <a>longitude</a>, <a>festivalsonly</a>, <a>country</a>
--   
--   <a>http://www.last.fm/api/show/user.getRecommendedEvents</a>
getRecommendedEvents :: Request f (APIKey -> SessionKey -> Sign)

-- | Get shouts for this user. Also available as an rss feed.
--   
--   Optional: <a>page</a>, <a>limit</a>
--   
--   <a>http://www.last.fm/api/show/user.getShouts</a>
getShouts :: Request f (User -> APIKey -> Ready)

-- | Get the top albums listened to by a user. You can stipulate a time
--   period. Sends the overall chart by default.
--   
--   Optional: <tt>period</tt>, <a>limit</a>, <a>page</a>
--   
--   <a>http://www.last.fm/api/show/user.getTopAlbums</a>
getTopAlbums :: Request f (User -> APIKey -> Ready)

-- | Get the top artists listened to by a user. You can stipulate a time
--   period. Sends the overall chart by default.
--   
--   Optional: <tt>period</tt>, <a>limit</a>, <a>page</a>
--   
--   <a>http://www.last.fm/api/show/user.getTopArtists</a>
getTopArtists :: Request f (User -> APIKey -> Ready)

-- | Get the top tags used by this user.
--   
--   Optional: <a>limit</a>
--   
--   <a>http://www.last.fm/api/show/user.getTopTags</a>
getTopTags :: Request f (User -> APIKey -> Ready)

-- | Get the top tracks listened to by a user. You can stipulate a time
--   period. Sends the overall chart by default.
--   
--   Optional: <tt>period</tt>, <a>limit</a>, <a>page</a>
--   
--   <a>http://www.last.fm/api/show/user.getTopTracks</a>
getTopTracks :: Request f (User -> APIKey -> Ready)

-- | 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.
--   
--   Optional: <a>from</a>, <a>to</a>
--   
--   <a>http://www.last.fm/api/show/user.getWeeklyAlbumChart</a>
getWeeklyAlbumChart :: Request f (User -> APIKey -> Ready)

-- | 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.
--   
--   Optional: <a>from</a>, <a>to</a>
--   
--   <a>http://www.last.fm/api/show/user.getWeeklyArtistChart</a>
getWeeklyArtistChart :: Request f (User -> APIKey -> Ready)

-- | Get a list of available charts for this user, expressed as date ranges
--   which can be sent to the chart services.
--   
--   <a>http://www.last.fm/api/show/user.getWeeklyChartList</a>
getWeeklyChartList :: Request f (User -> APIKey -> Ready)

-- | 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.
--   
--   Optional: <a>from</a>, <a>to</a>
--   
--   <a>http://www.last.fm/api/show/user.getWeeklyTrackChart</a>
getWeeklyTrackChart :: Request f (User -> APIKey -> Ready)

-- | Shout on this user's shoutbox
--   
--   <a>http://www.last.fm/api/show/user.shout</a>
shout :: Request f (User -> Message -> APIKey -> SessionKey -> Sign)


-- | Lastfm venue API
--   
--   This module is intended to be imported qualified:
--   
--   <pre>
--   import qualified Lastfm.Venue as Venue
--   </pre>
module Lastfm.Venue

-- | Get a list of upcoming events at this venue.
--   
--   Optional: <a>festivalsonly</a>
--   
--   <a>http://www.last.fm/api/show/venue.getEvents</a>
getEvents :: Request f (Venue -> APIKey -> Ready)

-- | Get a paginated list of all the events held at this venue in the past.
--   
--   Optional: <a>festivalsonly</a>, <a>page</a>, <a>limit</a>
--   
--   <a>http://www.last.fm/api/show/venue.getPastEvents</a>
getPastEvents :: Request f (Venue -> APIKey -> Ready)

-- | Search for a venue by venue name
--   
--   Optional: <a>page</a>, <a>limit</a>, <a>country</a>
--   
--   <a>http://www.last.fm/api/show/venue.search</a>
search :: Request f (VenueName -> APIKey -> Ready)