NAME

Module::Install::ExtendsMakeTest - Assembles test targets for `make` with code snippets

SYNOPSIS

inside Makefile.PL:

  use inc::Module::Install;
  tests 't/*t';
  
  # create a new test target
  extends_make_test(
      includes           => ["$ENV{HOME}/perl5/lib"],
      modules            => [qw/Foo Bar/],
      before_run_scripts => [qw/before.pl/],
      after_run_scripts  => [qw/after.pl/],
      before_run_codes   => ['print "start -> ", scalar localtime, "\n"'],
      after_run_codes    => ['print "end   -> ", scalar localtime, "\n"'],
      tests              => ['t/baz/*t'],
      env                => { PERL_ONLY => 1 },
      target             => 'foo',     # create make foo target
      alias              => 'testall', # make testall is run the make foo
  );

maybe make foo is:

  perl "-MExtUtils::Command::MM" "-I/home/xaicron/perl5/lib" "-MFoo" "-MBar" "-e" "do 'before.pl'; sub { print \"start -> \", scalar localtime, \"\n\" }->(); test_harness(0, 'inc'); do 'after.pl'; sub { print \"end -> \", scalar localtime, \"\n\" }->();" t/baz/*t

DESCRIPTION

Module::Install::ExtendsMakeTest creates make test variations with code snippets. This helps module developers to test their distributions with various conditions, e.g. under PERL_ONLY=1 or the control of some testing modules.

FUNCTIONS

extends_make_test(%args)

Defines a new test target with %args.

%args are:

includes => \@include_paths

Sets include paths.

  extends_make_test(
      includes => ['/path/to/inc'],
  );

  # `make test` will be something like this:
  perl -I/path/to/inc  -MExtUtils::Command::MM -e "test_harness(0, 'inc')" t/*t

modules => \@module_names

Sets modules which are loaded before running test_harness().

  extends_make_test(
      modules => ['Foo', 'Bar::Baz'],
  );
  
  # `make test` will be something like this:
  perl -MFoo -MBar::Baz -MExtUtils::Command::MM -e "test_harness(0, 'inc')" t/*t

before_run_script => \@scripts

Sets scripts to run before running test_harness().

  extends_make_test(
      before_run_script => ['tool/before_run_script.pl'],
  );
  
  # `make test` will be something like this:
  perl -MExtUtils::Command::MM -e "do 'tool/before_run_script.pl; test_harness(0, 'inc')" t/*t

after_run_script => \@scripts

Sets scripts to run after running test_harness().

  use inc::Module::Install;
  tests 't/*t';
  extends_make_test(
      after_run_script => ['tool/after_run_script.pl'],
  );
  
  # `make test` will be something like this:
  perl -MExtUtils::Command::MM -e "test_harness(0, 'inc'); do 'tool/before_run_script.pl;" t/*t

before_run_codes => \@codes

Sets perl codes to run before running test_harness().

  use inc::Module::Install;
  tests 't/*t';
  extends_make_test(
      before_run_codes => ['print scalar localtime , "\n"', sub { system qw/cat README/ }],
  );
  
  # `make test` will be something like this:
  perl -MExtUtils::Command::MM "sub { print scalar localtme, "\n" }->(); sub { system 'cat', 'README' }->(); test_harness(0, 'inc')" t/*t

The perl codes runs before_run_scripts runs later.

after_run_codes => \@codes

Sets perl codes to run after running test_harness().

  use inc::Module::Install;
  tests 't/*t';
  extends_make_test(
      after_run_codes => ['print scalar localtime , "\n"', sub { system qw/cat README/ }],
  );
  
  # `make test` will be something like this:
  perl -MExtUtils::Command::MM "test_harness(0, 'inc'); sub { print scalar localtme, "\n" }->(); sub { system 'cat', 'README' }->();" t/*t

The perl codes runs after_run_scripts runs later.

target => $name

Sets a new make target of the test.

  use inc::Module::Install;
  tests 't/*t';
  extends_make_test(
      before_run_script => 'tool/force-pp.pl',
      target            => 'test_pp',
  );
  
  # `make test_pp` will be something like this:
  perl -MExtUtils::Command::MM -e "do 'tool/force-pp.pl'; test_harness(0, 'inc')" t/*t

alias => $name

Sets an alias of the test.

  extends_make_test(
      before_run_script => 'tool/force-pp.pl',
      target            => 'test_pp',
      alias             => 'testall',
  );
  
  # `make test_pp` and `make testall` will be something like this:
  perl -MExtUtils::Command::MM -e "do 'tool/force-pp.pl'; test_harness(0, 'inc')" t/*t

env => \%env

Sets environment variables.

  extends_make_test(
      env => {
          FOO => 'bar',
      },
  );
  
  # `make test` will be something like this:
  perl -MExtUtils::Command::MM -e "\$ENV{q{FOO}} = q{bar}; test_harness(0, 'inc')" t/*t

tests => \@test_files

Sets test files to run.

  extends_make_test(
      tests  => ['t/foo.t', 't/bar.t'],
      env    => { USE_FOO => 1 },
      target => 'test_foo',
  );

  # `make test_foo` will be something like this:
  perl -MExtUtils::Command::MM -e "$ENV{USE_FOO} = 1 test_harness(0, 'inc')" t/foo.t t/bar.t

replace_default_make_test(%args)

Override the default `make test` with %args.

Same argument as extends_make_test(), but `target` and `alias` are not allowed.

AUTHOR

Yuji Shimada <xaicron {at} cpan.org>

Goro Fuji (gfx) <gfuji at cpan.org>

SEE ALSO

Module::Install

LICENSE

This library is free software; you can redistribute it and/or modify it under the same terms as Perl itself.