NAME

LastFM::Export - data exporter for last.fm

VERSION

version 0.03

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 to GitHub Issues at https://github.com/doy/lastfm-export/issues.

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@tozt.net>

COPYRIGHT AND LICENSE

This software is Copyright (c) 2014 by Jesse Luehrs.

This is free software, licensed under:

The MIT (X11) License