NAME

Test::Stream::Bundle::V1 - Suggested bundle, most important tools.

EXPERIMENTAL CODE WARNING

This is an experimental release! Test-Stream, and all its components are still in an experimental phase. This dist has been released to cpan in order to allow testers and early adopters the chance to write experimental new tools with it, or to add experimental support for it into old tools.

PLEASE DO NOT COMPLETELY CONVERT OLD TOOLS YET. This experimental release is very likely to see a lot of code churn. API's may break at any time. Test-Stream should NOT be depended on by any toolchain level tools until the experimental phase is over.

DESCRIPTION

This is the recommended bundle for users of Test::Stream.

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