NAME
WWW::EchoNest - Perl module for accessing the Echo Nest API.
VERSION
Version 0.01.
SYNOPSIS
Top-level module in the WWW::EchoNest::* hierarchy.
Provides convenience functions for creating all of the
other WWW::EchoNest::* modules, and serves as a
repository for information (of interest to developers only)
about the various API's and their relationships to one
another (Echo Nest Web API <--> PyEchonest API <-->
WWW::EchoNest API).FUNCTIONS
object_list
Get a list of the objects for which WWW::EchoNest provides convenience functions.
ARGUMENTS:
none
RETURNS:
A list of object names.
EXAMPLE:
use WWW::EchoNest;
my @object_list = WWW::EchoNest::object_list;get_artist
Convenience function for creating Artist objects.
ARGUMENTS:
See the documentation for WWW::EchoNest::Artist.
$ perldoc WWW::EchoNest::Artist
RETURNS:
A new instance of WWW::EchoNest::Artist.
EXAMPLE:
use WWW::EchoNest qw{ artist };
my $artist = artist( q{The Residents} );
# ...get_catalog
Convenience function for creating Catalog objects.
ARGUMENTS:
See the documentation for WWW::EchoNest::Catalog.
$ perldoc WWW::EchoNest::Catalog
RETURNS:
A new instance of WWW::EchoNest::Catalog.
EXAMPLE:
use WWW::EchoNest qw{ catalog };
my $catalog = catalog( { name => q(my_songs), type => q(songs) } );
# ...get_config
Convenience function for creating Config objects.
ARGUMENTS:
See the documentation for WWW::EchoNest::Config.
$ perldoc WWW::EchoNest::Config
RETURNS:
A new instance of WWW::EchoNest::Config.
EXAMPLE:
use WWW::EchoNest qw{ config };
use WWW::EchoNest::Config qw{ set_api_key };
my $config = config( { name => q(my_songs), type => q(songs) } );
# ...get_playlist
Convenience function for creating Playlist objects.
ARGUMENTS:
See the documentation for WWW::EchoNest::Playlist.
$ perldoc WWW::EchoNest::Playlist
RETURNS:
A new instance of WWW::EchoNest::Playlist.
EXAMPLE:
use WWW::EchoNest qw{ playlist };
my $playlist = playlist( { name => q(my_songs), type => q(songs) } );
# ...get_song
Convenience function for creating Song objects.
ARGUMENTS:
See the documentation for WWW::EchoNest::Song.
$ perldoc WWW::EchoNest::Song
RETURNS:
A new instance of WWW::EchoNest::Song.
EXAMPLE:
use WWW::EchoNest qw{ song };
my $catalog = catalog( { name => q(my_songs), type => q(songs) } );
# ...get_track
Convenience function for creating Track objects.
ARGUMENTS:
See the documentation for WWW::EchoNest::Track.
$ perldoc WWW::EchoNest::Track
RETURNS:
A new instance of WWW::EchoNest::Track.
EXAMPLE:
use WWW::EchoNest qw{ track };
my $catalog = catalog( { name => q(my_songs), type => q(songs) } );
# ...AUTHOR
Brian Sorahan, <bsorahan@gmail.com>
SUPPORT
You can find documentation for this module with the perldoc command.
perldoc WWW::EchoNest
Join the Google group: <http://groups.google.com/group/www-echonest>
ACKNOWLEDGEMENTS
Thanks to all the folks at The Echo Nest for providing access to their powerful API.
LICENSE AND COPYRIGHT
Copyright 2011 Brian Sorahan.
This program is free software; you can redistribute it and/or modify it under the terms of either: the GNU General Public License as published by the Free Software Foundation; or the Artistic License.
See http://dev.perl.org/licenses/ for more information.