Net::iTMS::Artist

Net::iTMS::Artist module represents an artist in the iTunes Music Store.
Download

Net::iTMS::Artist Ranking & Summary

Advertisement

  • Rating:
  • License:
  • Perl Artistic License
  • Price:
  • FREE
  • Publisher Name:
  • Thomas R. Sibley
  • Publisher web site:
  • http://search.cpan.org/~tsibley/Net-iTMS-0.15/lib/Net/iTMS/Song.pm

Net::iTMS::Artist Tags


Net::iTMS::Artist Description

Net::iTMS::Artist module represents an artist in the iTunes Music Store. Net::iTMS::Artist module represents an artist in the iTunes Music Store.SYNOPSIS use Net::iTMS::Artist; my $artist = Net::iTMS::Artist->new($iTMS, $id); print "Artist: ", $artist->name, "n"; # $album will be a Net::iTMS::Album object for my $album ($artist->discography) { print $album->title, " (", $album->genre->name, ")n"; # $track will be a Net::iTMS::Song object for my $track ($album->tracks) { # also $album->songs print "t ", $track->number, ": ", $track->title, "n"; } }Net::iTMS::Artist represents an artist in the iTMS and encapsulates the associated data. If a piece of information hasn't been fetched from the iTMS, it will transparently fetch and store it for later use before returning.If one of the methods id, name, website, genre, path, selected_albums, or total_albums is called, the information for the others will be fetched in the same request. This means, for these methods, the first call to one will have a time hit for the HTTP request, but subsequent calls won't.MethodsAll methods return undef on error and (should) set an error message, which is available through the error method. (Unless I note otherwise.)new($itms, $artistId)The first argument must be an instance of Net::iTMS, the second an iTMS artist ID.Returns a blessed hashref (object) for Net::iTMS::Artist.idReturns the ID of the artist (artistId).nameReturns the name of the artist.websiteReturns the website URL of the artist (undef if there isn't one specified).genreReturns a Net::iTMS::Genre object representing the artist's primary genre.pathReturns an arrayref of hashrefs representing the artist's "path" in the iTMS. The hashrefs contain the name of the node in the path and the iTMS URL of that node.For example, Elliott Smith's (id = 2893902) "path" is "Alternative > Elliott Smith", which is represented in Perl by: # URLs trimmed for example This is pretty much only useful if you're trying to imitate the iTunes interface.best_sellersReturns an array or arrayref (depending on context) of Net::iTMS::Album objects for a selection of the best selling albums by the artist.discography albumsReturns an array or arrayref (depending on context) of Net::iTMS::Album objects for all the albums of the artist available on the iTMS.biographyReturns an array or arrayref (depending on context) where each element is a paragraph in the artist's iTMS bio.Optionscreate_album_links => '/some/url?id='If this option is set, iTMS links to albums within the bio will be translated into HTML links. The albumId is prepended to the URL passed as the value of the option.The default is to simply ignore the links, leaving the plain text title.influencesReturns an array or arrayref (depending on context) of Net::iTMS::Album objects for the albums/artists which influenced the artist, according to the iTMS. Requirements: · Perl


Net::iTMS::Artist Related Software