Test::Exec(3)         User Contributed Perl Documentation        Test::Exec(3)


NAME
       Test::Exec - Test that some code calls exec without terminating testing

VERSION
       version 0.07

SYNOPSIS
        use Test::More;
        use Test::Exec;

        is_deeply exec_arrayref { exec 'foo', 'bar', 'baz' }, [qw( foo bar baz )], 'found exec!';
        is exec_arrayref { }, undef, 'did not exec!';

        done_testing;

DESCRIPTION
       Test::Exec provides the most simple possible tools for testing code
       that might call "exec", which would otherwise end your test by calling
       another program.  This code should detect and capture "exec" calls,
       even if they are inside an "eval".

       The concept was implementation was based on Test::Exit, but applied to
       "exec" instead of "exit".

FUNCTIONS
   exec_arrayref
        exec_arrayref { ... }

       runs the given code.  If the code calls "exec", then this function will
       return an arrayref with its arguments.  If the code never calls "exec",
       it will return "undef".

   never_exec_ok
        never_exec_ok { ... }

       Runs the given code.  If the code calls "exec", then the test will fail
       (but exec will be intercepted and not performed).

CAVEATS
       This module installs its own version of "exec" in "CORE::GLOBAL::exec",
       and may interact badly with any other code that is also trying to do
       such things.

SEE ALSO
       Test::Exit
           Very similar to (and inspired) this module, but for "exit" testing
           instead of "exec".

       Test::Mock::Cmd
           Provides an interface to mocking "system", "qx" and "exec".

AUTHOR
       Author: Graham Ollis <plicease@cpan.org>

       Contributors:

       Jeremy Mates (THRIG)

COPYRIGHT AND LICENSE
       This software is copyright (c) 2015-2022 by Graham Ollis.

       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.38.0                      2023-07-26                     Test::Exec(3)