Jesse Luehrs > LastFM-Export-0.02 > LastFM::Export

Download:
LastFM-Export-0.02.tar.gz

Dependencies

Annotate this POD

Website

View/Report Bugs
Module Version: 0.02   Source   Latest Release: LastFM-Export-0.03

NAME ^

LastFM::Export - data exporter for last.fm

VERSION ^

version 0.02

SYNOPSIS ^

  use LastFM::Export;

  my $exporter = LastFM::Export->new(user => 'doyster');
  my $stream = $exporter->tracks;

  while (my $block = $stream->next) {
      for my $track (@$block) {
          # ...
      }
      sleep 1;
  }

DESCRIPTION ^

This module uses the http://last.fm/ API to allow you to export your scrobbling data from your account. Currently, the only thing this lets you export is your actual scrobble data, but more features may be added in the future (especially if the feature requests come with patches!).

ATTRIBUTES ^

user

last.fm user to export data for. Required.

METHODS ^

track_count(%params)

Returns the number of tracks the user has scrobbled.

%params can contain from and to keys, as documented here.

tracks(%params)

Returns a Data::Stream::Bulk object, which will stream the entire list of tracks that the user has scrobbled. Note that calling all on this object is not recommended, since you will likely hit the last.fm API's rate limit. Each call to next on this stream will require a separate API call.

%params can contain page, limit, from, and to keys, as documented here. page will default to 1 and limit will default to 200 if not specified.

Returns

BUGS ^

No known bugs.

Please report any bugs through RT: email bug-lastfm-export at rt.cpan.org, or browse to http://rt.cpan.org/NoAuth/ReportBug.html?Queue=LastFM-Export.

SEE ALSO ^

Net::LastFM

http://last.fm/

SUPPORT ^

You can find this documentation for this module with the perldoc command.

    perldoc LastFM::Export

You can also look for information at:

AUTHOR ^

Jesse Luehrs <doy at tozt dot net>

COPYRIGHT AND LICENSE ^

This software is copyright (c) 2012 by Jesse Luehrs.

This is free software; you can redistribute it and/or modify it under the same terms as the Perl 5 programming language system itself.

syntax highlighting: