]> git.donarmstrong.com Git - debhelper.git/blob - dh_auto_test
Merge branch 'master' into buildsystems
[debhelper.git] / dh_auto_test
1 #!/usr/bin/perl -w
2
3 =head1 NAME
4
5 dh_auto_test - run package test suites after building
6
7 =cut
8
9 use strict;
10 use Debian::Debhelper::Dh_Buildsystems;
11
12 =head1 SYNOPSIS
13
14 B<dh_auto_test> [S<I<debhelper options>>] [S<I<dh_auto options>>] [S<B<--> I<params>>]
15
16 =head1 DESCRIPTION
17
18 dh_auto_test is a debhelper program that is responsible for the I<test> step of
19 the L<dh_auto(7)> building process. Typically, this is the point when package
20 test suite is run to check if the sources were built successfully and/or
21 binaries provide expected functionality. dh_auto_test will fail if test suite
22 fails.  However, if there's no test suite, it will exit with zero status
23 without doing anything.
24
25 If dh_auto_test does not meet your needs or does not work, it is safe to
26 skip/override it entirely and just run the test suite manually.
27
28 =head1 NOTES
29
30 If the DEB_BUILD_OPTIONS environment variable contains "nocheck", no tests will
31 be performed.
32
33 #DH_AUTO SHARED OPTIONS#
34
35 =head1 OPTIONS
36
37 =over 4
38
39 =item B<--> I<params>
40
41 Pass "params" to the program that is run. These can be used to supplement
42 or override the any standard parameters that dh_auto_test passes.
43
44 =back
45
46 =head1 SUPPORTED BUILD SYSTEMS
47
48 #SUPPORTED BUILD SYSTEMS INTRO#
49 #SUPPORTED BUILD SYSTEMS LIST#
50
51 =cut
52
53 if (defined $ENV{DEB_BUILD_OPTIONS} && $ENV{DEB_BUILD_OPTIONS} =~ /nocheck/) {
54         exit 0;
55 }
56
57 buildsystems_init();
58 buildsystems_do();
59
60 =head1 SEE ALSO
61
62 L<dh_auto(7)>
63
64 L<debhelper(7)>
65
66 This program is a part of debhelper and its dh_auto package source building
67 suite.
68
69 =head1 AUTHORS
70
71  Joey Hess <joeyh@debian.org>
72  Modestas Vainius <modestas@vainius.eu>
73
74 =cut