@codacy/tools-ruff-0

Table of Contents

• Overview
• Updating patterns
• Updating the Ruff version
• Development
• Notes for maintainers

Overview

Python linter using the Ruff binary. Ruff is an extremely fast Python linter written in Rust that implements rules from Flake8, isort, pyupgrade, and many other tools. Uses the CLI execution strategy.

| Property | Value | |----------|-------| | Tool ID | Ruff | | Codacy UUID | aac6ad5e-093d-47c4-97ff-87f91d6128a2 | | Strategy | CLI | | Languages | Python | | Binary | ruff | | File patterns | **/*.py, **/*.pyi, **/*.ipynb | | Pattern count | ~773 |

Updating patterns

# Re-fetch pattern metadata from the Codacy API
pnpm prefetch

# Commit the result
git add src/patterns.json

Pattern IDs follow the format Ruff_F401_unused-import, Ruff_E501_line-too-long, etc.

Updating the Ruff version

1. Update preferredVersion in src/adapter.ts
2. Run pnpm prefetch — Ruff adds new rules frequently
3. Run pnpm test to verify compatibility
4. If the major version changes, create a new adapter package (ruff-1/)

Development

pnpm build    # Build with tsup
pnpm test     # Run tests (requires ruff in PATH or auto-install)

Notes for maintainers

• Ruff is a standalone Rust binary, downloaded from GitHub releases as a .tar.gz archive.
• Installation uses downloadAndExtract() with stripComponents: 1 because the archive wraps the binary in a directory (e.g. ruff-aarch64-apple-darwin/ruff).
• JSON output via ruff check --output-format json.
• --exit-zero ensures exit code 0 even when findings exist.
• --no-cache disables Ruff's file cache for reproducible results.
• When patterns are specified, a ruff.toml config with select = [...] is generated.
• Config file search order: .ruff.toml, ruff.toml, pyproject.toml.