dub-run - Man Page

Builds and runs a package (default command)

Synopsis

dub run [<package>[@<version-spec>]] Options... [-- <application arguments...>]

Description

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

Options

--temp-build

Builds the project in the temp folder if possible.

--rdmd

Use rdmd instead of directly invoking the compiler

-f,  --force

Forces a recompilation even if the target is up to date

-y,  --yes

Automatic yes to prompts. Assume "yes" as answer to all interactive prompts.

-n,  --non-interactive

Don't enter interactive mode.

-b,  --build=VALUE

Specifies the type of build to perform. Note that setting the DFLAGS environment variable will override the build type with custom flags. Possible names:
 debug, plain, release, release-debug, release-nobounds, unittest, profile, profile-gc, docs, ddox, cov, cov-ctfe, unittest-cov, unittest-cov-ctfe, syntax and custom types

-c,  --config=VALUE

Builds the specified configuration. Configurations can be defined in dub.json

--override-config=VALUE

Uses the specified configuration for a certain dependency. Can be specified multiple times. Format: --override-config=<dependency>/<config>

--compiler=VALUE

Specifies the compiler binary to use (can be a path). Arbitrary pre- and suffixes to the identifiers below are recognized (e.g. ldc2 or dmd-2.063) and matched to the proper compiler type:
 dmd, gdc, ldc, gdmd, ldmd

-a,  --arch=VALUE

Force a different architecture (e.g. x86 or x86_64)

-d,  --debug=VALUE

Define the specified debug version identifier when building - can be used multiple times

--nodeps

Do not resolve missing dependencies before building

--build-mode=VALUE

Specifies the way the compiler and linker are invoked. Valid values:
 separate (default), allAtOnce, singleFile

--single

Treats the package name as a filename. The file must contain a package recipe comment.

--force-remove

Deprecated option that does nothing.

--filter-versions

[Experimental] Filter version identifiers and debug version identifiers to improve build cache efficiency.

--combined

Tries to build the whole project in a single compiler run.

--print-builds

Prints the list of available build types

--print-configs

Prints the list of available configurations

--print-platform

Prints the identifiers for the current build platform as used for the build fields in dub.json

--parallel

Runs multiple compiler instances in parallel, if possible.

Common Options

See dub(1)

Exit Status

0

DUB succeeded

1

usage errors, unknown command line flags

2

package not found, package failed to load, miscellaneous error

Files

dub.sdl, dub.json

Author

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

Online Documentation

http://code.dlang.org/docs/commandline

See Also

dub(1), dub-build(1), dub-test(1), rdmd(1)

Referenced By

dub(1), dub-build(1), dub-test(1).

2023-07-24 The D Language Foundation