| name | Name of the tool | yes | — |
| version | Version of the tool
Required unless `url` is to a GitHub release asset, in which case the
latest release will be looked up if left blank.
| no | — |
| url | URL to installation archive. This value may contain interpolations for
name, version, os, arch, and extension.
`http://example.com/binaries/{name}/{version}.{os}_{arch}.{ext}`
`{name}` and `{version}` will match the other inputs. `{os}`, `{arch}` and
`{ext}`, will be inferred, but can be changed by setting additional
inputs.
| — | — |
| subdir | Subdirectory within the archive to find the executable(s). Supports the
same interpolations as `url`.
| — | — |
| os | `{os}` to use instead of `process.platform` | — | — |
| arch | `{arch}` to use instead of `process.arch` | — | — |
| ext | `{ext}` to use instead of inferring | — | — |
| no-extract | Do not extract the asset as an archive. Rather, expect that it represents
the (only) binary itself. It will be downloaded, cached, and available on
`$PATH` as `{name}`.
| — | — |
| url-darwin | `url` when `platform==darwin` | — | — |
| url-linux | `url` when `platform==linux` | — | — |
| url-win32 | `url` when `platform==win32` | — | — |
| url-x64 | `url` when `arch==x64` | — | — |
| url-darwin-x64 | `url` when `platform==darwin` and `arch==x64` | — | — |
| url-darwin-arm64 | `url` when `platform==darwin` and `arch==arm64` | — | — |
| url-linux-x64 | `url` when `platform==linux` and `arch==x64` | — | — |
| url-win32-x64 | `url` when `platform==win33` and `arch==x64` | — | — |
| subdir-darwin | `subdir` when `platform==darwin` | — | — |
| subdir-linux | `subdir` when `platform==linux` | — | — |
| subdir-win32 | `subdir` when `platform==win32` | — | — |
| subdir-x64 | `subdir` when `arch==x64` | — | — |
| subdir-arm64 | `subdir` when `arch==arm64` | — | — |
| subdir-darwin-x64 | `subdir` when `platform==darwin` and `arch==x64` | — | — |
| subdir-darwin-arm64 | `subdir` when `platform==darwin` and `arch==arm64` | — | — |
| subdir-linux-x64 | `subdir` when `platform==linux` and `arch==x64` | — | — |
| subdir-win32-x64 | `subdir` when `platform==win33` and `arch==x64` | — | — |
| os-darwin | `{os}` to use when `platform==darwin` | — | — |
| os-linux | `{os}` to use when `platform==linux` | — | — |
| os-win32 | `{os}` to use when `platform==win32` | — | — |
| os-x64 | `{os}` to use when `arch==x64` | — | — |
| os-arm64 | `{os}` to use when `arch==arm64` | — | — |
| os-darwin-x64 | `{os}` to use when `platform==darwin` and `arch==x64` | — | — |
| os-darwin-arm64 | `{os}` to use when `platform==darwin` and `arch==arm64` | — | — |
| os-linux-x64 | `{os}` to use when `platform==linux` and `arch==x64` | — | — |
| os-win32-x64 | `{os}` to use when `platform==win32` and `arch==x64` | — | — |
| arch-darwin | `{arch}` to use when `platform==darwin` | — | — |
| arch-linux | `{arch}` to use when `platform==linux` | — | — |
| arch-win32 | `{arch}` to use when `platform==win32` | — | — |
| arch-x64 | `{arch}` to use when `arch==x64` | — | — |
| arch-arm64 | `{arch}` to use when `arch==arm64` | — | — |
| arch-darwin-x64 | `{arch}` to use when `platform==darwin` and `arch==x64` | — | — |
| arch-darwin-arm64 | `{arch}` to use when `platform==darwin` and `arch==arm64` | — | — |
| arch-linux-x64 | `{arch}` to use when `platform==linux` and `arch==x64` | — | — |
| arch-win32-x64 | `{arch}` to use when `platform==win32` and `arch==x64` | — | — |
| ext-darwin | `{ext}` to use when `platform==darwin` | — | — |
| ext-linux | `{ext}` to use when `platform==linux` | — | — |
| ext-win32 | `{ext}` to use when `platform==win32` | — | — |
| ext-x64 | `{ext}` to use when `arch==x64` | — | — |
| ext-arm64 | `{ext}` to use when `arch==arm64` | — | — |
| ext-darwin-x64 | `{ext}` to use when `platform==darwin` and `arch==x64` | — | — |
| ext-darwin-arm64 | `{ext}` to use when `platform==darwin` and `arch==arm64` | — | — |
| ext-linux-x64 | `{ext}` to use when `platform==linux` and `arch==x64` | — | — |
| ext-win32-x64 | `{ext}` to use when `platform==win33` and `arch==x64` | — | — |
| github-token | If present, and `url` is to a GitHub release asset, we will assume it's
private and use this token to download the asset through the GitHub API.
https://docs.github.com/en/rest/releases/assets?apiVersion=2022-11-28#get-a-release-asset
| — | — |
| github-token-for-latest | Token used for looking up a latest release when `version` is blank, `url`
is to a GitHub release asset, and `github-token` is not set. This is to
avoid rate limits when interacting with public releases.
| — | ${{ github.token }} |