WebService::Audioscrobbler::Tag(3p)

NAME
WebService::Audioscrobbler::Tag - An object-oriented interface to the Audioscrobbler WebService API

SYNOPSIS
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.

FIELDS

  "name"

  "title"
The name (title) of a given tag.

  "url"
URL for aditional info about the tag.

METHODS

  "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.

  "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.

AUTHOR
Nilson Santos Figueiredo Junior, "<nilsonsfj at cpan.org>"

COPYRIGHT & LICENSE
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.