• NAME
• DESCRIPTION
• NAMESPACE MAP
• LISTING DEPENDENCIES
• Dist::Zilla
• ExtUtils::MakeMaker
• Module::Install
• Module::Build
• TUTORIALS
• SIMPLE/INTRODUCTION TUTORIAL
• MIGRATING FROM TEST::BUILDER and TEST::MORE
• ADVANCED PLANNING
• TODO TESTS
• SUBTESTS
• COMPARISONS
• SIMPLE COMPARISONS
• ADVANCED COMPARISONS
• TESTING EXPORTERS
• TESTING CLASSES
• TRAPPING
• TRAPPING EXCEPTIONS
• TRAPPING WARNINGS
• DEFERRED TESTING
• MANAGING ENCODINGS
• AUTO-ABORT ON FAILURE
• CONTROLLING RANDOM BEHAVIOR
• WRITING YOUR OWN BUNDLE
• TOOLSET DOCUMENTATION
• PLUGIN DOCUMENTATION
• BUNDLE DOCUMENTATION
• REQUIRE DOCUMENTATION
• SEE ALSO
• SOURCE
• MAINTAINERS
• AUTHORS
• COPYRIGHT

NAME

Test2::Manual::Testing - Hub for documentation about writing tests with Test2.

DESCRIPTION

This document outlines all the tutorials and POD that cover writing tests. This section does not cover any Test2 internals, nor does it cover how to write new tools, for that see the Test2::Manual::Tooling manpage.

NAMESPACE MAP

When writing tests there are a couple namespaces to focus on:

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 the Test2::V0 manpage 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

When you use Test2, specifically things included in the Test2::Suite manpage you need to list them in your modules test dependencies. It is important to note that you should list the tools/plugins/bundles you need, you should not simply list the Test2::Suite manpage as your dependency. the Test2::Suite manpage is a living distribution intended to represent the ``current'' best practices. As tools, plugins, and bundles evolve, old ones will become discouraged and potentially be moved from the Test2::Suite manpage into their own distributions.

One goal of the Test2::Suite manpage is to avoid breaking backwards compatibility. Another goal is to always improve by replacing bad designs with better ones. When necessary the Test2::Suite manpage 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 the Test2::V0 manpage, and the Dist::Zilla manpage 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 the Test2::V0 manpage might not always be part of the Test2::Suite manpage.

When writing new tests you should often check the Test2::Suite manpage 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

SIMPLE/INTRODUCTION TUTORIAL

the Test2::Manual::Testing::Introduction manpage is an introduction to writing tests using the Test2 tools.

MIGRATING FROM TEST::BUILDER and TEST::MORE

the Test2::Manual::Testing::Migrating manpage Is a tutorial for converting old tests that use the Test::Builder manpage or the Test::More manpage to the newer Test2 way of doing things.

ADVANCED PLANNING

the Test2::Manual::Testing::Planning manpage is a tutorial on the many ways to set a plan.

TODO TESTS

the Test2::Manual::Testing::Todo manpage is a tutorial for markings tests as TODO.

SUBTESTS

COMING SOON.

COMPARISONS

COMING SOON.

SIMPLE COMPARISONS

COMING SOON.

ADVANCED COMPARISONS

COMING SOON.

TESTING EXPORTERS

COMING SOON.

TESTING CLASSES

COMING SOON.

TRAPPING

COMING SOON.

TRAPPING EXCEPTIONS

COMING SOON.

TRAPPING WARNINGS

COMING SOON.

DEFERRED TESTING

COMING SOON.

MANAGING ENCODINGS

COMING SOON.

AUTO-ABORT ON FAILURE

COMING SOON.

CONTROLLING RANDOM BEHAVIOR

COMING SOON.

WRITING YOUR OWN BUNDLE

COMING SOON.

TOOLSET DOCUMENTATION

COMING SOON.

PLUGIN DOCUMENTATION

COMING SOON.

BUNDLE DOCUMENTATION

COMING SOON.

REQUIRE DOCUMENTATION

COMING SOON.

SEE ALSO

the Test2::Manual manpage - Primary index of the manual.

SOURCE

The source code repository for Test2-Manual can be found at https://github.com/Test-More/Test2-Suite/.

MAINTAINERS

Chad Granum

AUTHORS

Chad Granum <exodist@cpan.org>Chad Granum

COPYRIGHT

Copyright 2018 Chad Granum <exodist@cpan.org>.

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/