/ 
LastFM-Export-0.02
River stage one • 1 direct dependent • 1 total dependent
⭐ Starred 3 GitHub stars
/ LastFM::Export

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.