README

NAME
    Net::LastFM - A simple interface to the Last.fm API

SYNOPSIS
      my $lastfm = Net::LastFM->new(
          api_key    => 'XXX',
          api_secret => 'YYY',
          json       => 0,
      );
      my $data = $lastfm->request_signed(
          method => 'user.getRecentTracks',
          user   => 'lglb',
      );

DESCRIPTION
    The module provides a simple interface to the Last.fm API. To use this
    module, you must first sign up at <http://www.last.fm/api> to receive an
    API key and secret.

    You can then make requests on the API - most of the requests are signed.
    You pass in a hash of paramters and a data structure mirroring the
    response is returned.

    Raw JSON data will be returned if you set the json flag true.

    This module confesses if there is an error.

METHODS
  request
    This makes an unsigned request:

      my $data = $lastfm->request( method => 'auth.gettoken' );

  request_signed
    This makes a signed request:

      my $data = $lastfm->request_signed(
          method => 'user.getRecentTracks',
          user   => 'lglb',
      );

  create_http_request
    If you want to integrate this module into another HTTP framework, this
    method will simple create an unsigned HTTP::Request object:

      my $http_request = $lastfm->create_http_request(
          method => 'auth.gettoken'
      );

  create_http_request_signed
    If you want to integrate this module into another HTTP framework, this
    method will simple create a signed HTTP::Request object:

      my $http_request = $lastfm->create_http_request_signed(
          method => 'user.getRecentTracks',
          user   => 'lglb',
      );

AUTHOR
    Leon Brocard <acme@astray.com>

COPYRIGHT
    Copyright (C) 2008-9, Leon Brocard.

LICENSE
    This module is free software; you can redistribute it or modify it under
    the same terms as Perl itself.