Jesse Luehrs > LastFM-Export > LastFM::Export

Download:
LastFM-Export-0.03.tar.gz

Dependencies

Annotate this POD

Website

View/Report Bugs
Module Version: 0.03   Source  

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
syntax highlighting: