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:\n",
                               "  --dirbase DIR   (required) base directory for tests\n",
                               "  --loop MODULE   (required) loop modules to test\n",
                               "  --verbose   show some extra output\n",
                               "  --help   you're reading it\n",
                       );
               }

               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.