dub-generate(1)

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

NAME

6       dub-generate - Generates project files using the specified generator
7

SYNOPSIS

9       dub generate <generator> [<package>[@<version-spec>]] OPTIONS...
10

DESCRIPTION

12       Generates project files using one of the supported generators:
13
14
15
16       visuald - VisualD project files
17
18       sublimetext - SublimeText project file
19
20       cmake - CMake build scripts
21
22       build - Builds the package directly
23
24
25
26       An  optional  package name can be given to generate a different package
27       than the root/CWD package.
28

OPTIONS

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

EXIT STATUS

96       0      DUB succeeded
97
98       1      usage errors, unknown command line flags
99
100       2      package not found, package failed to load, miscellaneous error
101

FILES

103       dub.sdl, dub.json
104

AUTHOR

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

ONLINE DOCUMENTATION

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