1bdep-test(1) General Commands Manual bdep-test(1)
2
3
4
6 bdep-test - test project in build configurations
7
9 bdep test [options] [pkg-spec] [cfg-spec] [cfg-var...]
10
11 cfg-spec = (@cfg-name | --config|-c cfg-dir)... | --all|-a
12 pkg-spec = (--directory|-d pkg-dir)... | prj-spec
13 prj-spec = --directory|-d prj-dir
14
16 The test command tests the project packages in one or more build con‐
17 figurations. Additionally, immediate or all dependencies of the project
18 packages can be tested by specifying the --immediate|-i or --recur‐
19 sive|-r options, respectively.
20
21 Underneath test executes the bpkg-pkg-test(1) command which itself is
22 not much more than the build system test operation (see b(1) for de‐
23 tails). As a result, the main utility of this command is the ability to
24 refer to build configurations by names and to project packages implic‐
25 itly via the current working directory as well as to test dependencies.
26
27 If no project or package directory is specified, then the current work‐
28 ing directory is assumed. If no configuration is specified, then the
29 default configurations are assumed. See bdep-projects-configs(1) for
30 details on specifying projects and configurations. Optional cfg-var...
31 are the additional configuration variables to pass to the build system.
32
34 --immediate|-i
35 Also test immediate dependencies.
36
37 --recursive|-r
38 Also test all dependencies, recursively.
39
40 --all|-a
41 Use all build configurations.
42
43 --config|-c dir
44 Specify the build configuration as a directory.
45
46 --directory|-d dir
47 Assume project/package is in the specified directory rather than
48 in the current working directory.
49
50 --config-name|-n name
51 Specify the build configuration as a name.
52
53 --config-id num
54 Specify the build configuration as an id.
55
57 The common options are summarized below with a more detailed descrip‐
58 tion available in bdep-common-options(1).
59
60 -v Print essential underlying commands being executed.
61
62 -V Print all underlying commands being executed.
63
64 --quiet|-q
65 Run quietly, only printing error messages.
66
67 --verbose level
68 Set the diagnostics verbosity to level between 0 and 6.
69
70 --stdout-format format
71 Representation format to use for printing to stdout.
72
73 --jobs|-j num
74 Number of jobs to perform in parallel.
75
76 --progress
77 Display progress indicators for long-lasting operations, such as
78 network transfers, building, etc.
79
80 --no-progress
81 Suppress progress indicators for long-lasting operations, such
82 as network transfers, building, etc.
83
84 --bpkg path
85 The package manager program to be used for build configuration
86 management.
87
88 --bpkg-option opt
89 Additional option to be passed to the package manager program.
90
91 --build path
92 The build program to be used to build packages.
93
94 --build-option opt
95 Additional option to be passed to the build program.
96
97 --curl path
98 The curl program to be used for network operations.
99
100 --curl-option opt
101 Additional option to be passed to the curl program.
102
103 --pager path
104 The pager program to be used to show long text.
105
106 --pager-option opt
107 Additional option to be passed to the pager program.
108
109 --options-file file
110 Read additional options from file.
111
112 --default-options dir
113 The directory to load additional default options files from.
114
115 --no-default-options
116 Don't load default options files.
117
119 See bdep-default-options-files(1) for an overview of the default op‐
120 tions files. For the test command the search start directory is the
121 project directory. The following options files are searched for in each
122 directory and, if found, loaded in the order listed:
123
124 bdep.options
125 bdep-test.options
126
127 The following test command options cannot be specified in the default
128 options files:
129
130 --directory|-d
131
133 Send bug reports to the users@build2.org mailing list.
134
136 Copyright (c) 2014-2022 the build2 authors.
137
138 Permission is granted to copy, distribute and/or modify this document
139 under the terms of the MIT License.
140
141
142
143bdep 0.15.0 July 2022 bdep-test(1)