bob-show
Name
bob-show - Show properties of a package
Synopsis
bob show [-h] [-D DEFINES] [-c CONFIGFILE] [--sandbox | --no-sandbox]
[--show-empty] [--show-common] [--indent INDENT | --no-indent]
[--format {yaml,json,flat,diff}]
[-f {buildNetAccess,buildTools,buildToolsWeak,buildVars,buildVarsWeak,
checkoutAssert,checkoutDeterministic,checkoutSCM,checkoutTools,
checkoutToolsWeak,checkoutVars,checkoutVarsWeak,depends,
fingerprintIf,jobServer,meta,metaEnvironment,packageNetAccess,
packageTools,packageToolsWeak,packageVars,packageVarsWeak,
relocatable,root,sandbox,scriptLanguage,shared}]
packages [packages ...]
Description
Show properties of one or more packages. Most properties are the same that are specified in the recipes. This command will show the final values of the properties that are used at build time. Additionally to the recipe properties the following synthetic properties are shown:
meta
: Map of sub-properties that describe the packagedeterministic
: True if Bob thinks the package is fully reproducible. False if some input of the package is variable.name
: The package namepackage
: The package pathrecipe
: The recipe name that created this packagecheckoutVariantId
: The variant-Id of the package step. Different checkout variant-Ids are always checked out separately.buildVariantId
: The variant-Id of the build step.packageVariantId
: The variant-Id of the package. See implicit versioning concepts for more details.
sandbox
: The sandbox package that is used for this package.
By default the information is shown as YAML document. If multiple packages are
selected then multiple YAML documents are generated too. The output format can
be controlled with the --format
option. The flat
format is a custom
output format where each key/value pair is printed on a separate line.
The diff
output mode is special because it compares two packages and shows
the properties that are different between both packages.
Options
-f FIELD
Show only the given
FIELD
. This option may be specified more than once to show additional fields. If this option is not given then all fields are show.--format {yaml,json,flat,diff}
Selects a different output format. Defaults to
yaml
.--indent INDENT
The
yaml
andjson
output formats are pretty printed with an indentation of 4 spaces by default. Use this option to chance this toINDENT
number of spaces.--no-indent
Disables the pretty printing of the
yaml
andjson
formats. The output will be more compact but is less readable.--no-sandbox
Disable sandboxing.
--sandbox
Enable sandboxing.
--show-common
The
diff
format suppresses identical fields by default. This option forces them to be shown.--show-empty
By default empty or disabled properties are filtered out to keep the output as short as possible. Specifying this option will still show them. If the package does not have a checkout- or build-step the respective properties do not exist and will never be shown.