NAME

       ExtUtils::ModuleMaker::Auxiliary - Subroutines for testing ExtUtils::ModuleMaker

DESCRIPTION

       This package contains subroutines used in one or more t/*.t files in
       ExtUtils::ModuleMaker's test suite.  They may prove useful in writing test suites for
       distributions which subclass ExtUtils::ModuleMaker.

SUBROUTINES

   "read_file_string()"
           Function:   Read the contents of a file into a string.
           Argument:   String holding name of a file created by complete_build().
           Returns:    String holding text of the file read.
           Used:       To see whether text of files such as README, Makefile.PL,
                       etc. was created correctly by returning a string against which
                       a pattern can be matched.

   "read_file_array()"
           Function:   Read a file line-by-line  into an array.
           Argument:   String holding name of a file created by complete_build().
           Returns:    Array holding the lines of the file read.
           Used:       To see whether text of files such as README, Makefile.PL,
                       etc. was created correctly by returning an array against whose
                       elements patterns can be matched.

   "five_file_tests()"
           Function:   Verify that content of MANIFEST and lib/*.pm were created
                       correctly.
           Argument:   Two arguments:
                       1.  A number predicting the number of entries in the MANIFEST.
                       2.  A reference to an array holding the components of the module's name, e.g.:
                           [ qw( Alpha Beta Gamma ) ].
           Returns:    n/a.
           Used:       To see whether MANIFEST and lib/*.pm have correct text.
                       Runs 6 Test::More tests:
                       1.  Number of entries in MANIFEST.
                       2.  Change to directory under lib.
                       3.  Applies read_file_string to the stem.pm file.
                       4.  Determine whether stem.pm's POD contains module name and
                           abstract.
                       5.  Determine whether POD contains a HISTORY head.
                       6.  Determine whether POD contains correct author information.

   "check_MakefilePL()"
           Function:   Verify that content of Makefile.PL was created correctly.
           Argument:   Two arguments:
                       1.  A string holding the directory in which the Makefile.PL
                           should have been created.
                       2.  A reference to an array holding strings each of which is a
                           prediction as to content of particular lines in Makefile.PL.
           Returns:    n/a.
           Used:       To see whether Makefile.PL created by complete_build() has
                       correct entries.  Runs 1 Test::More test which checks NAME,
                       VERSION_FROM, AUTHOR and ABSTRACT.

SEE ALSO

       ExtUtils::ModuleMaker.