Skip to content

Expand the default rule set #23385

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
ntBre merged 8 commits into from
Feb 19, 2026
Merged

Expand the default rule set #23385

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
8 commits
Select commit Hold shift + click to select a range
78210c0
add PREVIEW_DEFAULT_RULES and a test
ntBre Feb 17, 2026
bd206cd
include proposed rules as individual selectors
ntBre Feb 17, 2026
339b8b5
clippy and update other tests
ntBre Feb 17, 2026
5608fba
update rule docs
ntBre Feb 18, 2026
0d2bf9b
remove rules from discussion
ntBre Feb 18, 2026
24e34ed
remove rules from discussion
ntBre Feb 18, 2026
5acf5d5
update snapshots
ntBre Feb 18, 2026
189c7e5
allow links to preview
ntBre Feb 18, 2026
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
10 changes: 8 additions & 2 deletions README.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -300,7 +300,7 @@ ruff check --config "lint.per-file-ignores = {'some_file.py' = ['F841']}"
```

To opt in to the latest lint rules, formatter style changes, interface updates, and more, enable
[preview mode](https://docs.astral.sh/ruff/rules/) by setting `preview = true` in your configuration
[preview mode](https://docs.astral.sh/ruff/preview/) by setting `preview = true` in your configuration
file or passing `--preview` on the command line. Preview mode enables a collection of unstable
features that may change prior to stabilization.

Expand All @@ -311,7 +311,7 @@ for more on the linting and formatting commands, respectively.

<!-- Begin section: Rules -->

**Ruff supports over 800 lint rules**, many of which are inspired by popular tools like Flake8,
**Ruff supports over 900 lint rules**, many of which are inspired by popular tools like Flake8,
isort, pyupgrade, and others. Regardless of the rule's origin, Ruff re-implements every rule in
Rust as a first-party feature.

Expand All @@ -322,6 +322,12 @@ stylistic rules that overlap with the use of a formatter, like `ruff format` or
If you're just getting started with Ruff, **the default rule set is a great place to start**: it
catches a wide variety of common errors (like unused imports) with zero configuration.

In [preview](https://docs.astral.sh/ruff/preview/), Ruff enables an expanded set of default rules
that includes rules from the `B`, `UP`, and `RUF` categories, as well as many more. If you give the
new defaults a try, feel free to leave feedback in the [GitHub
discussion](https://github.com/astral-sh/ruff/discussions/23203), where you can also find the new
rule set listed in full.

Comment on lines +325 to +330
Copy link
Contributor Author

@ntBre ntBre Feb 18, 2026

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I'm not totally sold on including this, especially in the README (but this is how the top of our Rules page is generated). I'd be happy just to put something like this in the release notes instead, but I'm curious what others think.

Copy link
Member

@amyreese amyreese Feb 18, 2026

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I like including this, but should probably also say something along the lines of "and this will be the default set in a future minor release"

Copy link
Contributor Author

@ntBre ntBre Feb 18, 2026

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

To me that's kind of implied by referencing preview, but I don't feel too strongly.

Copy link
Collaborator

@dylwil3 dylwil3 Feb 19, 2026

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I like it here, and I agree with you that "in a future minor" is implicit. (In fact - if people don't like them in preview, then they won't be stabilized in a future minor!)

<!-- End section: Rules -->

Beyond the defaults, Ruff re-implements some of the most popular Flake8 plugins and related code
Expand Down
Loading