DebugWrap - wrapper to execute code under the debugger and examine the results.
my $wrapper = DebugWrap->new( { cmds => [ # list of commands supplied to the debugger ], prog => 'filename_of_code_to_debug.pl', # and some optional arguments } ); my $wrapper = DebugWrap->new( { cmds => [ # list of commands supplied to the debugger ], prog => \<<'EOS', # perl code to debug EOS # and some optional arguments } ); # test the output from the program being debugged $wrapper->output_like(qr/.../, "describe the test"); $wrapper->output_unlike(qr/.../, "describe the test"); my $output = $wrapper->get_output; # for more sophisticated checks # test the output from the debugger $wrapper->contents_like(qr/.../, "describe the test"); $wrapper->contents_unlike(qr/.../, "describe the test"); my $contents = $wrapper->get_contents; # for more sophisticated checks
DebugWrap is a simple class that executes a set of debugger commands against a program under the debugger and provides some simple methods to examine the results.
The constructor new() accepts a hash of arguments, with the following possible members:
An array of commands to execute, one command per element. Required.
Either the name of a perl program to test under the debugger, or a reference to a scalar containing the text of the program to test. Required.
If this is a true value capture standard error, which is the default. Optional.
Add lib/perl5db/t to the perl search path, as with -I
-I
An arrayref of switches to supply to perl. This should include the -d switch needed to invoke the debugger. If switches is not supplied then -d only is supplied. The -I for include_t is added after these switches.
-d
switches
include_t
The other methods intended for test usage are:
Fetch the debugger output from the debugger run. This does not include the output from the program under test.
Test that the debugger output matches the given regular expression object (as with qr//).
Equivelent to:
like($wrapper->get_contents, $re, $test_name);
Test that the debugger output does not match the given regular expression object (as with qr//).
unlike($wrapper->get_contents, $re, $test_name);
Fetch the program output from the debugger run. This does not include the output from the debugger itself, it does include the output generated by valgrind or ASAN, assuming you haven't disabled capturing stderr.
valgrind
Test that the program output matches the given regular expression object (as with qr//).
like($wrapper->get_output, $re, $test_name);
Test that the program output does not match the given regular expression object (as with qr//).
unlike($wrapper->get_output, $re, $test_name);
To install less, copy and paste the appropriate command in to your terminal.
cpanm
cpanm less
CPAN shell
perl -MCPAN -e shell install less
For more information on module installation, please visit the detailed CPAN module installation guide.