NAME

Test::Stream::Plugin::Exception - Simple tools to help test exceptions.

DEPRECATED

This distribution is deprecated in favor of Test2, Test2::Suite, and Test2::Workflow.

See Test::Stream::Manual::ToTest2 for a conversion guide.

SYNOPSIS

# Loads Exception, we also need 'Core', so load that as well.
use Test::Stream qw/Core Exception/;

ok(lives { ... }, "codeblock did not die");

like(dies { die 'xxx' }, qr/xxx/, "codeblock threw expected exception");

EXPORTS

$bool = lives { ... }

If the codeblock does not throw any exception this will return true. If the codeblock does throw an exception this will return false, after printing the exception as a warning.

ok(lives { ... }, "codeblock did not die");

$error = dies { ... }

This will return undef if the codeblock does not throw an exception, otherwise it returns the exception. Note, if your exception is an empty string or 0 it is your responsibility to check that the error is defined instead of using a simple boolean check.

ok( defined dies { die 0 }, "died" );

like(dies { die 'xxx' }, qr/xxx/, "codeblock threw expected exception");

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://dev.perl.org/licenses/