NAME

CPAN::YACSmoke::Plugin::WebList - WebList plugin for CPAN::YACSmoke

SYNOPSIS

  use CPAN::YACSmoke;
  my $config = {
      list_from => 'WebList', 
      webpath => 'http://my.web.list/' # defaults to KobeSearch site
  };
  my $foo = CPAN::YACSmoke->new(config => $config);
  my @list = $foo->download_list();

DESCRIPTION

This module provides the backend ability to access the list of current modules from the 'recent uploads to CPAN' web pages available. Note the default is to access KobeSearch.

This module should be use together with CPAN::YACSmoke.

The WebList plugin accesses a formatted webpage to return the current list of distributions. The current pages which provide this list in correct format are cycled through, unless a specific webpage is requested.

Currently used webpages:

  http://cpan.uwinnipeg.ca/recent

Note that the following webpages do not provide a 'download' link, which can identify the exact distribution. Further checking may be added in the future.

  http://search.cpan.org/recent
  http://use.perl.org/modulelist/

CONSTRUCTOR

new()

Creates the plugin object.

METHODS

download_list()

Return the list of distributions recorded on the designated latest recent webpage.

CAVEATS

This is a proto-type release. Use with caution and supervision.

The current version has a very primitive interface and limited functionality. Future versions may have a lot of options.

There is always a risk associated with automatically downloading and testing code from CPAN, which could turn out to be malicious or severely buggy. Do not run this on a critical machine.

This module uses the backend of CPANPLUS to do most of the work, so is subject to any bugs of CPANPLUS.

SUPPORT

There are no known bugs at the time of this release. However, if you spot a bug or are experiencing difficulties that are not explained within the POD documentation, please submit a bug to the RT system (see link below). However, it would help greatly if you are able to pinpoint problems or even supply a patch.

Fixes are dependant upon their severity and my availablity. Should a fix not be forthcoming, please feel free to (politely) remind me by sending an email to barbie@cpan.org .

RT: http://rt.cpan.org/Public/Dist/Display.html?Name=CPAN-YACSmoke-Plugin-WebList

SEE ALSO

The CPAN Testers Website at http://testers.cpan.org has information about the CPAN Testing Service.

For additional information, see the documentation for these modules:

  CPANPLUS
  Test::Reporter
  CPAN::YACSmoke

DSLIP

  b - Beta testing
  d - Developer
  p - Perl-only
  O - Object oriented
  p - Standard-Perl: user may choose between GPL and Artistic

AUTHOR

Barbie <barbie@cpan.org> for Miss Barbell Productions http://www.missbarbell.co.uk.

COPYRIGHT AND LICENSE

  Copyright (C) 2005-2007 Barbie for Miss Barbell Productions.

  This library is free software; you can redistribute it and/or 
  modify it under the same terms as Perl itself.

The full text of the licenses can be found in the Artistic file included with this distribution, or in perlartistic file available with your Perl installation.

cpanm CPAN::YACSmoke::Plugin::WebList

perl -MCPAN -e shell
install CPAN::YACSmoke::Plugin::WebList