> dzil

Plugin Catalog - tests

These plugins involve tests for your distribution.

CheckExtraTestsby DAGOLDEN(also tagged: before-release, tests-extra)

This plugin ensures that the tests in the xt/ directory pass before allowing a release. It is a complement to the xtest command and an alternative to the ExtraTests and RunExtraTests plugins. (You should probably use RunExtraTests instead.)

EOLTestsby FLORA(also tagged: file-gatherer, tests-extra)

This adds xt/release/eol.t to your distribution, which is a standard Test::EOL test.

ExtraTestsby RJBS(also tagged: core, file-munger, tests-extra)

This plugin moves tests from the xt/ directory to the t/ directory and rewrites them to skip unless the appropriate environment variable is set during testing.

MakeMakerby RJBS(also tagged: core, install)

This plugin generates a standard Makefile.PL for your distribution. It also includes MakeMaker::Runner to build your distribution and run its tests.

MakeMaker::Runnerby RJBS(also tagged: core)

This is the part of the MakeMaker plugin that knows how to build your distribution and run its tests using Makefile.PL. You wouldn't normally include it directly.

MetaTestsby RJBS(also tagged: core, file-gatherer, tests-extra)

This adds xt/release/meta-yaml.t to your distribution, which is a standard Test::CPAN::Meta test.

ModuleBuildby RJBS(also tagged: core, file-gatherer, install)

This plugin generates a standard Build.PL for your distribution. It also knows how to build your distribution and run its tests using Build.PL.

PodCoverageTestsby RJBS(also tagged: core, file-gatherer, tests-extra)

This adds xt/release/pod-coverage.t to your distribution, which is a standard Test::Pod::Coverage test using Pod::Coverage::TrustPod.

PodSyntaxTestsby RJBS(also tagged: core, file-gatherer, tests-extra)

This adds xt/release/pod-syntax.t to your distribution, which is a standard Test::Pod test.

RunExtraTestsby DAGOLDEN(also tagged: tests-extra)

This plugin runs the tests in the xt/ directory when you do dzil test or use the TestRelease plugin. It's more efficient than CheckExtraTests because it integrates more tightly with MakeMaker (and ModuleBuild), allowing dzil to build the dist once and then run both the normal tests and the extra tests.

Test::PrereqsFromMetaby CJM(also tagged: file-gatherer)

This plugin will inject t/00-all_prereqs.t into your dist. This test reads your META.json file and attempts to load all runtime prerequisites. It fails if any required runtime prerequisites fail to load.

In addition, if AUTOMATED_TESTING is set, it dumps out every module in %INC along with its version. This can help you determine the cause of failures reported by CPAN Testers.

TestReleaseby CJM(also tagged: before-release, core)

This plugin extracts the tarball that's about to be released and ensures that it passes its tests. If any tests fail it aborts the release. You should be using this plugin. (It's included in @Basic.)

You can fork and improve this documentation on GitHub!