Skip to content
play

GitHub Action

pkgx/setup

v2.0.2 Latest version

pkgx/setup

play

pkgx/setup

Installs `pkgx` to your GitHub Actions runner.

Installation

Copy and paste the following snippet into your .yml file.

              

- name: pkgx/setup

uses: pkgxdev/[email protected]

Learn more about this action in pkgxdev/setup

Choose a version

pkgx

  • This repository provides the pkgx GitHub Action.
  • It also hosts installer.sh; the result of curl pkgx.sh.

GitHub Action

- uses: pkgxdev/setup@v1

Installs the latest version of pkgx.

See action.yml for all inputs and outputs, but here’s the usual ones:

- uses: pkgxdev/setup@v1
  with:
    +: [email protected]
       [email protected]   # we understand colloquial names, generally just type what you know
       clang       # versions aren’t necessary if you don’t care

The easiest way to know if it will work in the action is to try it locally on your computer:

$ pkgx +rust
# if there’s output, we got it

See @pkgxdev/dev to run the dev command in a GitHub Actions compatible manner

Shell Integration

We cannot integrate with the GitHub Actions shell. But you probably don’t need it.

Should you Cache ~/.pkgx?

No. pkgx packages are just tarballs. Caching is just a tarball. You’ll likely just slow things down.

 

The pkgx Installer

To install pkgx:

$ curl https://pkgx.sh | sh

# - installs to `/usr/local/bin/pkgx`
# - if pkgx is already installed it’s a noop

Temporary Sandboxes

To use pkgx to run a command in a temporary sandbox:

$ curl -Ssf https://pkgx.sh | sh -s -- gum spin -- sleep 5

# - if pkgx is installed, uses that installation to run gum
# - if pkgx *isn’t* installed, downloads pkgx to a temporary location
# - if pkgx *isn’t* installed, packages are also cached to a temporary location

This usage of our installer can be useful for demonstrative purposes in READMEs and gists.

This syntax is easier to remember:

sh <(curl -L pkgx.sh) gum spin -- sleep 5

There is the notable caveat that the above easier syntax will not work with bash <4 which is the bash that comes with macOS. Even though macOS has defaulted to zsh for years it is still relatively easy for users to end up in a situation where bash is the shell interpreting your commands. Your call.

Additionally, use of -L is subject to man-in-the-middle attacks. Again your call.