1RUNPROVE(1)           User Contributed Perl Documentation          RUNPROVE(1)
2
3
4

NAME

6       runprove -- A command-line tool for running tests against Test::Run
7

SYNOPSIS

9       runprove [options] [files/directories]
10
11       Options:
12
13           -b, --blib      Adds blib/lib to the path for your tests, a la "use blib".
14           -d, --debug     Includes extra debugging information.
15           -D, --dry       Dry run: Show the tests to run, but don't run them.
16               --ext=x     Extensions (defaults to .t)
17           -h, --help      Display this help
18           -H, --man       Longer manpage for runprove
19           -I              Add libraries to @INC, as Perl's -I
20           -l, --lib       Add lib to the path for your tests.
21           -r, --recurse   Recursively descend into directories.
22           -s, --shuffle   Run the tests in a random order.
23           -T              Enable tainting checks
24           -t              Enable tainting warnings
25               --timer     Print elapsed time after each test file
26           -v, --verbose   Display standard output of test scripts while running them.
27           -V, --version   Display version info
28
29       Single-character options may be stacked.  Default options may be set by
30       specifying the PROVE_SWITCHES environment variable.
31

OVERVIEW

33       runprove is a command-line interface to the test-running functionality
34       of "Test::Run".  With no arguments, it will run all tests in the
35       current directory.
36
37       Shell metacharacters may be used with command lines options and will be
38       exanded via "glob".
39

RUNPROVE VS. "MAKE TEST"

41       runprove has a number of advantages over "make test" when doing
42       development.
43
44runprove is designed as a development tool
45
46           Perl users typically run the test harness through a makefile via
47           "make test".  That's fine for module distributions, but it's
48           suboptimal for a test/code/debug development cycle.
49
50runprove is granular
51
52           runprove let your run only the files you want to check.  Running
53           "runprove t/live/ t/master.t" checks every *.t in t/live, plus
54           t/master.t.
55
56prove has an easy verbose mode
57
58           runprove has a "-v" option to see the raw output from the tests.
59           To do this with "make test", you must set "HARNESS_VERBOSE=1" in
60           the environment.
61
62runprove can run under taint mode
63
64           runprove's "-T" runs your tests under "perl -T", and "-t" runs them
65           under "perl -t".
66
67runprove can shuffle tests
68
69           You can use runprove's "--shuffle" option to try to excite problems
70           that don't show up when tests are run in the same order every time.
71
72runprove doesn't rely on a make tool
73
74           Not everyone wants to write a makefile, or use ExtUtils::MakeMaker
75           to do so.  runprove has no external dependencies.
76
77       •   Not everything is a module
78
79           More and more users are using Perl's testing tools outside the
80           context of a module distribution, and may not even use a makefile
81           at all.
82

COMMAND LINE OPTIONS

84   -b, --blib
85       Adds blib/lib to the path for your tests, a la "use blib".
86
87   -d, --debug
88       Include debug information about how runprove is being run.  This option
89       doesn't show the output from the test scripts.  That's handled by
90       -v,--verbose.
91
92   -D, --dry
93       Dry run: Show the tests to run, but don't run them.
94
95   --ext=extension
96       Specify extensions of the test files to run.  By default, these are .t,
97       but you may have other non-.t test files, most likely .sh shell
98       scripts.  The --ext is repeatable.
99
100   -I
101       Add libraries to @INC, as Perl's -I.
102
103   -l, --lib
104       Add "lib" to @INC.  Equivalent to "-Ilib".
105
106   -r, --recurse
107       Descends into subdirectories of any directories specified, looking for
108       tests.
109
110   -s, --shuffle
111       Sometimes tests are accidentally dependent on tests that have been run
112       before.  This switch will shuffle the tests to be run prior to running
113       them, thus ensuring that hidden dependencies in the test order are
114       likely to be revealed.  The author hopes the run the algorithm on the
115       preceding sentence to see if he can produce something slightly less
116       awkward.
117
118   -t
119       Runs test programs under perl's -t taint warning mode.
120
121   -T
122       Runs test programs under perl's -T taint mode.
123
124   --timer
125       Print elapsed time after each test file
126
127   -v, --verbose
128       Display standard output of test scripts while running them.  Also sets
129       TEST_VERBOSE in case your tests rely on them.
130
131   -V, --version
132       Display version info.
133

BUGS

135       Please report any bugs or feature requests to
136       "bug-test-run-cmdline@rt.cpan.org", or through the web interface at
137       <http://rt.cpan.org/NoAuth/ReportBug.html?Queue=Test-Run-CmdLine>.  I
138       will be notified, and then you'll automatically be notified of progress
139       on your bug as I make changes.
140

TODO

142       •   Shuffled tests must be recreatable
143

AUTHORS

145       Andy Lester "<andy@petdance.com>" (Adapted to runprove by Shlomi Fish,
146       <http://www.shlomifish.org/> ).
147
149       Copyright 2005 by Andy Lester "<andy@petdance.com>".
150
151       This program is free software; you can redistribute it and/or modify it
152       under the same terms as Perl itself.
153
154       See <http://www.perl.com/perl/misc/Artistic.html>.
155
156
157
158perl v5.34.0                      2022-01-21                       RUNPROVE(1)
Impressum