BST ARTIFACT(1)

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.