Skip to content

etiennebacher/setup-jarl

Repository files navigation

setup-jarl

A GitHub Action to run jarl.

This action is commonly used as a pass/fail test to ensure your repository stays clean, abiding the rules specified in your configuration. Though it runs jarl check by default, the action can do anything jarl can (ex, fix).

Contents

Usage

Input Description Default
version The version of Jarl to install. See Install specific versions latest
args The arguments to pass to the jarl command. See Configuring Jarl check
src The directory or single files to run jarl on. github.workspace
github-token The GitHub token to use for authentication. GITHUB_TOKEN

Basic

- uses: etiennebacher/setup-jarl@v0.1.0

Specify a different source directory

- uses: etiennebacher/setup-jarl@v0.1.0
  with:
    src: "./R"

Specify multiple files

- uses: etiennebacher/setup-jarl@v0.1.0
  with:
    src: >-
      path/to/file1.r
      path/to/file2.r

Use to install jarl

This action adds jarl to the PATH, so you can use it in subsequent steps.

- uses: etiennebacher/setup-jarl@v0.1.0
- run: jarl check --fix

By default, this action runs jarl check after installation. If you do not want to run any jarl command but only install it, you can use the args input to overwrite the default value (check):

- name: Install jarl without running check
  uses: etiennebacher/setup-jarl@v0.1.0
  with:
    args: "--version"

Install specific versions

Install the latest version (default)

- name: Install the latest version of jarl
  uses: etiennebacher/setup-jarl@v0.1.0
  with:
    version: "latest"

Install a specific version

- name: Install a specific version of jarl
  uses: etiennebacher/setup-jarl@v0.1.0
  with:
    version: "0.4.4"

GitHub authentication token

This action uses the GitHub API to fetch the jarl release artifacts. To avoid hitting the GitHub API rate limit too quickly, an authentication token can be provided via the github-token input. By default, the GITHUB_TOKEN secret is used, which is automatically provided by GitHub Actions.

If the default permissions for the GitHub token are not sufficient, you can provide a custom GitHub token with the necessary permissions.

- name: Install the latest version of jarl with a custom GitHub token
  uses: etiennebacher/setup-jarl@v0.1.0
  with:
    github-token: ${{ secrets.CUSTOM_GITHUB_TOKEN }}

Outputs

Output Description
jarl-version The version of Jarl that was installed.

About

No description, website, or topics provided.

Resources

License

Stars

Watchers

Forks

Packages

No packages published