dub-run(1)

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

NAME

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

EXIT STATUS

102       0      DUB succeeded
103
104       1      usage errors, unknown command line flags
105
106       2      package not found, package failed to load, miscellaneous error
107

FILES

109       dub.sdl, dub.json
110

AUTHOR

112       Copyright (c) 1999-2023 by The D Language Foundation
113

ONLINE DOCUMENTATION

115       http://code.dlang.org/docs/commandline ⟨⟩
116