NAME

bst - Build and manipulate BuildStream projects...

SYNOPSIS

bst [OPTIONS] COMMAND [ARGS]...

DESCRIPTION

Build and manipulate BuildStream projects
Most of the main options override options in the user preferences configuration file.

OPTIONS

--version
-c, --config FILE
Configuration file to use
-C, --directory DIRECTORY
Project directory (default: current directory)
--on-error [continue|quit|terminate]
What to do when an error is encountered
--fetchers INTEGER
Maximum simultaneous download tasks
--builders INTEGER
Maximum simultaneous build tasks
--pushers INTEGER
Maximum simultaneous upload tasks
--max-jobs INTEGER
Number of parallel jobs allowed for a given build task
--network-retries INTEGER
Maximum retries for network tasks
--no-interactive
Force non interactive mode, otherwise this is automatically decided
--verbose / --no-verbose
Be extra verbose
--debug / --no-debug
Print debugging output
--error-lines INTEGER
Maximum number of lines to show from a task log
--message-lines INTEGER
Maximum number of lines to show in a detailed message
--log-file FILENAME
A file to store the main log (allows storing the main log while in interactive mode)
--colors / --no-colors
Force enable/disable ANSI color codes in output
--strict / --no-strict
Elements must be rebuilt when their dependencies have changed
-o, --option OPTION VALUE
Specify a project option
--default-mirror TEXT
The mirror to fetch from first, before attempting other mirrors

COMMANDS

help
Print usage information
See bst-help(1) for full documentation on the help command.
init
Initialize a new BuildStream project
See bst-init(1) for full documentation on the init command.
build
Build elements in a pipeline
See bst-build(1) for full documentation on the build command.
fetch
Fetch sources in a pipeline
See bst-fetch(1) for full documentation on the fetch command.
track
Track new source references
See bst-track(1) for full documentation on the track command.
pull
Pull a built artifact
See bst-pull(1) for full documentation on the pull command.
push
Push a built artifact
See bst-push(1) for full documentation on the push command.
show
Show elements in the pipeline
See bst-show(1) for full documentation on the show command.
shell
Shell into an element's sandbox environment
See bst-shell(1) for full documentation on the shell command.
checkout
Checkout a built artifact
See bst-checkout(1) for full documentation on the checkout command.
workspace
Manipulate developer workspaces
See bst-workspace(1) for full documentation on the workspace command.
source-bundle
Produce a build bundle to be manually executed
See bst-source-bundle(1) for full documentation on the source-bundle command.