File uploads

CLI commands for repo-scoped file uploads.

Overview List Get Create Update Delete Content

Sections

List file uploads Get file upload Create file upload Update file upload Delete file upload Download file upload content

Commands

  • list-file-uploads
  • get-file-upload
  • create-file-upload
  • list-file-upload-groups, get-file-upload-group, create-file-upload-group, and update-file-upload-group
  • update-file-upload
  • delete-file-upload
  • download-file-upload-content
  • attach-file and detach-file

Examples

pearing-cli list-file-uploads teams/platform/website
pearing-cli create-file-upload website \
  --file ./screenshot.png \
  --description "Build screenshot"
pearing-cli create-file-upload-group website \
  --file ./before.png \
  --file ./after.png \
  --name "Before and after"
pearing-cli download-file-upload-content website a1b2c3d4-... --output ./screenshot.png

Help Output

list-file-uploads <REPO>
get-file-upload <REPO> <UUID>
create-file-upload [OPTIONS] --file <FILE> <REPO>
list-file-upload-groups <REPO>
get-file-upload-group <REPO> <UUID>
create-file-upload-group [OPTIONS] --file <FILE>... <REPO>
update-file-upload-group [OPTIONS] <REPO> <UUID>
update-file-upload [OPTIONS] <REPO> <UUID>
delete-file-upload <REPO> <UUID>
download-file-upload-content [OPTIONS] <REPO> <UUID>

Notes

  • create-file-upload reads a local file and uploads it as multipart form data.
  • create-file-upload-group requires at least two repeatable --file values. It preserves their order and fails without creating any members if a configured limit or write fails.
  • download-file-upload-content writes the stored bytes to stdout unless --output is set.
  • Deletes are permanent from the caller's perspective; the underlying soft-delete is an implementation detail.
  • Use attach-file to associate an upload with content after creating it.