mirror of
https://github.com/astral-sh/ruff.git
synced 2025-08-01 17:32:25 +00:00
42 lines
1.2 KiB
Markdown
42 lines
1.2 KiB
Markdown
# Using Ruff
|
|
|
|
To run Ruff, try any of the following:
|
|
|
|
```shell
|
|
ruff check . # Lint all files in the current directory (and any subdirectories)
|
|
ruff check path/to/code/ # Lint all files in `/path/to/code` (and any subdirectories)
|
|
ruff check path/to/code/*.py # Lint all `.py` files in `/path/to/code`
|
|
ruff check path/to/code/to/file.py # Lint `file.py`
|
|
```
|
|
|
|
You can run Ruff in `--watch` mode to automatically re-run on-change:
|
|
|
|
```shell
|
|
ruff check path/to/code/ --watch
|
|
```
|
|
|
|
Ruff can also be used as a [pre-commit](https://pre-commit.com) hook:
|
|
|
|
```yaml
|
|
- repo: https://github.com/charliermarsh/ruff-pre-commit
|
|
# Ruff version.
|
|
rev: 'v0.0.255'
|
|
hooks:
|
|
- id: ruff
|
|
```
|
|
|
|
Or, to enable autofix:
|
|
|
|
```yaml
|
|
- repo: https://github.com/charliermarsh/ruff-pre-commit
|
|
# Ruff version.
|
|
rev: 'v0.0.255'
|
|
hooks:
|
|
- id: ruff
|
|
args: [--fix, --exit-non-zero-on-fix]
|
|
```
|
|
|
|
Note that Ruff's pre-commit hook should run before Black, isort, and other formatting tools.
|
|
|
|
Ruff can also be used as a [VS Code extension](https://github.com/charliermarsh/ruff-vscode) or
|
|
alongside any other editor through the [Ruff LSP](https://github.com/charliermarsh/ruff-lsp).
|