CONTRIBUTING: document how to test using prove(1)
This commit is contained in:
parent
a829eeb4a0
commit
28a4e82741
1 changed files with 23 additions and 3 deletions
|
@ -33,14 +33,34 @@ run the test suite via:
|
|||
|
||||
make check
|
||||
|
||||
Individual tests can be run as follows:
|
||||
Tests can be run individually as follows. First you have to ensure
|
||||
that the `t/`, `bin/`, and `lib/` directories are on Perl's search path.
|
||||
Assuming that you run all tests from the root of the repository tree,
|
||||
this will do the job:
|
||||
|
||||
perl -It t/stow.t
|
||||
export PERL5LIB=t:bin:lib
|
||||
|
||||
(Not all tests require all of these, but it's safer to include all of
|
||||
them.)
|
||||
|
||||
Now running an individual test is as simple as:
|
||||
|
||||
perl t/chkstow.t
|
||||
|
||||
or with a given debugging verbosity corresponding to the `-v` / `--verbose`
|
||||
command-line option:
|
||||
|
||||
TEST_VERBOSE=4 perl -It t/stow.t
|
||||
TEST_VERBOSE=4 perl t/chkstow.t
|
||||
|
||||
The [`prove(1)` test runner](https://perldoc.perl.org/prove) is another
|
||||
good alternative which provides several handy extra features. Invocation
|
||||
is very similar, e.g.:
|
||||
|
||||
prove t/stow.t
|
||||
|
||||
or to run the whole suite:
|
||||
|
||||
prove
|
||||
|
||||
Translating Stow
|
||||
----------------
|
||||
|
|
Loading…
Reference in a new issue