Test::Prereq - check if Makefile.PL has the right pre-requisites
# if you use Makefile.PL use Test::More; eval "use Test::Prereq"; plan skip_all => "Test::Prereq required to test dependencies" if $@; prereq_ok(); # specify a perl version, test name, or module names to skip prereq_ok( $version, $name, \@skip ); # if you use Module::Build use Test::More; eval "use Test::Prereq::Build"; plan skip_all => "Test::Prereq::Build required to test dependencies" if $@; prereq_ok(); # or from the command line for a one-off check perl -MTest::Prereq -eprereq_ok #The prerequisites test take quite some time so the following construct is #recommended for non-author testers use Test::More; eval "use Test::Prereq::Build"; my $msg; if ($@) { $msg = 'Test::Prereq::Build required to test dependencies'; } elsif (not $ENV{TEST_AUTHOR}) { $msg = 'Author test. Set $ENV{TEST_AUTHOR} to a true value to run.'; } plan skip_all => $msg if $msg; prereq_ok();
The prereq_ok() function examines the modules it finds in blib/lib/, blib/script, and the test files it finds in t/ (and test.pl). It figures out which modules they use and compares that list of modules to those in the PREREQ_PM section of Makefile.PL.
prereq_ok()
PREREQ_PM
If you use Module::Build instead, see Test::Prereq::Build instead.
Module::Build
Test::Prereq has its own version of ExtUtils::MakeMaker::WriteMakefile so it can run the Makefile.PL and get the argument list of that function. You may see warnings about this.
Test::Prereq
ExtUtils::MakeMaker::WriteMakefile
Tests Makefile.PL to ensure all non-core module dependencies are in PREREQ_PM. If you haven't set a testing plan already, prereq_ok() creates a plan of one test.
If you don't specify a version, prereq_ok assumes you want to compare the list of prerequisite modules to the version of perl running the test.
prereq_ok
Valid versions come from Module::CoreList (which uses $]).
Module::CoreList
$]
#!/usr/bin/perl use Module::CoreList; print map "$_\n", sort keys %Module::CoreList::version;
prereq_ok attempts to remove modules found in lib/ and libraries found in t/ from the reported prerequisites.
The optional third argument is an array reference to a list of names that prereq_ok should ignore. You might want to use this if your tests do funny things with require.
require
Versions prior to 1.038 would use CPAN.pm to virtually include prerequisites in distributions that you declared explicitly. This isn't really a good idea. Some modules have moved to different distributions, so you should just specify all the modules that you use instead of relying on a particular distribution to provide them. Not only that, expanding distributions with CPAN.pm takes forever.
If you want the old behavior, set the TEST_PREREQ_EXPAND_WITH_CPAN environment variable to a true value.
TEST_PREREQ_EXPAND_WITH_CPAN
set up a couple fake module distributions to test
warn about things that show up in PREREQ_PM unnecessarily
This source is in Github:
http://github.com/briandfoy/test-prereq
Many thanks to:
Andy Lester, Slavin Rezić, Randal Schwartz, Iain Truskett, Dylan Martin
brian d foy, <bdfoy@cpan.org>
<bdfoy@cpan.org>
Copyright © 2002-2016, brian d foy <bdfoy@cpan.org>. All rights reserved. This software is available under the Artistic License 2.
To install Test::Prereq, copy and paste the appropriate command in to your terminal.
cpanm
cpanm Test::Prereq
CPAN shell
perl -MCPAN -e shell install Test::Prereq
For more information on module installation, please visit the detailed CPAN module installation guide.