NAME
Net::iTMS - Low(ish)-level interface to the iTunes Music Store (iTMS)
SYNOPSIS
use Net::iTMS;
my $iTMS = Net::iTMS->new;
my $results = $iTMS->search_for('Elliott Smith');
my %tracklist = %{$results->TrackList};
# See the Net::iTMS::XML doc for other methodsDESCRIPTION
Net::iTMS is a low-but-not-too-low-level interface to the iTunes Music Store. It handles the fetching, decrypting, and uncompressing of content as well as provides a few convenience methods.
Further development will most likely include more convenience methods for common tasks. If there is a method you'd particularly like to see, contact me (see website in AUTHOR section) about it, and I'll consider writing it.
Patches are welcome. : )
Methods
All methods return undef on error and (should) set an error message, which is available through the error method. (Unless I note otherwise.)
Nota Bene: Most of information-fetching methods return, by default, a Net::iTMS::XML object which can be used to selectively extract information from the XML. If a different XML "parser" is in use, the return value could be something totally different.
new([ debug => 1, [...] ])-
Takes an argument list of
key =value> pairs. The options available are:tmpdir => '/some/path'-
Used to specify the path to the directory where temporary files should be created. Default's to File::Temp's default.
debug => 0 or 1-
If set to a true value, debug messages to be printed to STDERR.
parser => 'Foo::Bar'-
"Parser" to use in place of the default Net::iTMS::XML. Don't change this unless you know what you're doing.
Returns a blessed hashref (object) for Net::iTMS.
search_for($terms)-
Does a simple search of the catalog.
get_album($albumId)-
Takes an albumId and fetches the album information page.
get_artist($artistId)-
Takes an artistId and fetches the artist information page.
get_biography($artistId)-
Takes an artistId and fetches the artist's iTMS biography, if there is one.
get_influencers($artistId)-
Takes an artistId and fetches the artist's iTMS influencers, if there are any.
get_artist_albums($artistId)-
Takes an artistId and fetches all the albums (really a browseArtist request).
fetch_iTMS_info($url, [ gunzip => 1, decrypt => 0 ])-
This is one of the lower-level methods used mostly internally for convenience. Still, it might be of use to implement something I haven't thought of.
It takes a URL (that should be for the iTMS) as the first argument and an optional hashref of options as the second argument. The available options are:
gunzip => 0 or 1-
A true value means the (presumably) gzipped content is gunzipped. A false value means it is not.
Default is 1 (unzip content).
decrypt => 0, 1, or 2-
A true value other than 2 means the content retrieved from the URL is first decrypted after fetching if it appears to be encrypted (that is, if no initialization vector was passed as a response header for the request). A false value means no decryption is done at all. A value of 2 means decryption will be forced no matter what.
Default is 1 ("intelligent" decrypt), which should work for most, if not all, cases.
error-
Returns a string containing an error message (if there is one). Usually useful after a method has returned
undeffor finding out what went wrong.
LICENSE
Copyright 2004, Thomas R. Sibley.
This work is licensed under the Creative Commons Attribution-NonCommercial-ShareAlike License. To view a copy of this license, visit http://creativecommons.org/licenses/by-nc-sa/1.0/ or send a letter to:
Creative Commons
559 Nathan Abbott Way
Stanford, California 94305, USA.AUTHOR
Thomas R. Sibley, http://zulutango.org:82/