.TH DUB-FETCH 1 "2023-11-04" "The D Language Foundation" "The D Language Foundation"
.SH NAME
dub-fetch \- Manually retrieves and caches a package
.SH SYNOPSIS
\fBdub fetch \fR<\fIpackage\fR>[@<\fIversion-spec\fR>] \fIOPTIONS\&.\&.\&.\fR
.SH DESCRIPTION
Note: Use "dub add <dependency>" if you just want to use a certain package as a dependency, you don't have to explicitly fetch packages.



Explicit retrieval/removal of packages is only needed when you want to put packages in a place where several applications can share them. If you just have a dependency to add, use the `add` command. Dub will do the rest for you.



Without specified options, placement/removal will default to a user wide shared location.



Complete applications can be retrieved and run easily by e.g.

$ dub fetch vibelog --cache=local

$ dub run vibelog --cache=local



This will grab all needed dependencies and compile and run the application.
.SH OPTIONS
.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-2023 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)