ruff/crates/ruff_linter/src
Brent Westbrook 155fd603e8
Document when a rule was added (#21035)
Summary
--

Inspired by #20859, this PR adds the version a rule was added, and the
file and line where it was defined, to `ViolationMetadata`. The file and
line just use the standard `file!` and `line!` macros, while the more
interesting version field uses a new `violation_metadata` attribute
parsed by our `ViolationMetadata` derive macro.

I moved the commit modifying all of the rule files to the end, so it
should be a lot easier to review by omitting that one.

As a curiosity and a bit of a sanity check, I also plotted the rule
numbers over time:

<img width="640" height="480" alt="image"
src="https://github.com/user-attachments/assets/75b0b5cc-3521-4d40-a395-8807e6f4925f"
/>

I think this looks pretty reasonable and avoids some of the artifacts
the earlier versions of the script ran into, such as the `rule`
sub-command not being available or `--explain` requiring a file
argument.

<details><summary>Script and summary data</summary>

```shell
gawk --csv '
NR > 1 {
    split($2, a, ".")
    major = a[1]; minor = a[2]; micro = a[3]
    # sum the number of rules added per minor version
    versions[minor] += 1
}
END {
    tot = 0
    for (i = 0; i <= 14; i++) {
        tot += versions[i]
        print i, tot
    }
}
' ruff_rules_metadata.csv > summary.dat
```

```
0 696
1 768
2 778
3 803
4 822
5 848
6 855
7 865
8 893
9 915
10 916
11 924
12 929
13 932
14 933
```

</details>

Test Plan
--

I built and viewed the documentation locally, and it looks pretty good!

<img width="1466" height="676" alt="image"
src="https://github.com/user-attachments/assets/5e227df4-7294-4d12-bdaa-31cac4e9ad5c"
/>

The spacing seems a bit awkward following the `h1` at the top, so I'm
wondering if this might look nicer as a footer in Ruff. The links work
well too:
- [v0.0.271](https://github.com/astral-sh/ruff/releases/tag/v0.0.271)
- [Related
issues](https://github.com/astral-sh/ruff/issues?q=sort%3Aupdated-desc%20is%3Aissue%20is%3Aopen%20airflow-variable-name-task-id-mismatch)
- [View
source](https://github.com/astral-sh/ruff/blob/main/crates%2Fruff_linter%2Fsrc%2Frules%2Fairflow%2Frules%2Ftask_variable_name.rs#L34)

The last one even works on `main` now since it points to the
`derive(ViolationMetadata)` line.

In terms of binary size, this branch is a bit bigger than main with
38,654,520 bytes compared to 38,635,728 (+20 KB). I guess that's not
_too_ much of an increase, but I wanted to check since we're generating
a lot more code with macros.

---------

Co-authored-by: GiGaGon <107241144+MeGaGiGaGon@users.noreply.github.com>
2025-10-23 14:48:41 -04:00
..
checkers [syntax-errors] Name is parameter and global (#20426) 2025-10-21 16:51:16 +00:00
comments
cst Update Rust toolchain to 1.89 (#19807) 2025-08-07 18:21:50 +02:00
docstrings Update Rust toolchain to 1.89 (#19807) 2025-08-07 18:21:50 +02:00
fix Update Rust crate anyhow to v1.0.100 (#20499) 2025-09-22 09:51:52 +02:00
importer [isort] Fix inserting required imports before future imports (I002) (#20676) 2025-10-06 13:40:36 +00:00
linter
message Standardize syntax error construction (#20903) 2025-10-16 11:56:32 -04:00
registry
rules Document when a rule was added (#21035) 2025-10-23 14:48:41 -04:00
settings [ruff] Update schemars to v1 (#20942) 2025-10-20 08:59:52 +02:00
snapshots [syntax-errors] Name is parameter and global (#20426) 2025-10-21 16:51:16 +00:00
codes.rs Document when a rule was added (#21035) 2025-10-23 14:48:41 -04:00
directives.rs Track t-strings and f-strings for token-based rules and suppression comments (#20357) 2025-09-12 13:00:12 -05:00
doc_lines.rs Update Rust toolchain to 1.89 (#19807) 2025-08-07 18:21:50 +02:00
fs.rs Render unsupported syntax errors in formatter tests (#20777) 2025-10-13 10:00:37 -04:00
lib.rs
line_width.rs
linter.rs [syntax-errors] Name is parameter and global (#20426) 2025-10-21 16:51:16 +00:00
locator.rs Update Rust toolchain to 1.89 (#19807) 2025-08-07 18:21:50 +02:00
logging.rs Display diffs for ruff format --check and add support for different output formats (#20443) 2025-09-30 12:00:51 -04:00
noqa.rs Remove Diagnostic::expect_range and all consumers (#20322) 2025-09-10 17:19:20 -07:00
package.rs
packaging.rs
preview.rs [flake8-gettext] Resolve qualified names and built-in bindings (INT001, INT002, INT003) (#19045) 2025-10-20 18:24:55 -04:00
pyproject_toml.rs
registry.rs
renamer.rs Add a ScopeKind for the __class__ cell (#20048) 2025-08-26 09:49:08 -04:00
rule_redirects.rs Document when a rule was added (#21035) 2025-10-23 14:48:41 -04:00
rule_selector.rs Document when a rule was added (#21035) 2025-10-23 14:48:41 -04:00
source_kind.rs
test.rs Standardize syntax error construction (#20903) 2025-10-16 11:56:32 -04:00
text_helpers.rs
upstream_categories.rs
violation.rs Document when a rule was added (#21035) 2025-10-23 14:48:41 -04:00