Help-Site Computer Manuals
Software
Hardware
Programming
Networking
  Algorithms & Data Structures   Programming Languages   Revision Control
  Protocols
  Cameras   Computers   Displays   Keyboards & Mice   Motherboards   Networking   Printers & Scanners   Storage
  Windows   Linux & Unix   Mac

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

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


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 the WebService::Audioscrobbler::Base manpage.


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 the WebService::Audioscrobbler::Track manpage 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 the WebService::Audioscrobbler::Artist manpage 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 Júnior, <nilsonsfj at cpan.org>


COPYRIGHT & LICENSE

Copyright 2006-2007 Nilson Santos Figueiredo Júnior, all rights reserved.

This program is free software; you can redistribute it and/or modify it under the same terms as Perl itself.

Programminig
Wy
Wy
yW
Wy
Programming
Wy
Wy
Wy
Wy