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.