NAME

CPAN::YACSmoke::Plugin::PlainTextList - Plain text file plugin for CPAN::YACSmoke

SYNOPSIS

  use CPAN::YACSmoke;
  my $config = {
      list_from => 'PlainTextList', 
      data => 'datafile.txt'
  };
  my $foo = CPAN::YACSmoke->new(config => $config);
  my @list = $foo->download_list();

DESCRIPTION

This module provides the backend ability to access a list of current distributions available for testing, in a plain text data file. Each distribution should appear on a separate line, with the complete CPAN author name path, eg:

  B/BA/BARBIE/CPAN-YACSmoke-Plugin-PlainTextList-0.01

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

CONSTRUCTOR

new()

Creates the plugin object.

METHODS

download_list()

Return the list of distributions within the data file.

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.

BUGS, PATCHES & FIXES

There are no known bugs at the time of this release. However, if you spot a bug or are experiencing difficulties, that is not explained within the POD documentation, please send an email to barbie@cpan.org or submit a bug to the RT system (http://rt.cpan.org/). 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.

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 Barbie for Miss Barbell Productions.
  All Rights Reserved.

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