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

FreeBSD Manual Pages

  
 
  

home | help
App::Yath::Converting(User Contributed Perl DocumentatApp::Yath::Converting(3)

NAME
       App::Yath::Converting - Things you may need to change in	your tests
       before you can use yath.

NON-TAP	FORMATTER
       By default yath tells any Test2 or Test::Builder	tests to use
       Test2::Formatter::Stream	instead	of Test2::Formatter::TAP. This is done
       in order	to make	sure as	much data as possible makes it to yath,	TAP is
       a lossy formater	by comparison.

       This is not normally a problem, but tests that do strange things	with
       STDERR/STDOUT, or try to	intercept output from the regular TAP
       formatter can have issues with this.

   SOLUTIONS
       HARNESS-NO-STREAM

       You can add a harness directive to the top of offending tests that tell
       the harness those specific tests	should still use the TAP formatter.

	   #!/usr/bin/perl
	   # HARNESS-NO-STREAM
	   ...

       This directive can come after the "#!" line, and	after use statements,
       but must	come BEFORE any	empty lines or runtime statements.

       --no-stream

       You can run yath	with the "--no-stream" option, which will have tests
       default to TAP. This is not recommended as TAP is lossy.

TESTS ARE RUN VIA FORK BY DEFAULT
       The default mode	for yath is to preload a few things, then fork to
       spawn each test.	This is	a complicated procedure, and it	uses
       goto::file under	the hood. Sometimes you	have tests that	simply will
       not work	this way, or tests that	verify specific	libraries are not
       already loaded.

   SOLUTIONS
       HARNESS-NO-PRELOAD

       You can use this	harness	directive inside your tests to tell yath not
       to fork,	but to instead launch a	new perl process to run	the test.

	   #!/usr/bin/perl
	   # HARNESS-NO-PRELOAD
	   ...

       --no-fork

       --no-preload

       Both these options tell yath not	to preload+fork, but to	run ALL	tests
       in new processes. This is slow, it is better to mark specific tests
       that have issues	in preload mode.

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.1			  2021-06-15	      App::Yath::Converting(3)

NAME | NON-TAP FORMATTER | TESTS ARE RUN VIA FORK BY DEFAULT | SOURCE | MAINTAINERS | AUTHORS | COPYRIGHT

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

home | help