bob-layers

Name

bob-layers - Handle layers

Synopsis

bob layers update [-h] [-lc LAYERCONFIG] [-D DEFINES]
                  [--indent INDENT | --no-indent]
                  [--format {yaml,json,flat}]
bob layers status [-h] [-lc LAYERCONFIG] [-D DEFINES] [--show-clean]
                  [--show-overrides] [-v]
bob layers update [-h] [-lc LAYERCONFIG] [-D DEFINES]
                  [--attic | --no-attic] [-v]

Description

Update layers or show their status. The following sub-commands are available:

ls

List known layers and their properties. There are multiple output formats available. The output of this command is supposed to stay stable and is thus suitable for scripting.

update

Updates the layers.

status

Show the SCM-status of each layer and optionally list modifications. See bob status for a description of the output fields.

Options

--attic

Move layer workspace to attic if inline SCM switching is not possible. (Default)

--no-attic

Do not move layer workspace to attic if inline SCM switching is not possible. Instead a build error is issued.

--format {yaml,json,flat}

Selects a different output format. Defaults to yaml. The flat format is an INI-style format where each key/value pair is printed on a separate line.

--indent INDENT

The yaml and json output formats are pretty printed with an indentation of 4 spaces by default. Use this option to chance this to INDENT number of spaces.

--no-indent

Disables the pretty printing of the yaml and json formats. The output will be more compact but is less readable.

-lc LAYERCONFIG

Use additional layer configuration file.

This configuration file is used to control the layers checkout. It support only a subset of the Project configuration (config.yaml) file keys, namely layersInclude, layersRequire, layersScmOverrides and layersWhitelist

The .yaml suffix is appended automatically and the configuration file is searched relative to the build directory, unless an absolute path is given. This option can be given multiple times. The files will be parsed in the order as they appeared on the command line. Later files on the command line have a higher precedence.

-D VAR=VALUE

Override default or set environment variable.

Sets the variable VAR to VALUE. This overrides the value possibly set by default.yaml, config files passed by -c or any file that was included by either of these files.

--show-clean

Show the status of a layer even if unmodified. This includes --show-overrides.

--show-overrides

Show layers that have active layersScmOverrides (O) even if the layer is unchanged. Override information is always displayed if a layer is shown but a STATUS line is normally only emitted if the SCM was modified. Adding -v will additionally show the detailed override status.

-v, --verbose

Increase verbosity (may be specified multiple times)