man/bst-artifact.1

.TH "BST ARTIFACT" "1" "2020-10-14" "" "bst artifact Manual"
.SH NAME
bst\-artifact \- Manipulate cached artifacts.
.SH SYNOPSIS
.B bst artifact
[OPTIONS] COMMAND [ARGS]...
.SH DESCRIPTION
Manipulate cached artifacts
.PP
Some subcommands take artifact references as arguments. Artifacts
can be specified in two ways:
.PP

- artifact refs: triples of the form <project name>/<element name>/<cache key>
- element paths
.PP
When elements are given, the artifact corresponding to the element is used.
.PP
The commands also support shell-style wildcard expansion: `?` matches a
single character, and `*` matches zero or more. The patterns are matched
against artifact refs by default. If the pattern ends with `.bst` then
it matches element paths instead. Some example arguments are:
.PP

- `myproject/hello/8276376b077eda104c812e6ec2f488c7c9eea211ce572c83d734c10bf241209f`
- `myproject/he*/827637*`
- `*.bst` (all elements)
- `myproject/*` (all artifacts from myproject)
.SH COMMANDS
.PP
\fBshow\fP
  Show the cached state of artifacts
  See \fBbst artifact-show(1)\fP for full documentation on the \fBshow\fP command.
.PP
\fBcheckout\fP
  Checkout contents of an artifact
  See \fBbst artifact-checkout(1)\fP for full documentation on the \fBcheckout\fP command.
.PP
\fBpull\fP
  Pull a built artifact
  See \fBbst artifact-pull(1)\fP for full documentation on the \fBpull\fP command.
.PP
\fBpush\fP
  Push a built artifact
  See \fBbst artifact-push(1)\fP for full documentation on the \fBpush\fP command.
.PP
\fBlog\fP
  Show logs of artifacts
  See \fBbst artifact-log(1)\fP for full documentation on the \fBlog\fP command.
.PP
\fBlist-contents\fP
  List the contents of an artifact
  See \fBbst artifact-list-contents(1)\fP for full documentation on the \fBlist-contents\fP command.
.PP
\fBdelete\fP
  Remove artifacts from the local cache
  See \fBbst artifact-delete(1)\fP for full documentation on the \fBdelete\fP command.