NAME

MakeMaker::Test::Utils - Utility routines for testing MakeMaker

SYNOPSIS

use MakeMaker::Test::Utils;

my $perl     = which_perl;
perl_lib;

my $makefile      = makefile_name;
my $makefile_back = makefile_backup;

my $make          = make;
my $make_run      = make_run;
make_macro($make, $targ, %macros);

my $mtime         = calibrate_mtime;

my $out           = run($cmd);

DESCRIPTION

A consolidation of little utility functions used through out the MakeMaker test suite.

Functions

The following are exported by default.

which_perl

my $perl = which_perl;

Returns a path to perl which is safe to use in a command line, no matter where you chdir to.

perl_lib

perl_lib;

Sets up environment variables so perl can find its libraries.

makefile_name

my $makefile = makefile_name;

MakeMaker doesn't always generate 'Makefile'. It returns what it should generate.

makefile_backup

my $makefile_old = makefile_backup;

Returns the name MakeMaker will use for a backup of the current Makefile.

make

my $make = make;

Returns a good guess at the make to run.

make_run

my $make_run = make_run;

Returns the make to run as with make() plus any necessary switches.

make_macro

my $make_cmd = make_macro($make, $target, %macros);

Returns the command necessary to run $make on the given $target using the given %macros.

my $make_test_verbose = make_macro(make_run(), 'test', 
                                   TEST_VERBOSE => 1);

This is important because VMS's make utilities have a completely different calling convention than Unix or Windows.

%macros is actually a list of tuples, so the order will be preserved.

calibrate_mtime

my $mtime = calibrate_mtime;

When building on NFS, file modification times can often lose touch with reality. This returns the mtime of a file which has just been touched.

run

my $out = run($command);
my @out = run($command);

Runs the given $command as an external program returning at least STDOUT as $out. If possible it will return STDOUT and STDERR combined as you would expect to see on a screen.

AUTHOR

Michael G Schwern <schwern@pobox.com>