NAME¶

bst-artifact - Manipulate cached artifacts.

SYNOPSIS¶

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

DESCRIPTION¶

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)

COMMANDS¶

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.