Test2::Plugin::BailOnFail(3)

NAME
Test2::Plugin::BailOnFail - Automatically bail out of testing on the first test failure.

DESCRIPTION
This module will issue a bailout event after the first test failure. This will prevent your tests from continuing. The bailout runs when the context is released; that is, it will run when the test function you are using, such as ok(), returns. This gives the tools the ability to output any extra diagnostics they may need.

SYNOPSIS
    use Test2::V1;
    use Test2::Plugin::BailOnFail;

    T2->ok(1, "pass");
    T2->ok(0, "fail");
    T2->ok(1, "Will not run");

FORKED AND ASYNC SUBTESTS
This plugin acts on the pass/fail state of the hub in the process that is running, and a process that does not own its hub never sees that state. A forked subtest sends its events to the process that owns the hub instead of recording them locally, so inside one the hub reports no tests and no failures no matter what happened.

A failure inside a forked subtest therefore does not bail there. It bails in the owning process once that subtest is finished and its events have been merged, by which point sibling subtests have run whatever they were going to run. Their output is not suppressed, and there is no way to suppress it from here: a process cannot receive events for a hub it does not own, so it cannot be told that a sibling failed.

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

MAINTAINERS

Chad Granum <exodist@cpan.org>

AUTHORS

Chad Granum <exodist@cpan.org>

COPYRIGHT
Copyright 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/