1BST SHOW(1)                     bst show Manual                    BST SHOW(1)
2
3
4

NAME

6       bst-show - Show elements in the pipeline
7

SYNOPSIS

9       bst show [OPTIONS] [ELEMENTS]...
10

DESCRIPTION

12       Show elements in the pipeline
13
14       By default this will show all of the dependencies of the specified tar‐
15       get element.
16
17       Specify `--deps` to control which elements to show:
18
19
20           none:  No dependencies, just the element itself
21           plan:  Dependencies required for a build plan
22           run:   Runtime dependencies, including the element itself
23           build: Build time dependencies, excluding the element itself
24           all:   All dependencies
25
26       FORMAT ~~~~~~ The --format option controls what should be  printed  for
27       each element, the following symbols can be used in the format string:
28
29
30           %{name}           The element name
31           %{key}             The  abbreviated  cache  key (if all sources are
32       consistent)
33           %{full-key}       The full cache key (if all  sources  are  consis‐
34       tent)
35           %{state}          cached, buildable, waiting or inconsistent
36           %{config}         The element configuration
37           %{vars}           Variable configuration
38           %{env}            Environment settings
39           %{public}         Public domain data
40           %{workspaced}     If the element is workspaced
41           %{workspace-dirs} A list of workspace directories
42
43       The  value of the %{symbol} without the leading '%' character is under‐
44       stood as a pythonic formatting string, so  python  formatting  features
45       apply, examle:
46
47
48           bst  show  target.bst  --format          'Name:  %{name:  ^20} Key:
49       %{key: ^8} State: %{state}'
50
51       If you want to use a newline in a format string in bash,  use  the  '$'
52       modifier:
53
54
55           bst   show   target.bst   --format           $'----------   %{name}
56       ----------1{vars}'
57

OPTIONS

59       --except PATH
60              Except certain dependencies
61
62       -d, --deps [none|plan|run|build|all]
63              The dependencies to show (default: all)
64
65       --order [stage|alpha]
66              Staging or alphabetic ordering of dependencies
67
68       -f, --format FORMAT
69              Format string for each element
70
71
72
73                                  14-Jul-2019                      BST SHOW(1)