ruff — changelog preview

v0.16.9

Sep 24, 2026

Release Notes

Released on 2026-09-24.

Preview features

\[ruff\] Avoid false positives for overloaded division (RUF069) (#28309)

Bug fixes

\[flake8-bugbear\] Avoid false positives for calls with keyword arguments (B009, B010, B043) (#28776)
\[flake8-tidy-imports\] Allow lazy imports to be used in deferred annotations (TID255) (#28767)

Rule changes

Update LibCST-based fixes for Python 3.15 (#28616)
\[flake8-pyi\] Mention stubs in the diagnostic message (PYI002) (#28542)

Documentation

Fix horizontal overflow on the rules documentation page (#28699)
Update rules table with category information (#28651)
\[flake8-annotations\] Clarify that ANN401 checks return types in addition to arguments (#28334)
\[flake8-bugbear\] Document type-checker interaction (B010) (#28509)
\[flake8-comprehensions\] Document map/generator exception behavior (C417) (#27794)
\[ruff\] Mention related isort settings (RUF022) (#28719)

Contributors

Install ruff 0.16.9

Install prebuilt binaries via shell script


curl --proto '=https' --tlsv1.2 -LsSf https://releases.astral.sh/github/ruff/releases/download/0.16.9/ruff-installer.sh | sh

Install prebuilt binaries via powershell script


powershell -ExecutionPolicy Bypass -c "irm https://releases.astral.sh/github/ruff/releases/download/0.16.9/ruff-installer.ps1 | iex"

Download ruff 0.16.9

Verifying GitHub Artifact Attestations

The artifacts in this release have attestations generated with GitHub Artifact Attestations. These can be verified by using the GitHub CLI:


gh attestation verify <file-path of downloaded artifact> --repo astral-sh/ruff

You can also download the attestation from GitHub and verify against that directly:


gh attestation verify <file-path of downloaded artifact> --bundle <file-path of downloaded attestation>

v0.16.8

Sep 16, 2026

Release Notes

Released on 2026-09-16.

Bug fixes

Visit functional TypedDict keyword arguments correctly (#28584)
\[flake8-simplify\] Detect nested async with under sync parent (SIM117) (#27821)
\[flake8-simplify\] Preserve operand order in SIM109 fix (#27824)
\[pyupgrade\] Preserve required parentheses in multiline UP040 fixes (#28164)
\[pyupgrade\] Skip TypeVarTuple and ParamSpec conversions with bounds or constraints (UP040, UP046, UP047) (#28505)

Rule changes

Add support for __lazy_modules__ (#28459)
Recognize PEP-728 TypedDict class keywords (#28533)
Recognize quoted types in typing.TypeForm (#28507)
Support conditional assignment to __lazy_modules__ (#28491)
\[flake8-type-checking\] Prefer lazy imports over TYPE_CHECKING on Python 3.15 and later (TC001, TC002, TC003) (#28541)
\[pyupgrade\] Make the fix for UP040 always unsafe (#28526)
\[pyupgrade\] Stop recommending deprecated ByteString aliases (UP035) (#28498)
\[ruff, flake8-use-pathlib\] Recognize the parent_mode argument (RUF064, PTH103) (#28528)
\[ruff\] Detect \Z in pytest.raises() match patterns (RUF043) (#28598)

CLI

Use rule name and code in formatter incompatibility warnings (#28571)

Configuration

\[flake8-tidy-imports\] Add extend-banned-api (#28644)

Contributors

Install ruff 0.16.8

Install prebuilt binaries via shell script


curl --proto '=https' --tlsv1.2 -LsSf https://releases.astral.sh/github/ruff/releases/download/0.16.8/ruff-installer.sh | sh

Install prebuilt binaries via powershell script


powershell -ExecutionPolicy Bypass -c "irm https://releases.astral.sh/github/ruff/releases/download/0.16.8/ruff-installer.ps1 | iex"

Download ruff 0.16.8

Verifying GitHub Artifact Attestations

The artifacts in this release have attestations generated with GitHub Artifact Attestations. These can be verified by using the GitHub CLI:


gh attestation verify <file-path of downloaded artifact> --repo astral-sh/ruff

You can also download the attestation from GitHub and verify against that directly:


gh attestation verify <file-path of downloaded artifact> --bundle <file-path of downloaded attestation>

v0.16.7

Sep 10, 2026

Release Notes

Released on 2026-09-10.

Preview features

\[ruff\] Add rule for default values on method receivers (RUF077) (#26700)
\[ruff\] Recognize re.prefixmatch (RUF039, RUF055) (#28311)

Bug fixes

Alternate nested quotes inside format spec interpolations (#28259)
\[flake8-implicit-str-concat\] Mark fix unsafe when it creates a docstring (ISC003) (#27981)
\[flake8-tidy-imports\] Skip fixes for multi-member imports (TID254) (#26584)
\[pylint\] Gate ImportCycleError on Python 3.15 (PLW0133) (#28310)

Rule changes

Correct D211 and D203 rule conflict diagnostic (#28444)
Recognize slice and frozendict generics (#28477)
Stop defining __cached__ for Python 3.15 (#28476)
\[pyupgrade\] Stop recommending removed typing.no_type_check_decorator (UP035) (#28475)

Performance

Reuse parser name lookups when interning (#28399)
Speed up inherited configuration resolution (#28299)

Documentation

Fix line-length path in --config example (#28392)
Remove the "Who’s Using Ruff?" list (#28455)

Other changes

Embed archive checksums in the shell installer (#28281)

Contributors

Install ruff 0.16.7

Install prebuilt binaries via shell script


curl --proto '=https' --tlsv1.2 -LsSf https://releases.astral.sh/github/ruff/releases/download/0.16.7/ruff-installer.sh | sh

Install prebuilt binaries via powershell script


powershell -ExecutionPolicy Bypass -c "irm https://releases.astral.sh/github/ruff/releases/download/0.16.7/ruff-installer.ps1 | iex"

Download ruff 0.16.7

Verifying GitHub Artifact Attestations

The artifacts in this release have attestations generated with GitHub Artifact Attestations. These can be verified by using the GitHub CLI:


gh attestation verify <file-path of downloaded artifact> --repo astral-sh/ruff

You can also download the attestation from GitHub and verify against that directly:


gh attestation verify <file-path of downloaded artifact> --bundle <file-path of downloaded attestation>

v0.16.6

Sep 3, 2026

Release Notes

Released on 2026-09-03.

Preview features

Move pytest-fixture-autouse to the restriction category (#28219)
\[flake8-pytest-style\] Add an autofix for PT020 (#27993)
\[flake8-tidy-imports\] Prevent fix loop between TID254 and TID255 (#28262)
\[isort\] Exclude pragma comments from line length calculation (I001) (#27313)

Bug fixes

Validate unary expressions when parsing (#28233)
\[flake8-async, pylint\] Recognize builtins.open (ASYNC230, PLW1514) (#28021)
\[flake8-bugbear\] Fix panic on match subjects (B031) (#27781)
\[flake8-datetimez\] Reject tzinfo=None for datetime bounds (DTZ901) (#28022)
\[flake8-pytest-style\] Avoid duplicate PT017 diagnostics (#27918)
\[ruff\] Remove lint.external hint for Ruff-specific suppressions (RUF102) (#27923)

Rule changes

\[flake8-use-pathlib\] Add display-only fix for os.listdir (PTH208) (#28027)

Documentation

Add another example and glob reference for lint.per-file-ignores (#28106)
Add duplicate work guidance (#28229)
\[flake8-async\] Document thread offloading (ASYNC240) (#28008)
\[pyupgrade\] Clarify default encoding argument handling (UP012) (#27315)

Other changes

Allow unary plus in match patterns on Python 3.15 (#28231)

Contributors

Install ruff 0.16.6

Install prebuilt binaries via shell script


curl --proto '=https' --tlsv1.2 -LsSf https://releases.astral.sh/github/ruff/releases/download/0.16.6/ruff-installer.sh | sh

Install prebuilt binaries via powershell script


powershell -ExecutionPolicy Bypass -c "irm https://releases.astral.sh/github/ruff/releases/download/0.16.6/ruff-installer.ps1 | iex"

Download ruff 0.16.6

Verifying GitHub Artifact Attestations

The artifacts in this release have attestations generated with GitHub Artifact Attestations. These can be verified by using the GitHub CLI:


gh attestation verify <file-path of downloaded artifact> --repo astral-sh/ruff

You can also download the attestation from GitHub and verify against that directly:


gh attestation verify <file-path of downloaded artifact> --bundle <file-path of downloaded attestation>

v0.16.5

Aug 27, 2026

Release Notes

Released on 2026-08-27.

Preview features

Allow rules without codes (#28049)
Introduce category selectors (#27666)
Update preview default rules and categories (#27877)

Bug fixes

\[flake8-async\] Detect blocking generic HTTP requests (ASYNC210) (#28024)
\[flake8-datetimez\] Allow timezone-safe strptime chains (DTZ007) (#28023)
\[flake8-simplify\] Respect side effects in lambda defaults (SIM401) (#28000)

Server

Fix duplicated "of" in ClientOptions doc comment (#27978)

Documentation

Document rule acceptance guidelines (#27910)
Document the new category selectors (#27906)

Contributors

Install ruff 0.16.5

Install prebuilt binaries via shell script


curl --proto '=https' --tlsv1.2 -LsSf https://releases.astral.sh/github/ruff/releases/download/0.16.5/ruff-installer.sh | sh

Install prebuilt binaries via powershell script


powershell -ExecutionPolicy Bypass -c "irm https://releases.astral.sh/github/ruff/releases/download/0.16.5/ruff-installer.ps1 | iex"

Download ruff 0.16.5

Verifying GitHub Artifact Attestations

The artifacts in this release have attestations generated with GitHub Artifact Attestations. These can be verified by using the GitHub CLI:


gh attestation verify <file-path of downloaded artifact> --repo astral-sh/ruff

You can also download the attestation from GitHub and verify against that directly:


gh attestation verify <file-path of downloaded artifact> --bundle <file-path of downloaded attestation>

v0.16.4

Aug 20, 2026

Release Notes

Released on 2026-08-20.

Preview features

\[flake8-use-pathlib\] Add autofix for PTH116 (#26460)
\[refurb\] Restrict delete-full-slice to lists (FURB131) (#27711)
\[refurb\] Skip FURB101 and FURB103 when the open argument is a file descriptor (#27643)

Bug fixes

Fix InvalidInstruction on Windows CPUs that do not support POPCNT (#27803)
\[pyflakes\] Emit semantic syntax errors in string type definitions as F722 (#27835)
\[pylint\] Allow os._exit imports in import-private-name (PLC2701) (#27738)

Rule changes

[syntax-errors] Align mixed t-string/bytes error message with CPython 3.14 (#27766)
\[ruff\] Add ctypes.LittleEndianStructure and related types to existing exception (RUF012) (#27753)
[syntax-errors] Detect duplicate keyword arguments (#17804)
[syntax-errors] Detect parameters declared nonlocal (#27628)

Server

Offer display-only fixes and mark safe fixes preferred (#27807)
Support pull diagnostics for notebook cells (#27779)

Documentation

Add default indicator to rules table (#27724)
Fix broken link to Python docs (#27757)

Other changes

Fix s390x stacker assembly in release builds (#27776)
Guarantee minimum stack size when parsing a module, standalone expression, and suites (#25464)
Reduce configuration deserialization code size (#27924)
Check packed AST index bounds (#27849)

Contributors

Install ruff 0.16.4

Install prebuilt binaries via shell script


curl --proto '=https' --tlsv1.2 -LsSf https://releases.astral.sh/github/ruff/releases/download/0.16.4/ruff-installer.sh | sh

Install prebuilt binaries via powershell script


powershell -ExecutionPolicy Bypass -c "irm https://releases.astral.sh/github/ruff/releases/download/0.16.4/ruff-installer.ps1 | iex"

Download ruff 0.16.4

Verifying GitHub Artifact Attestations

The artifacts in this release have attestations generated with GitHub Artifact Attestations. These can be verified by using the GitHub CLI:


gh attestation verify <file-path of downloaded artifact> --repo astral-sh/ruff

You can also download the attestation from GitHub and verify against that directly:


gh attestation verify <file-path of downloaded artifact> --bundle <file-path of downloaded attestation>

v0.16.3

Aug 13, 2026

Release Notes

Released on 2026-08-13.

Preview features

\[pylint\] Fix false negatives on negative numbers (PLR6104) (#27251)
\[pyupgrade\] Add rule to replace while 1 with while True (UP048) (#27190)

Bug fixes

\[flake8-bandit\] Also check keyword arguments (S602, S603, S607, S609) (#27687)
\[pylint\] Allow continue in finally on Python 3.8 (#27626)
\[pylint\] Fix PLE1307 false positive with bools (#27651)
\[pylint\] Fix false positives and negatives with %b format character (PLE1300, PLE1307) (#27560)
\[pylint\] Improve handling of concatenated strings (PLE1300) (#27659)

Rule changes

\[numpy\] Make np.chararray autofix backwards-compatible (NPY201) (#27527)

Performance

Enable PGO for Linux x86-64 Ruff releases (#27570)
Enable PGO for Linux ARM64 Ruff releases (#27574)
Enable PGO for Windows x86-64 Ruff releases (#27573)
Enable PGO for macOS ARM64 Ruff releases (#27572)
Reduce Expr size to 64 bytes (#27591)

CLI

Hyperlink rule codes in ruff check --statistics output (#27646)

Documentation

\[ruff\] Also suggest asyncio.TaskGroup (RUF006) (#27461)

Other changes

Use mimalloc v3 (#27586)

Contributors

Install ruff 0.16.3

Install prebuilt binaries via shell script


curl --proto '=https' --tlsv1.2 -LsSf https://releases.astral.sh/github/ruff/releases/download/0.16.3/ruff-installer.sh | sh

Install prebuilt binaries via powershell script


powershell -ExecutionPolicy Bypass -c "irm https://releases.astral.sh/github/ruff/releases/download/0.16.3/ruff-installer.ps1 | iex"

Download ruff 0.16.3

Verifying GitHub Artifact Attestations

The artifacts in this release have attestations generated with GitHub Artifact Attestations. These can be verified by using the GitHub CLI:


gh attestation verify <file-path of downloaded artifact> --repo astral-sh/ruff

You can also download the attestation from GitHub and verify against that directly:


gh attestation verify <file-path of downloaded artifact> --bundle <file-path of downloaded attestation>

v0.16.2

Aug 7, 2026

Release Notes

Released on 2026-08-06.

Bug fixes

\[flake8-pyi\] Avoid false positives on singledispatch functions (PYI041) (#27335)

Server

Register formatting capabilities dynamically to exclude TOML files (#27332)

Contributors

Install ruff 0.16.2

Install prebuilt binaries via shell script


curl --proto '=https' --tlsv1.2 -LsSf https://releases.astral.sh/github/ruff/releases/download/0.16.2/ruff-installer.sh | sh

Install prebuilt binaries via powershell script


powershell -ExecutionPolicy Bypass -c "irm https://releases.astral.sh/github/ruff/releases/download/0.16.2/ruff-installer.ps1 | iex"

Download ruff 0.16.2

Verifying GitHub Artifact Attestations

The artifacts in this release have attestations generated with GitHub Artifact Attestations. These can be verified by using the GitHub CLI:


gh attestation verify <file-path of downloaded artifact> --repo astral-sh/ruff

You can also download the attestation from GitHub and verify against that directly:


gh attestation verify <file-path of downloaded artifact> --bundle <file-path of downloaded attestation>

v0.16.1

Jul 30, 2026

Release Notes

Released on 2026-07-30.

Preview features

Add an option to opt out of human-readable names (#27160)
\[flake8-pytest-style\] Make fixes safe by default and unsafe only when comments are present (PT018) (#27201)
\[pyupgrade\] Skip fix when a defaulted TypeVar precedes a non-defaulted one (UP040, UP046, UP047) (#27133)
\[ruff\] Fix false positive with unpacked arguments (RUF065) (#26959)

Bug fixes

Bump gen-lsp-types to gracefully handle unknown enumeration values in LSP messages (#27230)
\[flake8-bugbear\] Mark range as immutable (B008) (#27247)
\[flake8-comprehensions\] NFKC-normalize keyword names in C408 fix (#26813)
\[flake8-return\] Fix false positive when variable is read in finally clause (RET504) (#25441)
\[pydocstyle\] Skip section detection inside RST directive bodies (D214, D405, D413) (#23635)
\[refurb\] Parenthesize yield arguments in the FURB192 fix (#27192)

Rule changes

\[flake8-pytest-style\] Mark PT022 fixes as unsafe (#26440)
\[refurb\] Mark fixes that remove unknown separators as unsafe (FURB105) (#27200)

Server

Fix indexing of excluded nested Ruff workspaces (#27303)
Lint TOML files in the LSP (#26862)

Documentation

Cover pycon Markdown formatting (#27153)
\[flake8-bandit\] Document TYPE_CHECKING exception (S101) (#27004)
\[flake8-import-conventions\] Document that extend-aliases can override default aliases (#27191)
\[pylint\] Add missing fix safety gotchas for non-augmented-assignment (PLR6104) (#27250)

Other changes

Reduce syntax error noise by swallowing dedents like indents (#27170)
Vendor latest annotate-snippets (#27033)

Contributors

Install ruff 0.16.1

Install prebuilt binaries via shell script


curl --proto '=https' --tlsv1.2 -LsSf https://releases.astral.sh/github/ruff/releases/download/0.16.1/ruff-installer.sh | sh

Install prebuilt binaries via powershell script


powershell -ExecutionPolicy Bypass -c "irm https://releases.astral.sh/github/ruff/releases/download/0.16.1/ruff-installer.ps1 | iex"

Download ruff 0.16.1

Verifying GitHub Artifact Attestations

The artifacts in this release have attestations generated with GitHub Artifact Attestations. These can be verified by using the GitHub CLI:


gh attestation verify <file-path of downloaded artifact> --repo astral-sh/ruff

You can also download the attestation from GitHub and verify against that directly:


gh attestation verify <file-path of downloaded artifact> --bundle <file-path of downloaded attestation>

v0.16.0

Jul 23, 2026

Release Notes

Released on 2026-07-23.

Check out the blog post for a migration guide and overview of the changes!

Breaking changes

Ruff now enables a much larger set of rules by default (413, up from 59). See the blog post for more details and the new Default Rules page for a full listing of the enabled rules. Note that this is primarily an expansion, but 18 of the more opinionated pycodestyle (E) and pyflakes (F) rules have been removed from the default set: E401, E402, E701, E702, E703, E711, E712, E713, E714, E721, E731, E741, E742, E743, F403, F405, F406, and F722.

Ruff can now format Python code blocks in Markdown files and will do this by default. See the documentation for more details.

Ruff now supports ruff: ignore comments at the ends of lines, like noqa comments, or on the line preceding a diagnostic. For example, these both suppress an unused-import (F401) diagnostic:


    import math  # ruff: ignore[F401]

    # ruff: ignore[F401]
    import os

Fixes are now shown in check and format --check output:


    ❯ ruff format --check .
    unformatted: File would be reformatted
     --> try.md:1:1
      |
    1 | ```python
      - import   math
    2 + import math
    3 | ```
      |

    1 file would be reformatted

This example also shows off the Markdown formatting.

format --check now supports the same output formats as the linter, including the github and gitlab outputs for rendering annotations in CI:


    ❯ ruff format --check --output-format github .
    ::error title=ruff (unformatted),file=try.md,line=2,col=8,endLine=2,endColumn=10::try.md:2:8: unformatted: File would be reformatted

See the CLI help or documentation for the full list of supported formats.

The filename, location, end_location, fix.edits[].location, and fix.edits[].end_location fields in the JSON output format may now be null rather than defaulting to the empty string and row 1, column 1, respectively.

Stabilization

The following rules have been stabilized and are no longer in preview:

airflow3-incompatible-function-signature (AIR303)
missing-copyright-notice (CPY001)
unnecessary-from-float (FURB164)
sorted-min-max (FURB192)
implicit-string-concatenation-in-collection-literal (ISC004)
log-exception-outside-except-handler (LOG004)
invalid-bool-return-type (PLE0304)
too-many-positional-arguments (PLR0917)
stop-iteration-return (PLR1708)
none-not-at-end-of-union (RUF036)
access-annotations-from-class-dict (RUF063)
duplicate-entry-in-dunder-all (RUF068)

The following behaviors have been stabilized:

blind-except (BLE001) is now suppressed when the exception is logged via logging methods other than critical, error and exception.
future-required-type-annotation (FA102) now checks for additional PEP 585-compatible APIs, such as those from collections.abc.
f-string-in-get-text-func-call (INT001), format-in-get-text-func-call (INT002), and printf-in-get-text-func-call (INT003) now check for additional common ways of using the gettext module, such as assigning it to builtins._.
suspicious-url-open-usage (S310) now resolves local string literal bindings to avoid more false positives.
snmp-insecure-version (S508) and snmp-weak-cryptography (S509) now support the recommended API from newer versions of PySNMP.
typing-text-str-alias (UP019) now recognizes typing_extensions.Text in addition to typing.Text.

Preview features

\[pyupgrade\] Fix false positive with TypeVar default before Python 3.13 (UP040) (#26888)

Bug fixes

\[ruff\] Fix missing check on unrecognized early bound (RUF016) (#26986)

Rule changes

Insert a space after the colon in Ruff suppression comments (#27123)

Performance

\[pyupgrade\] Speed up unnecessary-future-import (UP010) (#27047)

Documentation

\[ruff\] Add missing period in "Why is this bad?" section (RUF200) (#26930)
\[flake8-simplify\] Clarify os.environ behavior on Windows (SIM112) (#26972)
\[pydocstyle\] Document fix safety (D400) (#26971)

Contributors

Install ruff 0.16.0

Install prebuilt binaries via shell script


curl --proto '=https' --tlsv1.2 -LsSf https://releases.astral.sh/github/ruff/releases/download/0.16.0/ruff-installer.sh | sh

Install prebuilt binaries via powershell script


powershell -ExecutionPolicy Bypass -c "irm https://releases.astral.sh/github/ruff/releases/download/0.16.0/ruff-installer.ps1 | iex"

Download ruff 0.16.0

Verifying GitHub Artifact Attestations

The artifacts in this release have attestations generated with GitHub Artifact Attestations. These can be verified by using the GitHub CLI:


gh attestation verify <file-path of downloaded artifact> --repo astral-sh/ruff

You can also download the attestation from GitHub and verify against that directly:


gh attestation verify <file-path of downloaded artifact> --bundle <file-path of downloaded attestation>

v0.15.22

Jul 16, 2026

Release Notes

Released on 2026-07-16.

Preview features

\[pycodestyle\] Add an autofix for E402 (#22212)
\[refurb\] Allow subclassing builtins in stub files (FURB189) (#26812)
\[ruff\] Add rule to replace noqa comments with ruff:ignore (RUF105) (#26423)
\[ruff\] Add rule to use human-readable names in ruff:ignore comments (RUF106) (#26682)
\[ruff\] Add rule to use human-readable names in configuration selectors (RUF201) (#26772)

Bug fixes

\[flake8-pyi\] Fix false positive in __all__ (PYI053) (#26872)

Rule changes

\[pylint\] Ignore mutable type updates in redefined-loop-name (PLW2901) (#25733)

Performance

Avoid redundant lexer token bookkeeping (#26765)
Avoid redundant pending-indentation writes (#26774)
Avoid unnecessary identifier lookahead (#26525)
Reuse parser scratch buffers (#26798)

Documentation

Document argfile support (#26803)
\[flake8-datetimez\] Clarify naming guidance for datetime.today (DTZ002) (#26658)
\[pycodestyle\] Document E731 fix safety (#26847)
\[ruff\] Clarify intentional async contexts for unused-async (RUF029) (#26641)

Contributors

Install ruff 0.15.22

Install prebuilt binaries via shell script


curl --proto '=https' --tlsv1.2 -LsSf https://releases.astral.sh/github/ruff/releases/download/0.15.22/ruff-installer.sh | sh

Install prebuilt binaries via powershell script


powershell -ExecutionPolicy Bypass -c "irm https://releases.astral.sh/github/ruff/releases/download/0.15.22/ruff-installer.ps1 | iex"

Download ruff 0.15.22

Verifying GitHub Artifact Attestations

The artifacts in this release have attestations generated with GitHub Artifact Attestations. These can be verified by using the GitHub CLI:


gh attestation verify <file-path of downloaded artifact> --repo astral-sh/ruff

You can also download the attestation from GitHub and verify against that directly:


gh attestation verify <file-path of downloaded artifact> --bundle <file-path of downloaded attestation>

v0.15.21

Jul 9, 2026

Release Notes

Released on 2026-07-09.

Preview features

Add --add-ignore for adding ruff:ignore comments (#26346)
\[flake8-comprehensions\] Drop C409 tuple comprehension preview behavior (#25707)
Avoid whitespace normalization when formatting comments (#26455)
\[pyupgrade\] Lint and fix use of deprecated abc decorators (UP051) (#26417)

Bug fixes

Refine non-empty f-string detection (#26526)
Detect syntax errors in individual notebook cells (#26419)
\[flake8-implicit-str-concat\] Fix ISC003 autofix incorrectly stripping + from comments (#26554)

Rule changes

\[flake8-executable\] Mark EXE004 fix as unsafe (#26033)
\[flake8-pyi\] Mark PYI061 fixes as unsafe in Python files (#26533)
\[pydocstyle\] Skip overload-with-docstring in stub files (D418) (#26318)

Performance

Avoid per-token source index visitor calls (#26506)
Cache parenthesized expression boundaries in the formatter (#26344)
Improve performance of rendering edits in preview mode (#26565)
Inline fits_element in formatter (#26429)
Inline formatter printing hot paths (#26504)
Lazily create builtin bindings (#26510)
Skip empty trivia scans in the source indexer (#26507)
Use ICF for macOS release builds (#25780)

Formatter

Add --extend-exclude to ruff format (#26372)

Documentation

Add "How does Ruff's import sorting compare to isort?" link to README (#26530)
Fix Mozilla Firefox repository link in README (#26537)
\[flake8-bandit\] Fix misleading docstring for mako-templates (S702) (#26432)
\[ruff\] Fix non-triggering example for if-key-in-dict-del (RUF051) (#26433)

Contributors

Install ruff 0.15.21

Install prebuilt binaries via shell script


curl --proto '=https' --tlsv1.2 -LsSf https://releases.astral.sh/github/ruff/releases/download/0.15.21/ruff-installer.sh | sh

Install prebuilt binaries via powershell script


powershell -ExecutionPolicy Bypass -c "irm https://releases.astral.sh/github/ruff/releases/download/0.15.21/ruff-installer.ps1 | iex"

Download ruff 0.15.21

Verifying GitHub Artifact Attestations

The artifacts in this release have attestations generated with GitHub Artifact Attestations. These can be verified by using the GitHub CLI:


gh attestation verify <file-path of downloaded artifact> --repo astral-sh/ruff

You can also download the attestation from GitHub and verify against that directly:


gh attestation verify <file-path of downloaded artifact> --bundle <file-path of downloaded attestation>

v0.15.20

Jun 25, 2026

Release Notes

Released on 2026-06-25.

Preview features

Allow human-readable names in rule selectors (#25887)
Emit a warning instead of an error for unknown rule selectors (#26113)
Match noqa shebang handling in ruff:ignore comments (#26286)
\[ruff\] Remove pytest-fixture-autouse (RUF076) (#26240, #26371)

Documentation

Add versioning sections to custom crate READMEs (#26317)
Update ruff_python_parser README for crates.io (#26315)
\[perflint\] Clarify that PERF402 applies to any iterable (#26242)

Contributors

Install ruff 0.15.20

Install prebuilt binaries via shell script


curl --proto '=https' --tlsv1.2 -LsSf https://releases.astral.sh/github/ruff/releases/download/0.15.20/ruff-installer.sh | sh

Install prebuilt binaries via powershell script


powershell -ExecutionPolicy Bypass -c "irm https://releases.astral.sh/github/ruff/releases/download/0.15.20/ruff-installer.ps1 | iex"

Download ruff 0.15.20

Verifying GitHub Artifact Attestations

The artifacts in this release have attestations generated with GitHub Artifact Attestations. These can be verified by using the GitHub CLI:


gh attestation verify <file-path of downloaded artifact> --repo astral-sh/ruff

You can also download the attestation from GitHub and verify against that directly:


gh attestation verify <file-path of downloaded artifact> --bundle <file-path of downloaded attestation>

v0.15.19

Jun 24, 2026

Release Notes

Released on 2026-06-23.

Preview features

Support human-readable names when hovering suppression comments and in code actions (#26114)

Bug fixes

Fall back to default settings when editor-only settings are invalid (#26244)
Fix panic when inserting text at a notebook cell boundary (#26111)

Rule changes

\[pylint\] Update fix suggestions for __floor__, __trunc__, __length_hint__, and __matmul__ variants (PLC2801) (#26239)

Performance

Avoid allocating when parsing single string literals (#26200)
Avoid reallocating singleton call arguments (#26223)
Lazily create source files for lint diagnostics (#26226)
Optimize formatter text width and indentation (#26236)
Reserve capacity for builtin bindings (#26229)
Skip repeated-key checks for singleton dictionaries (#26228)
Use ArrayVec for qualified name segments (#26224)

Documentation

\[flake8-pyi\] Note that PYI051 is an opinionated stylistic rule (#26179)
\[pyupgrade\] Clarify UP029 as a Python 2 compatibility rule (#26243)

Other changes

Publish Ruff crates to crates.io (#26271)

Contributors

Install ruff 0.15.19

Install prebuilt binaries via shell script


curl --proto '=https' --tlsv1.2 -LsSf https://releases.astral.sh/github/ruff/releases/download/0.15.19/ruff-installer.sh | sh

Install prebuilt binaries via powershell script


powershell -ExecutionPolicy Bypass -c "irm https://releases.astral.sh/github/ruff/releases/download/0.15.19/ruff-installer.ps1 | iex"

Download ruff 0.15.19

Verifying GitHub Artifact Attestations

The artifacts in this release have attestations generated with GitHub Artifact Attestations. These can be verified by using the GitHub CLI:


gh attestation verify <file-path of downloaded artifact> --repo astral-sh/ruff

You can also download the attestation from GitHub and verify against that directly:


gh attestation verify <file-path of downloaded artifact> --bundle <file-path of downloaded attestation>

v0.15.18

Jun 18, 2026

Release Notes

Released on 2026-06-18.

Preview features

Handle nested ruff:ignore comments (#25791)
Stop displaying severity in output (#26050)
Use human-readable names in CLI output (#25937)
Use human-readable names in LSP and playground diagnostics (#26058)
\[pydocstyle\] Prevent property docstrings starting with verbs (D421) (#23775)
\[flake8-pyi\] Extend PYI033 to Python files (#26129)

Bug fixes

Detect equivalent numeric mapping keys (#26009)
Detect mapping keys equivalent to booleans (#25982)
Detect repeated signed and complex dictionary keys (#26007)

Rule changes

\[flake8-pyi\] Rename PYI033 to legacy-type-comment (#26131)

Performance

Use ThinVec for call keywords (#25999)
Inline parser recovery context checks (#26038)
Match parser keywords as bytes (#26037)
Move value parsing out of lexing (#25360)

Server

Render subdiagnostics and secondary annotations as related information (#26011)

Documentation

Update fix availability for always-fixable rules (#26091)
\[flake8-tidy-imports\] Add fix safety section (TID252) (#17491)

Parser

Reject __debug__ lambda parameters (#26022)
Reject _ as a match-pattern target (#25977)
Reject multiple starred names in sequence patterns (#25976)
Reject parenthesized star imports (#26021)
Reject starred comprehension targets (#26023)
Reject unparenthesized generator expressions in class bases (#25978)
Reject yield expressions after commas (#26024)
Validate function type parameter default order (#25981)

Playground

Make diagnostic links clickable (#26104)
Use diagnostic tags (#26105)

Contributors

Install ruff 0.15.18

Install prebuilt binaries via shell script


curl --proto '=https' --tlsv1.2 -LsSf https://releases.astral.sh/github/ruff/releases/download/0.15.18/ruff-installer.sh | sh

Install prebuilt binaries via powershell script


powershell -ExecutionPolicy Bypass -c "irm https://releases.astral.sh/github/ruff/releases/download/0.15.18/ruff-installer.ps1 | iex"

Download ruff 0.15.18

Verifying GitHub Artifact Attestations

The artifacts in this release have attestations generated with GitHub Artifact Attestations. These can be verified by using the GitHub CLI:


gh attestation verify <file-path of downloaded artifact> --repo astral-sh/ruff

You can also download the attestation from GitHub and verify against that directly:


gh attestation verify <file-path of downloaded artifact> --bundle <file-path of downloaded attestation>