The Perl Toolchain Summit needs more sponsors. If your company depends on Perl, please support this very important event.

NAME

WebService::Jamendo::RSS - Perl extension for the Web::Service::Jamendo::RSS name space. Can be use to download and process all XML-formatted RSS feeds provided by the popular site jamendo.com.

ABSTRACT

WebService::Jamendo::RSS will download and process XML-formatted RSS feeds provided by jamendo.com.

SYNOPSIS

   use warnings;
   use strict;
   use WebService::Jamendo::RSS qw(
                get_popular_albums_this_week get_latest_albums get_latest_albums_usa get_this_week_most_100_listened_to
                get_jamendo_blog get_jamendo_forums download_popular_albums_this_week_xml get_jamendo_news
                download_latest_albums_xml download_latest_albums_usa_xml download_this_week_most_100_listened_to_xml
                download_jamendo_blog_xml download_jamendo_forums_xml download_jamendo_news_xml
                );

DESCRIPTION

WebService::Jamendo::RSS provides methods to download all XML-formatted RSS feeds provided by jamendo.com and then return a data structure to the user containing the Data from the RSS feeds.

The following methods will download RSS feeds from jamendo.com to directory where RSS.pm is installed. Method download_popular_albums_this_week_xml will download RSS feed for popular albums this week. Method download_latest_albums_xml will download RSS feed for latest albums. Method download_latest_albums_usa_xml will download RSS feed for latest albums in the USA. Method download_this_week_most_100_listened_xml will download RSS feed for most 100 listened albums this week. Method download_jamendo_blog_xml will download RSS feed for Jamendo's primary blog. Method download_jamendo_forums_xml will download RSS feed for Jamendo's forums. Method download_jamendo_news_xml will download Jamendo's RSS news feed.

The following methods will process all RSS feeds provided by jamendo.com. Method get_popular_albmus_this_week returns a list of popular albums this week to the user. Method get_latest_albmus returns a list of latest albums to the user. Method get_latest_albums_usa returns a list of latest albums in the USA to the user. Method get_this_week_most_100_listened returns a list of most 100 listened albums this week to the user. Method get_jamendo_blog returns a list of updates for Jamendo's primary blog to the user. Method get_jamendo_forums_feeds returns a list of updates for Jamendo's forums to the user. Method get_jamendo_news

Getting Started

The following code will download all the XML-formatted RSS feeds provided by jamendo.com, process their content, and print the results for the user.

    use warnings;
    use strict;
    use WebService::Jamendo::RSS qw(
                get_popular_albums_this_week get_latest_albums get_latest_albums_usa get_this_week_most_100_listened_to
                get_jamendo_blog get_jamendo_forums download_popular_albums_this_week_xml get_jamendo_news
                download_latest_albums_xml download_latest_albums_usa_xml download_this_week_most_100_listened_to_xml
                download_jamendo_blog_xml download_jamendo_forums_xml download_jamendo_news_xml
                );

  download_popular_albums_this_week_xml();
  get_popular_albums_this_week();

  download_latest_albums_xml();
  get_latest_albums();

  download_latest_albums_usa_xml();
  get_latest_albums_usa();

  download_this_week_most_100_listened_to_xml();
  get_this_week_most_100_listened_to();

  download_jamendo_blog_xml();
  get_jamendo_blog();

  download_jamendo_forums_xml();
  get_jamendo_forums();

  download_jamendo_news_xml();
  get_jamendo_news();

The subroutine download_popular_albums_this_week_xml will download http://www.jamendo.com/en/rss/popular-albums to the directory where RSS.pm is installed.

The subroutine get_recent_videos will return a list of popular albums this week for the user.

download_latest_albums_xml

The subroutine download_latest_albums_xml will download http://www.jamendo.com/en/rss/last-albums to the directory where RSS.pm is installed.

get_latest_albums

The subroutine get_latest_albums will return a list of latest albums for the user.

download_latest_albums_usa_xml

The subroutine download_latest_albums_usa_xml will download http://www.jamendo.com/en/rss/last-albums/USA to the directory where RSS.pm is installed.

get_latest_albums_usa

