dub-dustmite(1)

1DUB-DUSTMITE(1)            The D Language Foundation           DUB-DUSTMITE(1)
2
3
4

NAME

6       dub - Package and build management system for D
7

SYNOPSIS

9       dub  dustmite  <destination-path>  OPTIONS...   [--  <application argu‐
10       ments...>]
11

DESCRIPTION

13       This command uses the Dustmite utility to isolate the  cause  of  build
14       errors in a DUB project.
15
16
17
18       It will create a copy of all involved packages and run dustmite on this
19       copy, leaving a reduced test case.
20
21
22
23       Determining the desired error condition is done by  checking  the  com‐
24       piler/linker  status  code,  as well as their output (stdout and stderr
25       combined). If --program-status or --program-regex is given and the gen‐
26       erated binary is an executable, it will be executed and its output will
27       also be incorporated into the final decision.
28

OPTIONS

30       --compiler-status=VALUE
31              The expected status code of the compiler run
32
33       --compiler-regex=VALUE
34              A regular expression used to match against the compiler output
35
36       --linker-status=VALUE
37              The expected status code of the linker run
38
39       --linker-regex=VALUE
40              A regular expression used to match against the linker output
41
42       --program-status=VALUE
43              The expected status code of the built executable
44
45       --program-regex=VALUE
46              A regular expression used to match against the program output
47
48       --test-package=VALUE
49              Perform a test run - usually only used internally
50
51       --combined
52              Builds multiple packages with one compiler run
53
54       --no-redirect
55              Don't redirect stdout/stderr streams of the test command
56
57       -b,    Specifies the type of build to perform. Note  that  setting  the
58              DFLAGS  environment  variable  will override the build type with
59              custom flags.  Possible names:
60                debug  (default),  plain,  release,  release-debug,   release-
61              nobounds,   unittest,  profile,  profile-gc,  docs,  ddox,  cov,
62              unittest-cov, syntax and custom types
63
64       -c,    Builds the specified configuration. Configurations  can  be  de‐
65              fined in dub.json
66
67       --override-config=VALUE
68              Uses  the  specified configuration for a certain dependency. Can
69              be specified multiple times.  Format:  --override-config=<depen‐
70              dency>/<config>
71
72       --compiler=VALUE
73              Specifies the compiler binary to use (can be a path).  Arbitrary
74              pre- and suffixes to the identifiers below are recognized  (e.g.
75              ldc2 or dmd-2.063) and matched to the proper compiler type:
76                dmd, gdc, ldc, gdmd, ldmd
77
78       -a,    Force a different architecture (e.g. x86 or x86_64)
79
80       -d,    Define  the  specified  debug version identifier when building -
81              can be used multiple times
82
83       --nodeps
84              Do not resolve missing dependencies before building
85
86       --build-mode=VALUE
87              Specifies the way the compiler and  linker  are  invoked.  Valid
88              values:
89                separate (default), allAtOnce, singleFile
90
91       --single
92              Treats  the  package name as a filename. The file must contain a
93              package recipe comment.
94
95       --force-remove
96              Deprecated option that does nothing.
97
98       --filter-versions
99              [Experimental] Filter  version  identifiers  and  debug  version
100              identifiers to improve build cache efficiency.
101

FILES

103       dub.sdl, dub.json
104

AUTHOR

106       Copyright (c) 1999-2022 by The D Language Foundation
107

ONLINE DOCUMENTATION

109       ⟨http://code.dlang.org/docs/commandline⟩http://code.dlang.org/docs/commandline
110