WebService::Audioscrobbler::Tag - An object-oriented interface to the Audioscrobbler WebService API
This module implements an object oriented abstraction of a tag within the Audioscrobbler database.
use WebService::Audioscrobbler::Tag; my $ws = WebService::Audioscrobbler->new; # get an object for the tag named 'foo' my $tag = $ws->tag('foo'); # retrieves tracks tagged with 'foo' my @tracks = $tag->tracks; # prints url for viewing aditional tag info print $tag->url;
This module inherits from WebService::Audioscrobbler::Base.
name
title
The name (title) of a given tag.
url
URL for aditional info about the tag.
new($name, $data_fetcher)
new(\%fields)
Creates a new object using either the given $artist and $title or the \%fields hashref. The data fetcher object is a mandatory parameter and must be provided either as the second parameter or inside the \%fields hashref.
$artist
$title
\%fields
tracks
Retrieves the tags's top tracks as available on Audioscrobbler's database.
Returns either a list of tracks or a reference to an array of tracks when called in list context or scalar context, respectively. The tracks are returned as WebService::Audioscrobbler::Track objects by default.
artists
Retrieves the tag's top artists as available on Audioscrobbler's database.
Returns either a list of artists or a reference to an array of artists when called in list context or scalar context, respectively. The tags are returned as WebService::Audioscrobbler::Artist objects by default.
resource_path
Returns the URL from which other URLs used for fetching tag info will be derived from.
Nilson Santos Figueiredo Junior, <nilsonsfj at cpan.org>
<nilsonsfj at cpan.org>
Copyright 2006-2007 Nilson Santos Figueiredo Junior, all rights reserved.
This program is free software; you can redistribute it and/or modify it under the same terms as Perl itself.
To install WebService::Audioscrobbler, copy and paste the appropriate command in to your terminal.
cpanm
cpanm WebService::Audioscrobbler
CPAN shell
perl -MCPAN -e shell install WebService::Audioscrobbler
For more information on module installation, please visit the detailed CPAN module installation guide.