mirror of
https://github.com/astral-sh/ruff.git
synced 2025-09-28 21:05:08 +00:00
8118d29419
## Summary Long ago, we had a single `ruff` crate. We started to break that up, and at some point, we wanted to separate the CLI from the core library. So we created `ruff_cli`, which created a `ruff` binary. Later, the `ruff` crate was renamed to `ruff_linter` and further broken up into additional crates. (This is all from memory -- I didn't bother to look through the history to ensure that this is 100% correct :)) Now that `ruff` no longer exists, this PR renames `ruff_cli` to `ruff`. The primary benefit is that the binary target and the crate name are now the same, which helps with downstream tooling like `cargo-dist`, and also removes some complexity from the crate and `Cargo.toml` itself. ## Test Plan - Ran `rm -rf target/release`. - Ran `cargo build --release`. - Verified that `./target/release/ruff` was created.
96 lines
5.1 KiB
Markdown
96 lines
5.1 KiB
Markdown
# project
|
|
|
|
An example multi-package Python project used to test setting resolution and other complex
|
|
behaviors.
|
|
|
|
## Expected behavior
|
|
|
|
Running from the repo root should pick up and enforce the appropriate settings for each package:
|
|
|
|
```console
|
|
∴ cargo run -p ruff -- check crates/ruff_linter/resources/test/project/
|
|
crates/ruff_linter/resources/test/project/examples/.dotfiles/script.py:1:1: I001 [*] Import block is un-sorted or un-formatted
|
|
crates/ruff_linter/resources/test/project/examples/.dotfiles/script.py:1:8: F401 [*] `numpy` imported but unused
|
|
crates/ruff_linter/resources/test/project/examples/.dotfiles/script.py:2:17: F401 [*] `app.app_file` imported but unused
|
|
crates/ruff_linter/resources/test/project/examples/docs/docs/file.py:1:1: I001 [*] Import block is un-sorted or un-formatted
|
|
crates/ruff_linter/resources/test/project/examples/docs/docs/file.py:8:5: F841 [*] Local variable `x` is assigned to but never used
|
|
crates/ruff_linter/resources/test/project/project/file.py:1:8: F401 [*] `os` imported but unused
|
|
crates/ruff_linter/resources/test/project/project/import_file.py:1:1: I001 [*] Import block is un-sorted or un-formatted
|
|
Found 7 errors.
|
|
[*] 7 potentially fixable with the --fix option.
|
|
```
|
|
|
|
Running from the project directory itself should exhibit the same behavior:
|
|
|
|
```console
|
|
∴ (cd crates/ruff_linter/resources/test/project/ && cargo run -p ruff -- check .)
|
|
examples/.dotfiles/script.py:1:1: I001 [*] Import block is un-sorted or un-formatted
|
|
examples/.dotfiles/script.py:1:8: F401 [*] `numpy` imported but unused
|
|
examples/.dotfiles/script.py:2:17: F401 [*] `app.app_file` imported but unused
|
|
examples/docs/docs/file.py:1:1: I001 [*] Import block is un-sorted or un-formatted
|
|
examples/docs/docs/file.py:8:5: F841 [*] Local variable `x` is assigned to but never used
|
|
project/file.py:1:8: F401 [*] `os` imported but unused
|
|
project/import_file.py:1:1: I001 [*] Import block is un-sorted or un-formatted
|
|
Found 7 errors.
|
|
[*] 7 potentially fixable with the --fix option.
|
|
```
|
|
|
|
Running from the sub-package directory should exhibit the same behavior, but omit the top-level
|
|
files:
|
|
|
|
```console
|
|
∴ (cd crates/ruff_linter/resources/test/project/examples/docs && cargo run -p ruff -- check .)
|
|
docs/file.py:1:1: I001 [*] Import block is un-sorted or un-formatted
|
|
docs/file.py:8:5: F841 [*] Local variable `x` is assigned to but never used
|
|
Found 2 errors.
|
|
[*] 2 potentially fixable with the --fix option.
|
|
```
|
|
|
|
`--config` should force Ruff to use the specified `pyproject.toml` for all files, and resolve
|
|
file paths from the current working directory:
|
|
|
|
```console
|
|
∴ (cargo run -p ruff -- check --config=crates/ruff_linter/resources/test/project/pyproject.toml crates/ruff_linter/resources/test/project/)
|
|
crates/ruff_linter/resources/test/project/examples/.dotfiles/script.py:1:8: F401 [*] `numpy` imported but unused
|
|
crates/ruff_linter/resources/test/project/examples/.dotfiles/script.py:2:17: F401 [*] `app.app_file` imported but unused
|
|
crates/ruff_linter/resources/test/project/examples/docs/docs/concepts/file.py:1:8: F401 [*] `os` imported but unused
|
|
crates/ruff_linter/resources/test/project/examples/docs/docs/file.py:1:1: I001 [*] Import block is un-sorted or un-formatted
|
|
crates/ruff_linter/resources/test/project/examples/docs/docs/file.py:1:8: F401 [*] `os` imported but unused
|
|
crates/ruff_linter/resources/test/project/examples/docs/docs/file.py:3:8: F401 [*] `numpy` imported but unused
|
|
crates/ruff_linter/resources/test/project/examples/docs/docs/file.py:4:27: F401 [*] `docs.concepts.file` imported but unused
|
|
crates/ruff_linter/resources/test/project/examples/excluded/script.py:1:8: F401 [*] `os` imported but unused
|
|
crates/ruff_linter/resources/test/project/project/file.py:1:8: F401 [*] `os` imported but unused
|
|
Found 9 errors.
|
|
[*] 9 potentially fixable with the --fix option.
|
|
```
|
|
|
|
Running from a parent directory should "ignore" the `exclude` (hence, `concepts/file.py` gets
|
|
included in the output):
|
|
|
|
```console
|
|
∴ (cd crates/ruff_linter/resources/test/project/examples && cargo run -p ruff -- check --config=docs/ruff.toml .)
|
|
docs/docs/concepts/file.py:5:5: F841 [*] Local variable `x` is assigned to but never used
|
|
docs/docs/file.py:1:1: I001 [*] Import block is un-sorted or un-formatted
|
|
docs/docs/file.py:8:5: F841 [*] Local variable `x` is assigned to but never used
|
|
excluded/script.py:5:5: F841 [*] Local variable `x` is assigned to but never used
|
|
Found 4 errors.
|
|
[*] 4 potentially fixable with the --fix option.
|
|
```
|
|
|
|
Passing an excluded directory directly should report errors in the contained files:
|
|
|
|
```console
|
|
∴ cargo run -p ruff -- check crates/ruff_linter/resources/test/project/examples/excluded/
|
|
crates/ruff_linter/resources/test/project/examples/excluded/script.py:1:8: F401 [*] `os` imported but unused
|
|
Found 1 error.
|
|
[*] 1 potentially fixable with the --fix option.
|
|
```
|
|
|
|
Unless we `--force-exclude`:
|
|
|
|
```console
|
|
∴ cargo run -p ruff -- check crates/ruff_linter/resources/test/project/examples/excluded/ --force-exclude
|
|
warning: No Python files found under the given path(s)
|
|
∴ cargo run -p ruff -- check crates/ruff_linter/resources/test/project/examples/excluded/script.py --force-exclude
|
|
warning: No Python files found under the given path(s)
|
|
```
|