NAME

Test::Requires - Checks to see if the module can be loaded

SYNOPSIS

# in your Makefile.PL
use inc::Module::Install;
test_requires 'Test::Requires';

# in your test
use Test::More tests => 10;
use Test::Requires {
    'HTTP::MobileAttribute' => 0.01, # skip all if HTTP::MobileAttribute doesn't installed
};
isa_ok HTTP::MobileAttribute->new, 'HTTP::MobileAttribute::NonMobile';

# or
use Test::More tests => 10;
use Test::Requires qw( 
    HTTP::MobileAttribute
);
isa_ok HTTP::MobileAttribute->new, 'HTTP::MobileAttribute::NonMobile';

# or
use Test::More tests => 10;
use Test::Requires;
test_requires 'Some::Optional::Test::Required::Modules';
isa_ok HTTP::MobileAttribute->new, 'HTTP::MobileAttribute::NonMobile';

DESCRIPTION

Test::Requires checks to see if the module can be loaded.

If this fails rather than failing tests this skips all tests.

Test::Requires can also be used to require a minimum version of Perl:

use Test::Requires "5.010";  # quoting is necessary!!

# or
use Test::Requires "v5.10";

AUTHOR

Tokuhiro Matsuno <tokuhirom @*(#RJKLFHFSDLJF gmail.com>

THANKS TO

kazuho++ # some tricky stuff
miyagawa++ # original code from t/TestPlagger.pm
tomyhero++ # reported issue related older test::builder
tobyink++ # documented that Test::Requires "5.010" works

ENVIRONMENT

If the RELEASE_TESTING environment variable is true, then instead of skipping tests, Test::Requires bails out.

SEE ALSO

"TestPlagger.pm" in t

LICENSE

This library is free software; you can redistribute it and/or modify it under the same terms as Perl itself.