.TH DUB-FETCH 1 "2024-07-07" "The D Language Foundation" "The D Language Foundation"
.SH NAME
dub-fetch \- Explicitly retrieves and caches packages
.SH SYNOPSIS
\fBdub fetch \fR<\fIpackage\fR>[@<\fIversion-spec\fR>] \fIOPTIONS\&.\&.\&.\fR
.SH DESCRIPTION
When run with one or more arguments, regardless of the location it is run in,

it will fetch the packages matching the argument(s).

Examples:

$ dub fetch vibe-d

$ dub fetch vibe-d@v0.9.0 --cache=local --recursive



When run in a project with no arguments, it will fetch all dependencies for that project.

If the project doesn't have set dependencies (no 'dub.selections.json'), it will also perform dependency resolution.

Example:

$ cd myProject && dub fetch



Note that the 'build', 'run', and any other command that need packages will automatically perform fetch,

hence it is not generally necessary to run this command before any other.
.SH OPTIONS
.PP
\fB\-r\fR, \fB\-\-recursive\fR
.RS 4
Also fetches dependencies of specified packages
.RE
.PP
\fB\-\-version\fR=\fIVALUE\fR
.RS 4
Use the specified version/branch instead of the latest available match
The remove command also accepts "*" here as a wildcard to remove all versions of the package from the specified location
.RE
.PP
\fB\-\-force\-remove\fR
.RS 4
Deprecated option that does nothing
.RE
.SS COMMON OPTIONS
See \fBdub\fR(1)
.SH EXIT STATUS
.TP
.BR 0
DUB succeeded
.TP
.BR 1
usage errors, unknown command line flags
.TP
.BR 2
package not found, package failed to load, miscellaneous error
.SH FILES
\fIdub\&.sdl\fR, \fIdub\&.json\fR
.SH AUTHOR
Copyright (c) 1999-2024 by The D Language Foundation
.SH ONLINE DOCUMENTATION
.URhttp://code.dlang.org/docs/commandline
http://code.dlang.org/docs/commandline
.UE
.SH SEE ALSO
\fBdub\fR(1), \fBdub-add\fR(1)