Module::Install::ExtraTests(3pm)

Module::Install::ExtraTests3pm

Contextual tests that the harness can ignore

Version

0.008

Commands

This plugin adds one Module::Install command:

extra_tests

  extra_tests;

This declares that the test files found in the directory ./xt should be run only in certain instances:

  ./xt/author  - run when the tests are being run in an author's working copy
  ./xt/smoke   - run when the dist is being smoked (AUTOMATED_TESTING=1)
  ./xt/release - run during "make disttest"

These directories are recurisvely scanned for *.t files. If any directories or files exist in ./xt that are not recognized, the Makefile.PL will die.

Achtung! This is pretty scary, experimental code, mostly because it relies on the pretty scary, non-experimental-but-seriously-sketchy underlying customization system for ExtUtils::MakeMaker. I may remove this warning when I've decided that this is stable enough, but until then:

  HIC SUNT DRACONES

Author tests

"Is this being run by an author?" is determined internally by Module::Install, but at the time of the writing of this version it's determined by the existence of a directory called .author in ./inc. (On VMS, it's _author.) This directory is created when Module::Install's Makefile.PL is run in a directory where no ./inc directory exists.

Releases

6 releases since Debian 8 (Jessie); the text changed 3 times.

  1. 8–9
  2. 10–11
  3. 12
  4. 13

Bugs

Please report any bugs or feature requests through the web interface at <http://rt.cpan.org>. I will be notified, and then you'll automatically be notified of progress on your bug as I make changes.

From libmodule-install-extratests-perl 0.008-4 in Debian 13 (Trixie). Parsed by carta from the page's man source.