Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages

  
 
  

home | help
App::Yath::Options::RuUser(Contributed Perl DocumApp::Yath::Options::Runner(3)

NAME
       App::Yath::Options::Runner - Runner options for Yath.

DESCRIPTION
       This is where command line options for the runner are defined.

PROVIDED OPTIONS
   COMMAND OPTIONS
       Runner Options

       --blib
       -b
       --no-blib
	   (Default: include if	it exists) Include 'blib/lib' and 'blib/arch'
	   in your module path

       --cover
       --cover=-silent,1,+ignore,^t/,+ignore,^t2/,+ignore,^xt,+ignore,^test.pl
       --no-cover
	   Use Devel::Cover to calculate test coverage.	This disables forking.
	   If no args are specified the	following are used:
	   -silent,1,+ignore,^t/,+ignore,^t2/,+ignore,^xt,+ignore,^test.pl

       --cover-files
       --no-cover-files
	   Use Test2::Plugin::Cover to collect coverage	data for what files
	   are touched by what tests. Unlike Devel::Cover this has very	little
	   performance impact (About 4%	difference)

       --dbi-profiling
       --no-dbi-profiling
	   Use Test2::Plugin::DBIProfile to collect database profiling data

       --event-timeout SECONDS
       --et SECONDS
       --no-event-timeout
	   Kill	test if	no output is received within timeout period. (Default:
	   60 seconds).	Add the	"# HARNESS-NO-TIMEOUT" comment to the top of a
	   test	file to	disable	timeouts on a per-test basis. This prevents a
	   hung	test from running forever.

       --include ARG
       --include=ARG
       -I ARG
       -I=ARG
       --no-include
	   Add a directory to your include paths

	   Can be specified multiple times

       --job-count ARG
       --job-count=ARG
       --jobs ARG
       --jobs=ARG
       -j ARG
       -j=ARG
       --no-job-count
	   Set the number of concurrent	jobs to	run (Default: 1)

	   Can also be set with	the following environment variables:
	   "YATH_JOB_COUNT", "T2_HARNESS_JOB_COUNT", "HARNESS_JOB_COUNT"

       --lib
       -l
       --no-lib
	   (Default: include if	it exists) Include 'lib' in your module	path

       --post-exit-timeout SECONDS
       --pet SECONDS
       --no-post-exit-timeout
	   Stop	waiting	post-exit after	the timeout period. (Default: 15
	   seconds) Some tests fork and	allow the parent to exit before
	   writing all their output. If	Test2::Harness detects an incomplete
	   plan	after the test exits it	will monitor for more events until the
	   timeout period. Add the "# HARNESS-NO-TIMEOUT" comment to the top
	   of a	test file to disable timeouts on a per-test basis.

       --preload-threshold ARG
       --preload-threshold=ARG
       --Pt ARG
       --Pt=ARG
       -W ARG
       -W=ARG
       --no-preload-threshold
	   Only	do preload if at least N tests are going to be run. In some
	   cases a full	preload	takes longer than simply running the tests,
	   this	lets you specify a minimum number of test jobs that will be
	   run for preload to happen. This has no effect for a persistent
	   runner. The default is 0, and it means always preload.

       --preloads ARG
       --preloads=ARG
       --preload ARG
       --preload=ARG
       -P ARG
       -P=ARG
       --no-preloads
	   Preload a module before running tests

	   Can be specified multiple times

       --resource Port
       --resource +Test2::Harness::Runner::Resource::Port
       -R Port
       --no-resource
	   Use a resource module to assign resource assignments	to individual
	   tests

	   Can be specified multiple times

       --switch	ARG
       --switch=ARG
       -S ARG
       -S=ARG
       --no-switch
	   Pass	the specified switch to	perl for each test. This is not
	   compatible with preload.

	   Can be specified multiple times

       --tlib
       --no-tlib
	   (Default: off) Include 't/lib' in your module path

       --unsafe-inc
       --no-unsafe-inc
	   perl	is removing '.'	from @INC as a security	concern. This option
	   keeps things	from breaking for now.

	   Can also be set with	the following environment variables:
	   "PERL_USE_UNSAFE_INC"

       --use-fork
       --fork
       --no-use-fork
	   (default: on, except	on windows) Normally tests are run by forking,
	   which allows	for features like preloading. This will	turn off the
	   behavior globally (which is not compatible with preloading).	This
	   is slower, it is better to tag misbehaving tests with the '#
	   HARNESS-NO-PRELOAD' comment in their	header to disable forking only
	   for those tests.

	   Can also be set with	the following environment variables:
	   "!T2_NO_FORK", "T2_HARNESS_FORK", "!T2_HARNESS_NO_FORK",
	   "YATH_FORK",	"!YATH_NO_FORK"

       --use-timeout
       --timeout
       --no-use-timeout
	   (default: on) Enable/disable	timeouts

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 2020 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/

perl v5.32.0			  2020-08-24	 App::Yath::Options::Runner(3)

NAME | DESCRIPTION | PROVIDED OPTIONS | SOURCE | MAINTAINERS | AUTHORS | COPYRIGHT

Want to link to this manual page? Use this URL:
<https://www.freebsd.org/cgi/man.cgi?query=App::Yath::Options::Runner&sektion=3&manpath=FreeBSD+12.1-RELEASE+and+Ports>

home | help