blob: 35a94c6e5681686058823efaed4c3ec3af46fcb6 [file] [log] [blame]
.TH "BST SOURCE FETCH" "1" "2020-10-14" "" "bst source fetch Manual"
.SH NAME
bst\-source\-fetch \- Fetch sources in a pipeline
.SH SYNOPSIS
.B bst source fetch
[OPTIONS] [ELEMENTS]...
.SH DESCRIPTION
Fetch sources required to build the pipeline
.PP
Specifying no elements will result in fetching the default targets
of the project. If no default targets are configured, all project
elements will be fetched.
.PP
When this command is executed from a workspace directory, the default
is to fetch the workspace element.
.PP
By default this will only try to fetch sources which are
required for the build plan of the specified target element,
omitting sources for any elements which are already built
and available in the artifact cache.
.PP
Specify `--deps` to control which sources to fetch:
.PP

none: No dependencies, just the element itself
plan: Only dependencies required for the build plan
run: Runtime dependencies, including the element itself
build: Build time dependencies, excluding the element itself
all: All dependencies
.SH OPTIONS
.TP
\fB\-\-except\fP PATH
Except certain dependencies from fetching
.TP
\fB\-d,\fP \-\-deps [plan|none|build|run|all]
The dependencies to fetch [default: plan]
.TP
\fB\-r,\fP \-\-remote TEXT
The URL of the remote source cache (defaults to the first configured cache)