NAME

Test2::Harness - Test2 based test harness.

DESCRIPTION

This is an alternative to Test::Harness. See the App::Yath module for more details.

Try running the yath command inside a perl repository.

    $ yath

For help:

    $ yath --help

USING THE HARNESS IN YOUR DISTRIBUTION

If you want to have your tests run via Test2::Harness instead of Test::Harness you need to do two things:

Move your test files

You need to put any tests that you want to run under Test2::Harness into a directory other than t/. A good name to pick is t2/, as it will not be picked up by Test::Harness automatically.

Add a test.pl script

You need a script that loads Test2::Harness and tells it to run the tests. You can find this script in examples/test.pl in this distribution. The example test.pl is listed here for convenience:

    #!/usr/bin/env perl
    use strict;
    use warnings;

    # Change this to list the directories where tests can be found. This should not
    # include the directory where this file lives.

    my @DIRS = ('./t2');

    # PRELOADS GO HERE
    # Example:
    # use Moose;

    ###########################################
    # Do not change anything below this point #
    ###########################################

    use App::Yath;

    # After fork, Yath will break out of this block so that the test file being run
    # in the new process has as small a stack as possible. It would be awful to
    # have a bunch of Test2::Harness frames on all stack traces.
    T2_DO_FILE: {
        # Add eveything in @INC via -I so that using `perl -Idir this_file` will
        # pass the include dirs on to any tests that decline to accept the preload.
        my $yath = App::Yath->new(args => [(map { "-I$_" } @INC), '--exclude=use_harness', @DIRS, @ARGV]);

        # This is where we turn control over to yath.
        my $exit = $yath->run();
        exit($exit);
    }

    # At this point we are in a child process and need to run a test file specified
    # in this package var.
    my $file = $Test2::Harness::Runner::DO_FILE
        or die "No file to run!";

    # Test files do not always return a true value, so we cannot use require. We
    # also cannot trust $!
    $@ = '';
    do $file;
    die $@ if $@;
    exit 0;

Most (if not all) module installation tools will find test.pl and run it, using the exit value to determine pass/fail.

Note: Since Test2::Harness does not output the traditional TAP, you cannot use this example as a .t file in t/.

SOURCE

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

MAINTAINERS

Chad Granum <exodist@cpan.org>

AUTHORS

Chad Granum <exodist@cpan.org>

COPYRIGHT

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