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
23       details). As a result, the main utility of this command is the  ability
24       to  refer  to  build  configurations  by  names and to project packages
25       implicitly via the current working directory as well as to test  depen‐
26       dencies.
27
28       If no project or package directory is specified, then the current work‐
29       ing directory is assumed. If no configuration is  specified,  then  the
30       default  configuration  is  assumed.  See  bdep-projects-configs(1) for
31       details on specifying projects and configurations. Optional  cfg-var...
32       are the additional configuration variables to pass to the build system.
33

TEST OPTIONS

35       --immediate|-i
36              Also test immediate dependencies.
37
38       --recursive|-r
39              Also test all dependencies, recursively.
40
41       --all|-a
42              Use all build configurations.
43
44       --config|-c dir
45              Specify the build configuration as a directory.
46
47       --directory|-d dir
48              Assume project/package is in the specified directory rather than
49              in the current working directory.
50
51       --config-name|-n name
52              Specify the build configuration as a name.
53
54       --config-id num
55              Specify the build configuration as an id.
56

COMMON OPTIONS

58       The common options are summarized below with a more  detailed  descrip‐
59       tion available in bdep-common-options(1).
60
61       -v     Print essential underlying commands being executed.
62
63       -V     Print all underlying commands being executed.
64
65       --quiet|-q
66              Run quietly, only printing error messages.
67
68       --verbose level
69              Set the diagnostics verbosity to level between 0 and 6.
70
71       --jobs|-j num
72              Number of jobs to perform in parallel.
73
74       --no-progress
75              Suppress  progress  indicators for long-lasting operations, such
76              as network transfers, building, etc.
77
78       --bpkg path
79              The package manager program to be used for  build  configuration
80              management.
81
82       --bpkg-option opt
83              Additional option to be passed to the package manager program.
84
85       --build path
86              The build program to be used to build packages.
87
88       --build-option opt
89              Additional option to be passed to the build program.
90
91       --curl path
92              The curl program to be used for network operations.
93
94       --curl-option opt
95              Additional option to be passed to the curl program.
96
97       --pager path
98              The pager program to be used to show long text.
99
100       --pager-option opt
101              Additional option to be passed to the pager program.
102
103       --options-file file
104              Read additional options from file.
105
106       --default-options dir
107              The directory to load additional default options files from.
108
109       --no-default-options
110              Don't load default options files.
111

DEFAULT OPTIONS FILES

113       See  bdep-default-options-files(1)  for  an  overview  of  the  default
114       options files. For the test command the search start directory  is  the
115       project directory. The following options files are searched for in each
116       directory and, if found, loaded in the order listed:
117
118       bdep.options
119       bdep-test.options
120
121       The following test command options cannot be specified in  the  default
122       options files:
123
124       --directory|-d
125

BUGS

127       Send bug reports to the users@build2.org mailing list.
128
130       Copyright (c) 2014-2020 the build2 authors.
131
132       Permission  is  granted to copy, distribute and/or modify this document
133       under the terms of the MIT License.
134
135
136
137bdep 0.13.0                        July 2020                      bdep-test(1)
Impressum