CPAN-WWW-Testers

NAME

CPAN::WWW::Testers - Present CPAN Testers data

SYNOPSIS

      my $t = CPAN::WWW::Testers->new();
      $t->directory($directory);
      if($download) { $t->download($download); } 
      else          { $t->database($database); }
      $t->generate;

DESCRIPTION

This distribution generates the CPAN Testers Reports website.

CPAN TESTERS

cpan-testers is a group, that was originaly setup by Graham Barr and Chris Nandor.

The objective of the group is to test as many of the distributions available on CPAN as possible, on as many platforms as possible, with a variety of perl interpreters. The ultimate goal is to improve the portability of the distributions on CPAN, and provide good feedback to the authors.

CPAN Testers began as a mailing list with a web interface (see the NNTP website - http://nntp.x.perl.org/group/perl.cpan.testers/). Leon Brocard began working on extracting metadata for use with the CPANTS, and ended up creating the Reports website. This code now allows you to create and host your very own CPAN Testers website, should you so choose.

Unpack the distribution and look at examples/generate.pl, to understand how the site is generated. If you would like to send patches or report bugs, please use the RT system.

INTERFACE
The Constructor

new Instatiates the object CPAN::WWW::Testers.

Methods

directory Accessor to set/get the directory where the webpages are to be created.
database Accessor to set/get the local path to the SQLite database.
download Downloads a remote copy of the SQLite database containing the latest article updates from the NNTP server for the cpan-testers newgroup. The path to the local copy of the database is then provided to the database accessor.
generate Reads the local copy of the SQLite database, and creates the alphabetic index, distribution and main index web pages, together with the YAML and RSS pages for each distribution.

SEE ALSO

CPAN::WWW::Testers::Generator

AUTHORS

LICENSE

This code is distributed under the same license as Perl.

This distribution contains CSS code under the following license:

Software License Agreement (BSD License)

Redistribution and use of this software in source and binary forms, with or without modification, are permitted provided that the following conditions are met:

Redistributions of source code must retain the above copyright notice, this list of conditions and the following disclaimer.
Redistributions in binary form must reproduce the above copyright notice, this list of conditions and the following disclaimer in the documentation and/or other materials provided with the distribution.
Neither the name of Yahoo! Inc. nor the names of its contributors may be used to endorse or promote products derived from this software without specific prior written permission of Yahoo! Inc.

THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.