GitHub - astral-sh/ruff-action: A GitHub Action to run Ruff (original) (raw)

ruff-action

A GitHub Action to run ruff.

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 ruff, the action can do anything ruff can (ex, fix).

Contents

• Usage
  • Basic
  • Specify a different source directory
  • Specify multiple files
  • Use to install ruff
  • Use ruff format
  • Install specific versions
    * Install the latest version
    * Install a specific version
    * Install a version by supplying a semver range
    * Install a version from a specified version file
  • Validate checksum
  • GitHub authentication token
• Outputs

Usage

Basic

• uses: astral-sh/ruff-action@v3

Specify a different source directory

• uses: astral-sh/ruff-action@v3 with: src: "./src"

Specify multiple files

• uses: astral-sh/ruff-action@v3 with: src: >- path/to/file1.py path/to/file2.py

Use to install ruff

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

• uses: astral-sh/ruff-action@v3
• run: ruff check --fix
• run: ruff format

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

• name: Install ruff without running check or format uses: astral-sh/ruff-action@v3 with: args: "--version"

Use ruff format

• uses: astral-sh/ruff-action@v3 with: args: "format --check --diff"

Install specific versions

By default this action looks for a pyproject.toml file in the root of the repository to determine the ruff version to install. If no pyproject.toml file is found, or no ruff version is defined inproject.dependencies, project.optional-dependencies, or dependency-groups, the latest version is installed.

Install the latest version

• name: Install the latest version of ruff uses: astral-sh/ruff-action@v3 with: version: "latest"

Install a specific version

• name: Install a specific version of ruff uses: astral-sh/ruff-action@v3 with: version: "0.4.4"

Install a version by supplying a semver range

You can specify a semver rangeto install the latest version that satisfies the range.

• name: Install a semver range of ruff uses: astral-sh/ruff-action@v3 with: version: ">=0.4.0"

• name: Pinning a minor version of ruff uses: astral-sh/ruff-action@v3 with: version: "0.4.x"

Install a version from a specified version file

You can specify a file to read the version from. Currently pyproject.toml and requirements.txt are supported.

• name: Install a version from a specified version file uses: astral-sh/ruff-action@v3 with: version-file: "my-path/to/pyproject.toml-or-requirements.txt"

Validate checksum

You can specify a checksum to validate the downloaded executable. Checksums up to the default version are automatically verified by this action. The sha256 hashes can be found on thereleases page of the ruff repo.

• name: Install a specific version and validate the checksum uses: astral-sh/ruff-action@v3 with: version: "0.7.4" checksum: "0de731c669b9ece77e799ac3f4a160c30849752714d9775c94cc4cfaf326860c"

GitHub authentication token

This action uses the GitHub API to fetch the ruff 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 defaultpermissions for the GitHub tokenare not sufficient, you can provide a custom GitHub token with the necessary permissions.

• name: Install the latest version of ruff with a custom GitHub token uses: astral-sh/ruff-action@v3 with: github-token: ${{ secrets.CUSTOM_GITHUB_TOKEN }}

Outputs