summaryrefslogtreecommitdiff
path: root/dh_auto_test
blob: 85eaf48a7a7d65af21eb2809d24cde2c3d2c63a7 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
#!/usr/bin/perl -w

=head1 NAME

dh_auto_test - automatically runs a package's test suites

=cut

use strict;
use Debian::Debhelper::Dh_Lib;
use Debian::Debhelper::Dh_Buildsystems;

=head1 SYNOPSIS

B<dh_auto_test> [S<I<build system options>>] [S<I<debhelper options>>] [S<B<--> I<params>>]

=head1 DESCRIPTION

B<dh_auto_test> is a debhelper program that tries to automatically run a
package's test suite. It does so by running the appropriate command for the
build system it detects the package uses. For example, if there's a
Makefile and it contains a B<test> or B<check> target, then this is done by
running B<make> (or B<MAKE>, if the environment variable is set). If the test
suite fails, the command will exit nonzero. If there's no test suite, it
will exit zero without doing anything.

This is intended to work for about 90% of packages with a test suite. If it
doesn't work, you're encouraged to skip using B<dh_auto_test> at all, and
just run the test suite manually.

=head1 OPTIONS

See L<debhelper(7)/B<BUILD SYSTEM OPTIONS>> for a list of common build
system selection and control options.

=over 4

=item B<--> I<params>

Pass I<params> to the program that is run. These can be used to supplement
or override the any standard parameters that B<dh_auto_test> passes.

=back

=head1 NOTES

If the B<DEB_BUILD_OPTIONS> environment variable contains B<nocheck>, no
tests will be performed.

=cut

if (get_buildoption("nocheck")) {
	exit 0;
}

buildsystems_init();
buildsystems_do();

=head1 SEE ALSO

L<debhelper(7)>

This program is a part of debhelper.

=head1 AUTHOR

Joey Hess <joeyh@debian.org>

=cut