The Perl Toolchain Summit needs more sponsors. If your company depends on Perl, please support this very important event.

NAME

App::Prove - Implements the prove command.

VERSION

Version 3.10

DESCRIPTION

Test::Harness provides a command, prove, which runs a TAP based test suite and prints a report. The prove command is a minimal wrapper around an instance of this module.

SYNOPSIS

    use App::Prove;

    my $app = App::Prove->new;
    $app->process_args(@ARGV);
    $app->run;

METHODS

Class Methods

new

Create a new App::Prove. Optionally a hash ref of attribute initializers may be passed.

add_rc_file

    $prove->add_rc_file('myproj/.proverc');

Called before process_args to prepend the contents of an rc file to the options.

process_args

    $prove->process_args(@args);

Processes the command-line arguments. Attributes will be set appropriately. Any filenames may be found in the argv attribute.

Dies on invalid arguments.

run

Perform whatever actions the command line args specified. The prove command line tool consists of the following code:

    use App::Prove;

    my $app = App::Prove->new;
    $app->process_args(@ARGV);
    $app->run;

require_harness

Load a harness replacement class.

  $prove->require_harness($for => $class_name);

Display the version numbers of the loaded TAP::Harness and the current Perl.

Attributes

After command line parsing the following attributes reflect the values of the corresponding command line switches. They may be altered before calling run.

archive
argv
backwards
blib
color
directives
dry
exec
failures
fork
formatter
harness
includes
jobs
lib
merge
modules
parse
plugins
quiet
really_quiet
recurse
show_help
show_man
show_version
shuffle
state
taint_fail
taint_warn
test_args
timer
verbose
warnings_fail
warnings_warn