Module::Install::ExtraTests - contextual tests that the harness can ignore
This plugin adds one Module::Install command:
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
"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.
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.
Copyright 2008, Ricardo SIGNES. This program is free software; you can redistribute it and/or modify it under the same terms as Perl itself.
To install Module::Install::ExtraTests, copy and paste the appropriate command in to your terminal.
perl -MCPAN -e shell
For more information on module installation, please visit the detailed CPAN module installation guide.