The Perl Toolchain Summit needs more sponsors. If your company depends on Perl, please support this very important event.

NAME

Test::Stream::Bundle::V1 - Preferred bundle used by Test::Stream author.

DESCRIPTION

This bundle is the one used most in Test::Stream's own test suite. This bundle ties together the most commonly used tools.

SYNOPSIS

Note: On ly the most critical functions are listed here. Please see individual plugins for their functions.

    use Test::Stream '-V1';

    ok(1, "This is a pass");
    ok(0, "This is a fail");

    is("x", "x", "These strings are the same");
    is($A, $B, "These 2 structures match exactly");

    like('x', qr/x/, "This string matches this pattern");
    like($A, $B, "These structures match where it counts");

    done_testing;

INCLUDED TOOLS

strict

'strict' is turned on for you.

warnings

'warnings' are turned on for you.

Compare

This provides is() and like(). This can also provide other tools to make deep comparisons easier, but they are not imported by default.

See Test::Stream::Plugin::Compare for more details.

Context

This provides the context() function which is useful in writing new tools, or wrapping existing ones.

See Test::Stream::Plugin::Context for more details.

Core

This provides essential tools such as ok(), done_testing(), as well as others.

See Test::Stream::Plugin::Core for more details.

Exception

This provides tools to help you intercept or check for the absence of exceptions. This is very similar to Test::Fatal, in fact Test::Fatal is probably better. If you can, use Test::Fatal, if you cannot then this may suffice. The functions exported do not conflict with the ones exported by Test::Fatal so both can be loaded together.

See Test::Stream::Plugin::Exception for more details.

ExitSummary

This provides extra diagnostics at the end of failing tests.

See Test::Stream::Plugin::ExitSummary for more details.

IPC

This loads IPC support so that threading and forking just work.

See Test::Stream::Plugin::IPC for more details.

Mock

This provides the mock() and mocked() functions which can be used to do nearly any kind of mocking you might need.

See Test::Stream::Plugin::Mock for more details.

TAP

This sets TAP to be the default output format.

See Test::Stream::Plugin::TAP for more details.

UTF8

This module turns on the utf8 pragma for your test file, it also sets STDERR, STDOUT and the formatter output handles to use utf8.

See Test::Stream::Plugin::UTF8 for more details.

Warnings

This plugin provides tools to help intercept warnings.

See Test::Stream::Plugin::Warnings for more details.

SOURCE

The source code repository for Test::Stream can be found at http://github.com/Test-More/Test-Stream/.

MAINTAINERS

Chad Granum <exodist@cpan.org>

AUTHORS

Chad Granum <exodist@cpan.org>

COPYRIGHT

Copyright 2015 Chad Granum <exodist7@gmail.com>.

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

See http://www.perl.com/perl/misc/Artistic.html