bst-artifact - Man Page

bst artifact [OPTIONS] COMMAND [ARGS]...

Manipulate cached artifacts

   Some subcommands take artifact references as arguments. Artifacts
   can be specified in two ways:

   
   - artifact refs: triples of the form <project name>/<element name>/<cache key>
   - element names

   When elements are given, the artifact is looked up by observing the element
   and it's current cache key.

   The commands also support shell-style wildcard expansion: `?` matches a
   single character, `*` matches zero or more characters but does not match the `/`
   path separator, and `**` matches zero or more characters including `/` path separators.

   If the wildcard expression ends with `.bst`, then it will be used to search
   element names found in the project, otherwise, it will be used to search artifacts
   that are present in the local artifact cache.

   Some example arguments are:

   
   - `myproject/hello/8276376b077eda104c812e6ec2f488c7c9eea211ce572c83d734c10bf241209f`
   - `myproject/he*/827637*`
   - `core/*.bst` (all elements in the core directory)
   - `**.bst` (all elements)
   - `myproject/**` (all artifacts from myproject)
   - `myproject/myelement/*` (all cached artifacts for a specific element)
   

show
 Show the cached state of artifacts
 See bst artifact-show(1) for full documentation on the show command.

checkout
 Checkout contents of an artifact
 See bst artifact-checkout(1) for full documentation on the checkout command.

pull
 Pull a built artifact
 See bst artifact-pull(1) for full documentation on the pull command.

push
 Push a built artifact
 See bst artifact-push(1) for full documentation on the push command.

log
 Show logs of artifacts
 See bst artifact-log(1) for full documentation on the log command.

list-contents
 List the contents of an artifact
 See bst artifact-list-contents(1) for full documentation on the list-contents command.

delete
 Remove artifacts from the local cache
 See bst artifact-delete(1) for full documentation on the delete command.