gt-run-download1

Usage

Overview

Download the artifacts of a run and extract them.

Each artifact is extracted into a directory named after it, except a single artifact selected with --name, which is extracted into the destination directory itself. With --zip, the artifacts are saved as ZIP archives instead.

A run can be supplied as its ID ("34", "#34") or its URL
("https://gitea.example.com/OWNER/REPO/actions/runs/34"). Without an argument,
gt asks for one of the repository's recent runs in a terminal.

Options

--clobber[=false]
Replace an existing file

-D, --dir=""
Directory to download into

-h, --help[=false]
help for download

-n, --name=[]
Only download the artifacts with these names

-O, --output=""
File or directory to write to, or - for standard output (default: the download's name)

--skip-existing[=false]
Keep an existing file and skip the download

--zip[=false]
Save each artifact as a ZIP archive instead of extracting it

Options inherited from parent commands

--cwd=""
Working directory for repository discovery

--debug[=false]
Log the method, URL, status, and duration of each HTTP request to stderr

--host=""
Gitea instance URL, including any base path

--interactive[=false]
Allow prompts with machine output

--no-input[=false]
Disable prompts and implicit editor/browser interactions

--remote=""
Git remote used for repository discovery

-R, --repo=""
Select a repository as OWNER/REPO or URL

--sudo=""
Perform API requests as this user (requires an administrator account)

--user=""
Account name on the selected instance

Examples

# download every artifact of a run into ./<artifact name>/
$ gt run download 34
# extract one artifact into dist/
$ gt run download 34 --name build --dir dist
# save the artifacts as ZIP archives
$ gt run download 34 --zip