The subroutine get_latest_albums_usa will return a list of latest albums in the USA for the user.

download_this_week_most_100_listened_to_xml

The subroutine download_this_week_most_100_listened_to_xml will download http://www.jamendo.com/en/rss/top-track-week to the directory where RSS.pm is installed.

get_this_week_most_100_listened_to

The subroutine get_this_week_most_100_listened_to will return a list of most 100 listened to albums this week to the user.

download_jamendo_blog_xml

The subroutine download_jamendo_blog_xml will download http://feeds.feedburner.com/JamendoBlogEnglish?format=xml to the directory where RSS.pm is installed.

get_jamendo_blog

The subroutine get_jamendo_blog will return a list of updates for Jamendo's primary blog.

download_jamendo_forums_xml

The subroutine download_jamendo_forums_xml will download http://www.jamendo.com/fr/forums/discussions/?Feed=RSS2 to the directory where RSS.pm is installed.

get_jamendo_forums

The subroutine get_jamendo_forums will return a list of updates for Jamendo's forums for the user.

download_jamendo_news_xml

The subroutine download_jamendo_news_xml will download http://www.jamendo.com/en/rss/newsfeed/bf0b52ca330f6ca9e88801e3f0c26c68775909 to the directory where RSS.pm is installed.

get_jamendo_news

The subroutine get_jamendo_news will return a list of updates for Jamendo's news feed.

SEE ALSO

Please see the documentation for the Perl modules XML::Twig an LWP::Simple for details on how WebService::Jamendo::RSS downloads and processes the XML-formatted RSS feeds provided by jamendo.com.

Please send all bug reports to the maintainer's email address hevenerg {[at]} marshall {[dot]} edu.

AUTHOR

WebService::Jamendo::RSS was written and is currently maintained by Gerald L. Hevener, M.S..

COPYRIGHT AND LICENSE

Copyright (C) 2009 by Gerald L. Hevener, M.S. <hevenerg {[at]} marshall {[dot]} edu.

This library is free software; you can redistribute it and/or modify it under the same terms as Perl itself, either Perl version 5.10.1 or, at your option, any later version of Perl 5 you may have available.

DISCLAIMER OF WARRENTY

BECAUSE THIS SOFTWARE IS LICENSED FREE OF CHARGE, THERE IS NO WARRANTY FOR THE SOFTWARE, TO THE EXTENT PERMITTED BY APPLICABLE LAW. EXCEPT WHEN OTHERWISE STATED IN WRITING THE COPYRIGHT HOLDERS AND/OR OTHER PARTIES PROVIDE THE SOFTWARE "AS IS" WITHOUT WARRANTY OF ANY KIND, EITHER EXPRESSED OR IMPLIED, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE. THE ENTIRE RISK AS TO THE QUALITY AND PERFORMANCE OF THE SOFTWARE IS WITH YOU. SHOULD THE SOFTWARE PROVE DEFECTIVE, YOU ASSUME THE COST OF ALL NECESSARY SERVICING, REPAIR, OR CORRECTION.

IN NO EVENT UNLESS REQUIRED BY APPLICABLE LAW OR AGREED TO IN WRITING WILL ANY COPYRIGHT HOLDER, OR ANY OTHER PARTY WHO MAY MODIFY AND/OR REDISTRIBUTE THE SOFTWARE AS PERMITTED BY THE ABOVE LICENCE, BE LIABLE TO YOU FOR DAMAGES, INCLUDING ANY GENERAL, SPECIAL, INCIDENTAL, OR CONSEQUENTIAL DAMAGES ARISING OUT OF THE USE OR INABILITY TO USE THE SOFTWARE (INCLUDING BUT NOT LIMITED TO LOSS OF DATA OR DATA BEING RENDERED INACCURATE OR LOSSES SUSTAINED BY YOU OR THIRD PARTIESOR A FAILURE OF THE SOFTWARE TO OPERATE WITH ANY OTHER SOFTWARE), EVEN IF SUCH HOLDER OR OTHER PARTY HAS BEEN ADVISED OF THE POSSIBILITY OF SUCH DAMAGES.