NAME

        prove6 - Run tests through a TAP harness.

USAGE

       prove6 [options] [files or directories]

OPTIONS

       Boolean options:

           -v,                    Print all test lines.
           -l,                    Add 'lib' to the path for your tests (-Ilib).
           -b,                    Add 'blib/lib' to the path for your tests
                --shuffle         Run the tests in random order.
                --ignore-exit     Ignore exit status from test scripts.
                --reverse         Run the tests in reverse order.
                --timer           Print elapsed time after each test.
                --trap            Trap Ctrl-C and print summary on interrupt.
                --help            Display this help
                --version         Display the version

       Options that take arguments:

           -e,                    Interpreter to run the tests ('' for compiled
                                  tests.)
                --harness         Define test harness to use.  See TAP::Harness.
                --reporter        Result reporter to use. See REPORTERS.
           -j,                    Run N test jobs in parallel (try 9.)
                --err=stdout      Direct the test's $*ERR to the harness' $*ERR.
                --err=merge       Merge test scripts' $*ERR with their $*OUT.
                --err=ignore      Ignore test script' $*ERR.

NOTES

       Default Test Directory

               If no files or directories are supplied, prove6 looks for all files
               matching the pattern t/*.t.

       Colored Test Output

               Colored test output is the default, but if output is not to a terminal,
               color is disabled.

               Color support requires Terminal::ANSIColor on Unix-like platforms. If the
               necessary module is not installed colored output will not be available.

               PS: Currently not available.

       Exit Code

               If the tests fail prove6 will exit with non-zero status.

                 -e

              Normally  you can just pass a list of Perl 6 tests and the harness will know how to
              execute them. However, if your tests are not written in Perl 6 or if you  want  all
              tests invoked exactly the same way, use the -e switch:

                              prove6 -e='/usr/bin/ruby -w' t/
                              prove6 -e='/usr/bin/perl -Tw -mstrict -Ilib' t/
                              prove6 -e='/path/to/my/customer/exec'

                     --err

                     •  --err=stderr

                     Direct the test's $*ERR to the harness' $*ERR.

                     This is the default behavior.

                     •  --err=merge

                     If you need to make sure your diagnostics are displayed in the correct order
                     relative to test results you can use the --err=merge  option  to  merge  the
                     test scripts' $*ERR into their $*OUT.

                     This  guarantees that $*OUT (where the test results appear) and $*ERR (where
                     the diagnostics appear) will stay in sync.  The  harness  will  display  any
                     diagnostics your tests emit on $*ERR.

                     Caveat:  this is a bit of a kludge. In particular note that if anything that
                     appears on $*ERR looks  like  a  test  result  the  test  harness  will  get
                     confused.  Use  this  option only if you understand the consequences and can
                     live with the risk.

                     PS: Currently not supported.

                     •  --err=ignore

       Ignore the test script' $*ERR

                 --trap

              The --trap option will attempt to trap  SIGINT  (Ctrl-C)  during  a  test  run  and
              display the test summary even if the run is interrupted

       $*REPO

               prove6 introduces a separation between "options passed to the perl which
               runs prove" and "options passed to the perl which runs tests"; this
               distinction is by design. Thus the perl which is running a test starts with
               the default $*REPO. Additional library directories can be added via the
               PERL6LIB environment variable, via -Ifoo in PERL6OPT or via the -Ilib
               option to prove6.

                                         02 November 2019                               Prove6(1)