NAME
Test::Prereq - check if Makefile.PL has the right pre-requisites
SYNOPSIS
# if you use Makefile.PL use Test::Prereq; 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::Prereq::Build; prereq_ok();
# or from the command line for a one-off check perl -MTest::More=tests,1 -MTest::Prereq -eprereq_ok
DESCRIPTION
THIS IS ALPHA SOFTWARE. IT HAS SOME PROBLEMS.
The prereq_ok() function examines the modules it finds in blib/lib/ and the test files it finds in t/ (and test.pl). It figures out which modules they use, skips the modules that are in the Perl core, and compares the remaining list of modules to those in the PREREQ_PM section of Makefile.PL. If you use Module::Build instead, see Test::Prereq::Build instead.
Modules Test::Prereq can't find
Module::Info only tells Test::Prereq which modules you used, not which distribution they came in. This can be a problem for things in packages like libnet, libwww, Tk, and so on. At the moment Test::Prereq asks CPAN.pm to expand anything in PREREQ_PM to see if one of the distributions you explicity list contains the module you actually used. This might fail in some cases. Please send me anything that does not do what you think it should.
Test::Prereq only asks CPAN.pm for help if it needs it, since CPAN.pm can be slow if it has to fetch things from the network. Once it fetches the right things, it should be much faster.
Problem with Module::Info
Module::Info appears to do something wierd if a file it analyzes does not use (or require) any modules. You may get a message like
Can't locate object method "name" via package "B::NULL" at
/usr/perl5.8.0/lib/site_perl/5.8.0/B/Module/Info.pm line 176.Also, if a file cannot compile, Module::Info dumps a lot of text to the terminal. You probably want to bail out of testing if the files do not compile anyway.
FUNCTIONS
- prereq_ok( [ VERSION, [ NAME [, SKIP_ARRAY] ] ] )
-
If you don't specify a version, prereq_ok assumes you want to compare the list of prerequisite modules to version 5.6.1.
Valid version come from Module::CoreList (which uses $[):
5.008 5.00307 5.00405 5.00503 5.007003 5.004 5.005 5.006 5.006001prereq_ok attempts to remove modules found in blib 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.
TO DO
* set up a couple fake module distributions to test
SOURCE AVAILABILITY
This source is part of a SourceForge project which always has the latest sources in CVS, as well as all of the previous releases.
https://sourceforge.net/projects/brian-d-foy/If, for some reason, I disappear from the world, one of the other members of the project can shepherd this module appropriately.
CONTRIBUTORS
Many thanks to:
Andy Lester, Slavin Rezic, Randal Schwartz, Iain Truskett
AUTHOR
brian d foy, <bdfoy@cpan.org>
COPYRIGHT
Copyright 2002, brian d foy, All Rights Reserved.
You may use, modify, and distribute this package under the same terms as Perl itself.