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       --pkg-proxy url
88              HTTP proxy server to use when fetching package manifests and ar‐
89              chives from remote pkg repositories.
90
91       --git path
92              The git program to be used to fetch git repositories.
93
94       --git-option opt
95              Additional common option to be passed to the git program.
96
97       --sha256 path
98              The sha256 program to be used to calculate SHA256 sums.
99
100       --sha256-option opt
101              Additional option to be passed to the sha256 program.
102
103       --tar path
104              The tar program to be used to extract package archives.
105
106       --tar-option opt
107              Additional option to be passed to the tar program.
108
109       --openssl path
110              The openssl program to be used for crypto operations.
111
112       --openssl-option opt
113              Additional option to be passed to the openssl program.
114
115       --auth type
116              Types of repositories to authenticate.
117
118       --trust fingerprint
119              Trust repository certificate with a SHA256 fingerprint.
120
121       --trust-yes
122              Assume the answer to all authentication prompts is yes.
123
124       --trust-no
125              Assume the answer to all authentication prompts is no.
126
127       --pager path
128              The pager program to be used to show long text.
129
130       --pager-option opt
131              Additional option to be passed to the pager program.
132
133       --options-file file
134              Read additional options from file.
135
136       --default-options dir
137              The directory to load additional default options files from.
138
139       --no-default-options
140              Don't load default options files.
141

DEFAULT OPTIONS FILES

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

BUGS

157       Send bug reports to the users@build2.org mailing list.
158
160       Copyright (c) 2014-2020 the build2 authors.
161
162       Permission  is  granted to copy, distribute and/or modify this document
163       under the terms of the MIT License.
164
165
166
167bpkg 0.13.0                        July 2020                  bpkg-pkg-test(1)
Impressum