1bpkg-pkg-test(1)            General Commands Manual           bpkg-pkg-test(1)
2
3
4

NAME

6       bpkg-pkg-test - test package
7

SYNOPSIS

9       bpkg pkg-test|test [options] [vars] pkg...
10       bpkg pkg-test|test [options] [vars] --all|-a
11

DESCRIPTION

13       The  pkg-test  command tests the specified packages (the first form) or
14       all the held packages (the second form, see bpkg-pkg-status(1)).  Addi‐
15       tionally,  immediate  or all dependencies of these packages can also be
16       tested by specifying  the  --immediate|-i  or  --recursive|-r  options,
17       respectively.  Underneath, this command doesn't do much more than run b
18       test. In the first form the specified packages must  have  been  previ‐
19       ously configured with bpkg-pkg-build(1) or bpkg-pkg-configure(1).
20
21       Additional  command  line  variables  (vars,  normally config.*) can be
22       passed to the build system. Such variables apply to all  the  specified
23       packages  but  can also be specified to only apply to specific packages
24       using the argument grouping  mechanism  (see  bpkg-argument-grouping(1)
25       for details).
26

PKG-TEST OPTIONS

28       --all|-a
29              Test all held packages.
30
31       --immediate|-i
32              Also test immediate dependencies.
33
34       --recursive|-r
35              Also test all dependencies, recursively.
36
37       --package-cwd
38              Change  the  current  working directory to the package directory
39              prior to running tests. This may help ported  third-party  pack‐
40              ages since its not uncommon for tests to expect they are running
41              form the project root directory.
42
43       --directory|-d dir
44              Assume configuration is in dir rather than in the current  work‐
45              ing directory.
46

COMMON OPTIONS

48       The  common  options are summarized below with a more detailed descrip‐
49       tion available in bpkg-common-options(1).
50
51       -v     Print essential underlying commands being executed.
52
53       -V     Print all underlying commands being executed.
54
55       --quiet|-q
56              Run quietly, only printing error messages.
57
58       --verbose level
59              Set the diagnostics verbosity to level between 0 and 6.
60
61       --jobs|-j num
62              Number of jobs to perform in parallel.
63
64       --no-result
65              Don't print informational messages about the outcome of perform‐
66              ing a command.
67
68       --no-progress
69              Suppress  progress  indicators for long-lasting operations, such
70              as network transfers, building, etc.
71
72       --build path
73              The build program to be used to build packages.
74
75       --build-option opt
76              Additional option to be passed to the build program.
77
78       --fetch path
79              The fetch program to be used to download resources.
80
81       --fetch-option opt
82              Additional option to be passed to the fetch program.
83
84       --fetch-timeout sec
85              The fetch and fetch-like (for example, git) program timeout.
86
87       --git path
88              The git program to be used to fetch git repositories.
89
90       --git-option opt
91              Additional common option to be passed to the git program.
92
93       --sha256 path
94              The sha256 program to be used to calculate SHA256 sums.
95
96       --sha256-option opt
97              Additional option to be passed to the sha256 program.
98
99       --tar path
100              The tar program to be used to extract package archives.
101
102       --tar-option opt
103              Additional option to be passed to the tar program.
104
105       --openssl path
106              The openssl program to be used for crypto operations.
107
108       --openssl-option opt
109              Additional option to be passed to the openssl program.
110
111       --auth type
112              Types of repositories to authenticate.
113
114       --trust fingerprint
115              Trust repository certificate with a SHA256 fingerprint.
116
117       --trust-yes
118              Assume the answer to all authentication prompts is yes.
119
120       --trust-no
121              Assume the answer to all authentication prompts is no.
122
123       --pager path
124              The pager program to be used to show long text.
125
126       --pager-option opt
127              Additional option to be passed to the pager program.
128
129       --options-file file
130              Read additional options from file.
131
132       --default-options dir
133              The directory to load additional default options files from.
134
135       --no-default-options
136              Don't load default options files.
137

DEFAULT OPTIONS FILES

139       See  bpkg-default-options-files(1)  for  an  overview  of  the  default
140       options  files.  For the pkg-test command the search start directory is
141       the configuration directory. The following options files  are  searched
142       for in each directory and, if found, loaded in the order listed:
143
144       bpkg.options
145       bpkg-pkg-test.options
146
147       The  following  pkg-test  command  options  cannot  be specified in the
148       default options files:
149
150       --directory|-d
151

BUGS

153       Send bug reports to the users@build2.org mailing list.
154

156       Copyright (c) 2014-2019 Code Synthesis Ltd
157
158       Permission is granted to copy, distribute and/or modify  this  document
159       under the terms of the MIT License.
160
161
162
163bpkg 0.12.0                      November 2019                bpkg-pkg-test(1)
Impressum