NAME

DESCRIPTION

NAMESPACE MAP

Test2::Tools::*

This is where toolsets can be found. A toolset exports functions that help you make assertions about your code. Toolsets will only export functions, they should not ever have extra/global effects.

Test2::Plugins::*

This is where plugins live. Plugins should not export anything, but instead will introduce or alter behaviors for Test2 in general. These behaviors may be lexically scoped, or they may be global.

Test2::Bundle::*

Bundles combine toolsets and plugins together to reduce your boilerplate. First time test writers are encouraged to start with the Test2::V0 bundle (which is an exception to the namespace rule as it does not live under "Test2::Bundle::"). If you find yourself loading several plugins and toolsets over and over again you could benefit from writing your own bundle.

Test2::Require::*

This namespace contains modules that will cause a test to skip if specific conditions are not met. Use this if you have tests that only run on specific perl versions, or require external libraries that may not always be available.

LISTING DEPENDENCIES

One goal of Test2::Suite is to avoid breaking backwards compatibility. Another goal is to always improve by replacing bad designs with better ones. When necessary Test2::Suite will break old modules out into separate dists and define new ones, typically with a new bundle. In short, if we feel the need to break something we will do so by creating a new bundle, and discouraging the old one, but we will not break the old one.

So for example, if you use Test2::V0, and Dist::Zilla you should have this in your config:

    [Prereqs / TestRequires]
    Test2::V0 = 0.000060

You SHOULD NOT do this:

    [Prereqs / TestRequires]
    Test2::Suite = 0.000060

Because Test2::V0 might not always be part of Test2::Suite.

When writing new tests you should often check Test2::Suite to see what the current recommended bundle is.

Dist::Zilla

    [Prereqs / TestRequires]
    Test2::V0 = 0.000060

ExtUtils::MakeMaker

    my %WriteMakefileArgs = (
      ...,
      "TEST_REQUIRES" => {
        "Test2::V0" => "0.000060"
      },
      ...
    );

Module::Install

    test_requires 'Test2::V0' => '0.000060';

Module::Build

    my $build = Module::Build->new(
        ...,
        test_requires => {
            "Test2::V0" => "0.000060",
        },
        ...
    );

TUTORIALS

TOOLSET DOCUMENTATION

PLUGIN DOCUMENTATION

BUNDLE DOCUMENTATION

REQUIRE DOCUMENTATION

SEE ALSO

SOURCE

MAINTAINERS

Chad Granum <exodist@cpan.org>

AUTHORS

Chad Granum <exodist@cpan.org>

COPYRIGHT

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

See http://dev.perl.org/licenses/