Parrot::Configure::Options::Test 0.5.2

Parrot::Configure::Options::Test is a Perl module used to run configuration and build tests along with Configure.pl.

SYNOPSIS

In Configure.pl:
use Parrot::Configure::Options;
use Parrot::Configure::Options::Test;

$args = process_options( {
argv => [ @ARGV ],
mode => q{configure},
} );

$opttest = Parrot::Configure::Options::Test->new($args);

$opttest->run_configure_tests();

$opttest->run_build_tests();
On command line:
# run tests of configuration tools, then configure
perl Configure.pl --test=configure

# configure, then run tests of build tools
perl Configure.pl --test=build

# run tests of configuration tools, then configure,
# then run tests of build tools
perl Configure.pl --test

Test suites have been constructed which test those of Parrot's configuration and build tools that are written in Perl 5. These tests are not necessarily run when you invoke make test. In any event, running these tests as part of make test is, in a certain sense, running them too late. If you have successfully called Configure.pl and make, you have implicitly demonstrated that the configuration and build tools work (for the most part), so running tests of those tools post-make is somewhat redundant.

On the other hand, tests of the configuration tools are meaningful if run before Configure.pl is invoked and, similarly, tests of the build tools are meaningful if run before make is invoked. Parrot::Configure::Options::Test provides functionality for running such tests.

SUBROUTINES

new()

Purpose
Parrot::Configure::Options::Test constructor.
Arguments
One argument: The hash reference which is the return value of Parrot::Configure::Options::process_options().
Return Value
Parrot::Configure::Options::Test object.
Comment

run_configure_tests()

Purpose
Run tests of Parrot's configuration tools.
Arguments
None.
Return Value
None.
Comments
The tests to be executed are listed in @Parrot::Configure::Options::Test::preconfiguration_tests. Edit that list to run different tests. Currently, that array runs all tests in t/configure/*.t.

run_build_tests()

Purpose
Run tests of Parrot's build tools. Also, run tests of certain aspects of the configuration process which, for legacy reasons, must run after Configure.pl has completed execution.
Arguments
None.
Return Value
None.
Comments
The tests to be executed are listed in @Parrot::Configure::Options::Test::postconfiguration_tests. Edit that list to run different tests. Currently, that array runs all tests in:

t/postconfigure/*.t
t/tools/pmc2cutils/*.t
t/tools/ops2cutils/*.t
t/tools/ops2pmutils/*.t

Product's homepage

Requirements:

· Perl