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

FreeBSD Manual Pages

  
 
  

home | help
App::Cmd::Tester::CaptUserxContributed PerApp::Cmd::Tester::CaptureExternal(3)

NAME
       App::Cmd::Tester::CaptureExternal - Extends App::Cmd::Tester to capture
       from external subprograms

VERSION
       version 0.334

SYNOPSIS
	 use Test::More	tests => 4;
	 use App::Cmd::Tester::CaptureExternal;

	 use YourApp;

	 my $result = test_app(YourApp => [ qw(command --opt value) ]);

	 like($result->stdout, qr/expected output/, 'printed what we expected');

	 is($result->stderr, '', 'nothing sent to sderr');

	 ok($result->output, "STDOUT concatenated with STDERR");

DESCRIPTION
       App::Cmd::Tester	provides a useful scaffold for testing applications,
       but it is unable	to capture output generated from any external
       subprograms that	are invoked from the application.

       This subclass uses an alternate mechanism for capturing output
       (Capture::Tiny) that does capture from external programs, with one
       major limitation.

       It is not possible to capture externally	from both STDOUT and STDERR
       while also having appropriately interleaved combined output.
       Therefore, the "output" from this subclass simply concatenates the two.

       You can still use "output" for testing if there is any output at	all or
       for testing if something	appeared in either output stream, but you
       can't rely on the ordering being	correct	between	lines to STDOUT	and
       lines to	STDERR.

PERL VERSION SUPPORT
       This module has a long-term perl	support	period.	 That means it will
       not require a version of	perl released fewer than five years ago.

       Although	it may work on older versions of perl, no guarantee is made
       that the	minimum	required version will not be increased.	 The version
       may be increased	for any	reason,	and there is no	promise	that patches
       will be accepted	to lower the minimum required perl.

AUTHOR
       Ricardo Signes <rjbs@semiotic.systems>

COPYRIGHT AND LICENSE
       This software is	copyright (c) 2021 by Ricardo Signes.

       This is free software; you can redistribute it and/or modify it under
       the same	terms as the Perl 5 programming	language system	itself.

perl v5.32.1			  2021-06-App::Cmd::Tester::CaptureExternal(3)

NAME | VERSION | SYNOPSIS | DESCRIPTION | PERL VERSION SUPPORT | AUTHOR | COPYRIGHT AND LICENSE

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

home | help