1bdep-test(1)                General Commands Manual               bdep-test(1)
2
3
4

NAME

6       bdep-test - test project in build configurations
7

SYNOPSIS

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

DESCRIPTION

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

TEST OPTIONS

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

COMMON OPTIONS

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       --diag-color
85              Use color in diagnostics.
86
87       --no-diag-color
88              Don't use color in diagnostics.
89
90       --bpkg path
91              The package manager program to be used for  build  configuration
92              management.
93
94       --bpkg-option opt
95              Additional option to be passed to the package manager program.
96
97       --build path
98              The build program to be used to build packages.
99
100       --build-option opt
101              Additional option to be passed to the build program.
102
103       --curl path
104              The curl program to be used for network operations.
105
106       --curl-option opt
107              Additional option to be passed to the curl program.
108
109       --pager path
110              The pager program to be used to show long text.
111
112       --pager-option opt
113              Additional option to be passed to the pager program.
114
115       --options-file file
116              Read additional options from file.
117
118       --default-options dir
119              The directory to load additional default options files from.
120
121       --no-default-options
122              Don't load default options files.
123

DEFAULT OPTIONS FILES

125       See  bdep-default-options-files(1)  for  an overview of the default op‐
126       tions files. For the test command the search  start  directory  is  the
127       project directory. The following options files are searched for in each
128       directory and, if found, loaded in the order listed:
129
130       bdep.options
131       bdep-test.options
132
133       The following test command options cannot be specified in  the  default
134       options files:
135
136       --directory|-d
137

BUGS

139       Send bug reports to the users@build2.org mailing list.
140

142       Copyright (c) 2014-2023 the build2 authors.
143
144       Permission  is  granted to copy, distribute and/or modify this document
145       under the terms of the MIT License.
146
147
148
149bdep 0.16.0                        June 2023                      bdep-test(1)
Impressum