POE::Test::Loops(3pm)					User Contributed Perl Documentation				     POE::Test::Loops(3pm)

NAME

       POE::Test::Loops - Reusable tests for POE::Loop authors

SYNOPSIS

	       #!/usr/bin/perl -w

	       use strict;
	       use Getopt::Long;
	       use POE::Test::Loops;

	       my ($dir_base, $flag_help, @loop_modules, $flag_verbose);
	       my $result = GetOptions(
		       'dirbase=s' => $dir_base,
		       'loop=s' => @loop_modules,
		       'verbose' => $flag_verbose,
		       'help' => $flag_help,
	       );

	       if (
		       !$result or !$dir_base or $flag_help or !@loop_modules
	       ) {
		       die(
			       "$0 usage:
",
			       "  --dirbase DIR   (required) base directory for tests
",
			       "  --loop MODULE   (required) loop modules to test
",
			       "  --verbose   show some extra output
",
			       "  --help   you're reading it
",
		       );
	       }

	       POE::Test::Loops::generate($dir_base, @loop_modules, $flag_verbose);
	       exit 0;

DESCRIPTION

       POE::Test::Loops contains one function, generate(), which will generate all the loop tests for one or more POE::Loop subclasses.

       The "SYNOPSIS" example is a version of poe-gen-tests, which is a stand-alone utility to generate the actual tests.  poe-gen-tests also
       documents the POE::Test::Loops system in more detail.

FUNCTIONS

   generate( $DIRBASE, @LOOPS, $VERBOSE )
       Generates the loop tests.  DIRBASE is the (relative) directory in which a subdirectory for each of the LOOPS is created.  If VERBOSE is set
       to a TRUE value some progress reporting is printed.

	       POE::Test::Loops::generate(
		       "./t",
		       [ "POE::Loop::Yours" ],
		       1,
	       );

SEE ALSO

       POE::Loop and poe-gen-tests.

AUTHOR &; COPYRIGHT
       See poe-gen-tests.

perl v5.14.2							    2012-03-11						     POE::Test::Loops(3pm)