https://github.com/extractions/setup-just
🤖 GitHub Action to install the just command runner
https://github.com/extractions/setup-just
actions github github-actions just
Last synced: 22 days ago
JSON representation
🤖 GitHub Action to install the just command runner
- Host: GitHub
- URL: https://github.com/extractions/setup-just
- Owner: extractions
- License: apache-2.0
- Created: 2020-04-24T12:46:57.000Z (about 5 years ago)
- Default Branch: trunk
- Last Pushed: 2025-03-15T13:11:06.000Z (3 months ago)
- Last Synced: 2025-05-05T19:49:18.383Z (about 1 month ago)
- Topics: actions, github, github-actions, just
- Language: Just
- Homepage:
- Size: 514 KB
- Stars: 116
- Watchers: 1
- Forks: 11
- Open Issues: 1
-
Metadata Files:
- Readme: README.md
- License: LICENSE-APACHE
Awesome Lists containing this project
README
# 🤖 `setup-just` action
[](https://github.com/extractions/setup-just/actions/workflows/build.yaml)
This GitHub Action will install a release of the
[just](https://github.com/casey/just) command runner for you.
## Usage
### Examples
In most cases all you will need is the following in your workflow.
```yaml
- uses: extractions/setup-just@v3
```
If you want a specific version of `just` you can specify this by passing the
`just-version` input.
```yaml
- uses: extractions/setup-just@v3
with:
just-version: '1.40.0'
```
To avoid rate-limiting, the default Github token available to all actions, is
automatically used to authenticate calls to Github. To override it, pass the
input `github-token`.
```yaml
- uses: extractions/setup-just@v3
with:
github-token: ${{ secrets.MY_GITHUB_TOKEN }}
```
### Inputs
| Name | Required | Description | Type | Default |
| -------------- | -------- | -------------------------------------------- | ------ | --------------------- |
| `just-version` | no | A valid NPM-style semver specification. | string | * |
| `github-token` | no | A Github token to authenticate API requests. | string | `${{ github.token }}` |
The semver specification is passed directly to NPM's [semver
package](https://www.npmjs.com/package/semver). This GitHub Action will install
the latest matching release. Examples include
- `just-version: '*'` latest version (default).
- `just-version: '1'` equivalent to `>=1.0.0 <2.0.0`.
- `just-version: '1.2'` equivalent to `>=1.2.0 <2.0.0`.
- `just-version: '1.2.3'` equivalent to `=1.2.3`.
- `just-version: '^1.2.3'` equivalent to `>=1.2.3 <2.0.0`.
## Development
This action is a composite action and the installation logic is done in a shared
library located at
[@extractions/setup-crate](https://github.com/extractions/setup-crate).
## License
Licensed under either of
- Apache License, Version 2.0 ([LICENSE-APACHE](LICENSE-APACHE) or
http://www.apache.org/licenses/LICENSE-2.0)
- MIT license ([LICENSE-MIT](LICENSE-MIT) or http://opensource.org/licenses/MIT)
at your option.