dub-run(1)

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

NAME

6       dub - Package and build management system for D
7

SYNOPSIS

9       dub run [<package>[@<version-spec>]] OPTIONS...  [-- <application argu‐
10       ments...>]
11

DESCRIPTION

13       Builds and runs a package (uses the main package in the current working
14       directory by default)
15

OPTIONS

17       --temp-build
18              Builds the project in the temp folder if possible.
19
20       --rdmd Use rdmd instead of directly invoking the compiler
21
22       -f,    Forces a recompilation even if the target is up to date
23
24       -y,    Automatic yes to prompts. Assume "yes" as answer to all interac‐
25              tive prompts.
26
27       -n,    Don't enter interactive mode.
28
29       -b,    Specifies the type of build to perform. Note  that  setting  the
30              DFLAGS  environment  variable  will override the build type with
31              custom flags.  Possible names:
32                debug  (default),  plain,  release,  release-debug,   release-
33              nobounds,   unittest,  profile,  profile-gc,  docs,  ddox,  cov,
34              unittest-cov, syntax and custom types
35
36       -c,    Builds the specified configuration. Configurations  can  be  de‐
37              fined in dub.json
38
39       --override-config=VALUE
40              Uses  the  specified configuration for a certain dependency. Can
41              be specified multiple times.  Format:  --override-config=<depen‐
42              dency>/<config>
43
44       --compiler=VALUE
45              Specifies the compiler binary to use (can be a path).  Arbitrary
46              pre- and suffixes to the identifiers below are recognized  (e.g.
47              ldc2 or dmd-2.063) and matched to the proper compiler type:
48                dmd, gdc, ldc, gdmd, ldmd
49
50       -a,    Force a different architecture (e.g. x86 or x86_64)
51
52       -d,    Define  the  specified  debug version identifier when building -
53              can be used multiple times
54
55       --nodeps
56              Do not resolve missing dependencies before building
57
58       --build-mode=VALUE
59              Specifies the way the compiler and  linker  are  invoked.  Valid
60              values:
61                separate (default), allAtOnce, singleFile
62
63       --single
64              Treats  the  package name as a filename. The file must contain a
65              package recipe comment.
66
67       --force-remove
68              Deprecated option that does nothing.
69
70       --filter-versions
71              [Experimental] Filter  version  identifiers  and  debug  version
72              identifiers to improve build cache efficiency.
73
74       --combined
75              Tries to build the whole project in a single compiler run.
76
77       --print-builds
78              Prints the list of available build types
79
80       --print-configs
81              Prints the list of available configurations
82
83       --print-platform
84              Prints  the  identifiers  for the current build platform as used
85              for the build fields in dub.json
86
87       --parallel
88              Runs multiple compiler instances in parallel, if possible.
89

FILES

91       dub.sdl, dub.json
92

AUTHOR

94       Copyright (c) 1999-2022 by The D Language Foundation
95

ONLINE DOCUMENTATION

97       ⟨http://code.dlang.org/docs/commandline⟩http://code.dlang.org/docs/commandline
98