Skip to content

Github Action to download an asset from a Github release

License

Notifications You must be signed in to change notification settings

pau1ocampos/fetch-gh-release-asset

 
 

Repository files navigation

Fetch GH Release Asset

This action downloads an asset from a GitHub release and provides some release details as output. Private repos are supported.

Inputs

file

Required The name of the file to be downloaded.

repo

The org/repo containing the release. Defaults to the current repo.

token

The GitHub token. Defaults to ${{ secrets.GITHUB_TOKEN }}

version

The release version to fetch from in the form tags/<tag_name> or <release_id>. Defaults to latest.

target

Target file path. Only supports paths to subdirectories of the GitHub Actions workspace directory.

regex

Boolean indicating if file is to be interpreted as regular expression. Defaults to false.

octokitBaseUrl

The Github API base URL. Useful if you are using Github Enterprise.

Outputs

version

The version number of the release tag. Can be used to deploy for example to itch.io

name

Also called a title of a release. Defaults to the same value as version if not specified when creating a release.

body

The body (description) of a release.

Example usage

Save a single asset as a new file <workspace>/plague-linux.zip:

uses: dsaltares/fetch-gh-release-asset@master
with:
  repo: 'dsaltares/godot-wild-jam-18'
  version: 'tags/v0.1.18'
  file: 'plague-linux.zip'
  token: ${{ secrets.GITHUB_TOKEN }}

Save a single asset as a new file <workspace>/subdir/plague-linux.zip:

uses: dsaltares/fetch-gh-release-asset@master
with:
  repo: 'dsaltares/godot-wild-jam-18'
  version: 'tags/v0.1.18'
  file: 'plague-linux.zip'
  target: 'subdir/plague-linux.zip'
  token: ${{ secrets.GITHUB_TOKEN }}

Save a range of assets as new files in directory <workspace>:

uses: dsaltares/fetch-gh-release-asset@master
with:
  repo: 'dsaltares/godot-wild-jam-18'
  version: 'tags/v0.1.18'
  regex: true
  file: "plague-.*\\.zip"
  token: ${{ secrets.GITHUB_TOKEN }}

Save a range of assets as new files in directory <workspace>/subdir:

uses: dsaltares/fetch-gh-release-asset@master
with:
  repo: 'dsaltares/godot-wild-jam-18'
  version: 'tags/v0.1.18'
  regex: true
  file: "plague-.*\\.zip"
  target: 'subdir/'
  token: ${{ secrets.GITHUB_TOKEN }}

Support

This action only supports Linux runners as this is a docker container action. If you encounter Error: Container action is only supported on Linux then you are using non-linux runner.

About

Github Action to download an asset from a Github release

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages

  • TypeScript 100.0%