Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/pkgxdev/setup
GitHub Action and `curl pkgx.sh | sh`
https://github.com/pkgxdev/setup
github-actions installer-script
Last synced: 5 days ago
JSON representation
GitHub Action and `curl pkgx.sh | sh`
- Host: GitHub
- URL: https://github.com/pkgxdev/setup
- Owner: pkgxdev
- License: apache-2.0
- Created: 2022-02-10T15:37:49.000Z (almost 3 years ago)
- Default Branch: main
- Last Pushed: 2024-09-10T16:55:26.000Z (4 months ago)
- Last Synced: 2024-10-15T12:34:40.821Z (2 months ago)
- Topics: github-actions, installer-script
- Language: Shell
- Homepage:
- Size: 6.58 MB
- Stars: 135
- Watchers: 11
- Forks: 47
- Open Issues: 21
-
Metadata Files:
- Readme: README.md
- License: LICENSE.txt
Awesome Lists containing this project
README
* This repository provides the `pkgx` GitHub Action.
* It also hosts [`installer.sh`](./installer.sh); the result of `curl pkgx.sh`.
# GitHub Action
```yaml
- uses: pkgxdev/setup@v1
```
Installs the latest version of `pkgx`.
See [`action.yml`] for all inputs and outputs, but here’s the usual ones:
```yaml
- 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`:
```sh
$ 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:
```sh
$ 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
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**.
[`action.yml`]: ./action.yml
[`@pkgxdev/dev`]: https://github.com/pkgxdev/dev