Release Notes

Released on 2025-09-25.

Preview features

• [flake8-async] Implement blocking-path-method (ASYNC240) (#20264)
• [flake8-bugbear] Implement map-without-explicit-strict (B912) (#20429)
• [flake8-bultins] Detect class-scope builtin shadowing in decorators, default args, and attribute initializers (A003) (#20178)
• [ruff] Implement logging-eager-conversion (RUF065) (#19942)
• Include .pyw files by default when linting and formatting (#20458)

Bug fixes

• Deduplicate input paths (#20105)
• [flake8-comprehensions] Preserve trailing commas for single-element lists (C409) (#19571)
• [flake8-pyi] Avoid syntax error from conflict with PIE790 (PYI021) (#20010)
• [flake8-simplify] Correct fix for positive maxsplit without separator (SIM905) (#20056)
• [pyupgrade] Fix UP008 not to apply when __class__ is a local variable (#20497)
• [ruff] Fix B004 to skip invalid hasattr/getattr calls (#20486)
• [ruff] Replace -nan with nan when using the value to construct a Decimal (FURB164 ) (#20391)

Documentation

• Add 'Finding ways to help' to CONTRIBUTING.md (#20567)
• Update import path to ruff-wasm-web (#20539)
• [flake8-bandit] Clarify the supported hashing functions (S324) (#20534)

Other changes

• [playground] Allow hover quick fixes to appear for overlapping diagnostics (#20527)
• [playground] Fix non‑BMP code point handling in quick fixes and markers (#20526)

Contributors

• @BurntSushi
• @mtshiba
• @second-ed
• @danparizher
• @ShikChen
• @PieterCK
• @GDYendell
• @RazerM
• @TaKO8Ki
• @amyreese
• @ntbre
• @MichaReiser

Install ruff 0.13.2

Install prebuilt binaries via shell script

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

Install prebuilt binaries via powershell script

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

Download ruff 0.13.2

Release Notes

Released on 2025-09-18.

Preview features

• [flake8-simplify] Detect unnecessary None default for additional key expression types (SIM910) (#20343)
• [flake8-use-pathlib] Add fix for PTH123 (#20169)
• [flake8-use-pathlib] Fix PTH101, PTH104, PTH105, PTH121 fixes (#20143)
• [flake8-use-pathlib] Make PTH111 fix unsafe because it can change behavior (#20215)
• [pycodestyle] Fix E301 to only trigger for functions immediately within a class (#19768)
• [refurb] Mark single-item-membership-test fix as always unsafe (FURB171) (#20279)

Bug fixes

• Handle t-strings for token-based rules and suppression comments (#20357)
• [flake8-bandit] Fix truthiness: dict-only ** displays not truthy for shell (S602, S604, S609) (#20177)
• [flake8-simplify] Fix diagnostic to show correct method name for str.rsplit calls (SIM905) (#20459)
• [flynt] Use triple quotes for joined raw strings with newlines (FLY002) (#20197)
• [pyupgrade] Fix false positive when class name is shadowed by local variable (UP008) (#20427)
• [pyupgrade] Prevent infinite loop with I002 and UP026 (#20327)
• [ruff] Recognize t-strings, generators, and lambdas in invalid-index-type (RUF016) (#20213)

Rule changes

• [RUF102] Respect rule redirects in invalid rule code detection (#20245)
• [flake8-bugbear] Mark the fix for unreliable-callable-check as always unsafe (B004) (#20318)
• [ruff] Allow dataclass attribute value instantiation from nested frozen dataclass (RUF009) (#20352)

CLI

• Add fixes to output-format=sarif (#20300)
• Treat panics as fatal diagnostics, sort panics last (#20258)

Documentation

• [ruff] Add analyze.string-imports-min-dots to settings (#20375)
• Update README.md with Albumentations new repository URL (#20415)

Other changes

• Bump MSRV to Rust 1.88 (#20470)
• Enable inline noqa for multiline strings in playground (#20442)

Contributors

• @chirizxc
• @danparizher
• @IDrokin117
• @amyreese
• @AlexWaygood
• @dylwil3
• @njhearp
• @woodruffw
• @dcreager
• @TaKO8Ki
• @BurntSushi
• @salahelfarissi
• @MichaReiser

Install ruff 0.13.1

Install prebuilt binaries via shell script

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

Install prebuilt binaries via powershell script

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

Download ruff 0.13.1

Release Notes

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

Breaking changes

• Several rules can now add from __future__ import annotations automatically

  TC001, TC002, TC003, RUF013, and UP037 now add from __future__ import annotations as part of their fixes when the lint.future-annotations setting is enabled. This allows the rules to move more imports into TYPE_CHECKING blocks (TC001, TC002, and TC003), use PEP 604 union syntax on Python versions before 3.10 (RUF013), and unquote more annotations (UP037).

• Full module paths are now used to verify first-party modules

  Ruff now checks that the full path to a module exists on disk before categorizing it as a first-party import. This change makes first-party import detection more accurate, helping to avoid false positives on local directories with the same name as a third-party dependency, for example. See the FAQ section on import categorization for more details.

• Deprecated rules must now be selected by exact rule code

  Ruff will no longer activate deprecated rules selected by their group name or prefix. As noted below, the two remaining deprecated rules were also removed in this release, so this won't affect any current rules, but it will still affect any deprecations in the future.

• The deprecated macOS configuration directory fallback has been removed

  Ruff will no longer look for a user-level configuration file at ~/Library/Application Support/ruff/ruff.toml on macOS. This feature was deprecated in v0.5 in favor of using the XDG specification (usually resolving to ~/.config/ruff/ruff.toml), like on Linux. The fallback and accompanying deprecation warning have now been removed.

Removed Rules

The following rules have been removed:

• pandas-df-variable-name (PD901)
• non-pep604-isinstance (UP038)

Stabilization

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

• airflow-dag-no-schedule-argument (AIR002)
• airflow3-removal (AIR301)
• airflow3-moved-to-provider (AIR302)
• airflow3-suggested-update (AIR311)
• airflow3-suggested-to-move-to-provider (AIR312)
• long-sleep-not-forever (ASYNC116)
• f-string-number-format (FURB116)
• os-symlink (PTH211)
• generic-not-last-base-class (PYI059)
• redundant-none-literal (PYI061)
• pytest-raises-ambiguous-pattern (RUF043)
• unused-unpacked-variable (RUF059)
• useless-class-metaclass-type (UP050)

The following behaviors have been stabilized:

• assert-raises-exception (B017) now checks for direct calls to unittest.TestCase.assert_raises and pytest.raises instead of only the context manager forms.
• missing-trailing-comma (COM812) and prohibited-trailing-comma (COM819) now check for trailing commas in PEP 695 type parameter lists.
• raw-string-in-exception (EM101) now also checks for byte strings in exception messages.
• invalid-mock-access (PGH005) now checks for AsyncMock methods like not_awaited in addition to the synchronous variants.
• useless-import-alias (PLC0414) no longer applies to __init__.py files, where it conflicted with one of the suggested fixes for unused-import (F401).
• bidirectional-unicode (PLE2502) now also checks for U+061C (Arabic Letter Mark).
• The fix for multiple-with-statements (SIM117) is now marked as always safe.

Preview features

• [pyupgrade] Enable UP043 in stub files (#20027)

Bug fixes

• [pyupgrade] Apply UP008 only when the __class__ cell exists (#19424)
• [ruff] Fix empty f-string detection in in-empty-collection (RUF060) (#20249)

Server

• Add support for using uv as an alternative formatter backend (#19665)

Documentation

• [pep8-naming] Fix formatting of __all__ (N816) (#20301)

Contributors

• @AlexWaygood
• @BurntSushi
• @CodeMan62
• @IDrokin117
• @JelleZijlstra
• @LoicRiegel
• @Renkai
• @Renkai
• @TaKO8Ki
• @amyreese
• @carljm
• @dcreager
• @ericmarkmartin
• @ferdnyc
• @ibraheemdev
• @mtshiba
• @ntBre
• @onerandomusername
• @renovate
• @sharkdp
• @thejchap
• @zanieb

Install ruff 0.13.0

Install prebuilt binaries via shell script

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

Install prebuilt binaries via powershell script

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

Download ruff 0.13.0

Release Notes

Preview features

• Show fixes by default (#19919)
• [airflow] Convert DatasetOrTimeSchedule(datasets=...) to AssetOrTimeSchedule(assets=...) (AIR311) (#20202)
• [airflow] Improve the AIR002 error message (#20173)
• [airflow] Move airflow.operators.postgres_operator.Mapping from AIR302 to AIR301 (#20172)
• [flake8-async] Implement blocking-input rule (ASYNC250) (#20122)
• [flake8-use-pathlib] Make PTH119 and PTH120 fixes unsafe because they can change behavior (#20118)
• [pylint] Add U+061C to PLE2502 (#20106)
• [ruff] Fix false negative for empty f-strings in deque calls (RUF037) (#20109)

Bug fixes

• Less confidently mark f-strings as empty when inferring truthiness (#20152)
• [fastapi] Fix false positive for paths with spaces around parameters (FAST003) (#20077)
• [flake8-comprehensions] Skip C417 when lambda contains yield/yield from (#20201)
• [perflint] Handle tuples in dictionary comprehensions (PERF403) (#19934)

Rule changes

• [pycodestyle] Preserve return type annotation for ParamSpec (E731) (#20108)

Documentation

• Add fix safety sections to docs (#17490,#17499)

Contributors

• @11happy
• @AlexWaygood
• @BurntSushi
• @Gankra
• @JelleZijlstra
• @Kalmaegi
• @Lee-W
• @MatthewMckee4
• @PrettyWood
• @Renkai
• @ShaharNaveh
• @amyreese
• @carljm
• @charliermarsh
• @chirizxc
• @danparizher
• @dcreager
• @dhruvmanila
• @dylwil3
• @github-actions
• @kotx
• @liortct
• @ntBre
• @renovate
• @s-rigaud
• @sharkdp

Install ruff 0.12.12

Install prebuilt binaries via shell script

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

Install prebuilt binaries via powershell script

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

Download ruff 0.12.12

Release Notes

Preview features

• [airflow] Extend AIR311 and AIR312 rules (#20082)
• [airflow] Replace wrong path airflow.io.storage with airflow.io.store (AIR311) (#20081)
• [flake8-async] Implement blocking-http-call-httpx-in-async-function (ASYNC212) (#20091)
• [flake8-logging-format] Add auto-fix for f-string logging calls (G004) (#19303)
• [flake8-use-pathlib] Add autofix for PTH211 (#20009)
• [flake8-use-pathlib] Make PTH100 fix unsafe because it can change behavior (#20100)

Bug fixes

• [pyflakes, pylint] Fix false positives caused by __class__ cell handling (F841, PLE0117) (#20048)
• [pyflakes] Fix allowed-unused-imports matching for top-level modules (F401) (#20115)
• [ruff] Fix false positive for t-strings in default-factory-kwarg (RUF026) (#20032)
• [ruff] Preserve relative whitespace in multi-line expressions (RUF033) (#19647)

Rule changes

• [ruff] Handle empty t-strings in unnecessary-empty-iterable-within-deque-call (RUF037) (#20045)

Documentation

• Fix incorrect D413 links in docstrings convention FAQ (#20089)
• [flake8-use-pathlib] Update links to the table showing the correspondence between os and pathlib (#20103)

Contributors

• @AlexWaygood
• @Avasam
• @BurntSushi
• @Gankra
• @Glyphack
• @JelleZijlstra
• @Lee-W
• @MatthewMckee4
• @MichaReiser
• @PrettyWood
• @Renkai
• @TaKO8Ki
• @amyreese
• @carljm
• @chirizxc
• @danparizher
• @dhruvmanila
• @dylwil3
• @github-actions
• @hamirmahal
• @ibraheemdev
• @leandrobbraga
• @maxmynter
• @ntBre
• @renovate
• @sharkdp
• @vivster7

Install ruff 0.12.11

Install prebuilt binaries via shell script

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

Install prebuilt binaries via powershell script

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

Download ruff 0.12.11

Release Notes

Preview features

• [flake8-simplify] Implement fix for maxsplit without separator (SIM905) (#19851)
• [flake8-use-pathlib] Add fixes for PTH102 and PTH103 (#19514)

Bug fixes

• [isort] Handle multiple continuation lines after module docstring (I002) (#19818)
• [pyupgrade] Avoid reporting __future__ features as unnecessary when they are used (UP010) (#19769)
• [pyupgrade] Handle nested Optionals (UP045) (#19770)

Rule changes

• [pycodestyle] Make E731 fix unsafe instead of display-only for class assignments (#19700)
• [pyflakes] Add secondary annotation showing previous definition (F811) (#19900)

Documentation

• Fix description of global config file discovery strategy (#19188)
• Update outdated links to https://typing.python.org/en/latest/source/stubs.html (#19992)
• [flake8-annotations] Remove unused import in example (ANN401) (#20000)

Contributors

• @AlexWaygood
• @Avasam
• @BurntSushi
• @Cjkjvfnby
• @Gankra
• @IDrokin117
• @MatthewMckee4
• @MichaReiser
• @PrettyWood
• @RazerM
• @carljm
• @chirizxc
• @danparizher
• @dcreager
• @dhruvmanila
• @ericmarkmartin
• @github-actions
• @gkowzan
• @leandrobbraga
• @mtshiba
• @ntBre
• @renovate
• @sharkdp
• @theammir

Install ruff 0.12.10

Install prebuilt binaries via shell script

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

Install prebuilt binaries via powershell script

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

Download ruff 0.12.10

Release Notes

Preview features

• [airflow] Add check for airflow.secrets.cache.SecretCache (AIR301) (#17707)
• [ruff] Offer a safe fix for multi-digit zeros (RUF064) (#19847)

Bug fixes

• [flake8-blind-except] Fix BLE001 false-positive on raise ... from None (#19755)
• [flake8-comprehensions] Fix false positive for C420 with attribute, subscript, or slice assignment targets (#19513)
• [flake8-simplify] Fix handling of U+001C..U+001F whitespace (SIM905) (#19849)

Rule changes

• [pylint] Use lowercase hex characters to match the formatter (PLE2513) (#19808)

Documentation

• Fix lint.future-annotations link (#19876)

Other changes

• Build riscv64 binaries for release (#19819)

• Add rule code to error description in GitLab output (#19896)

• Improve rendering of the full output format (#19415)

  Below is an example diff for F401:

  -unused.py:8:19: F401 [*] `pathlib` imported but unused
  +F401 [*] `pathlib` imported but unused
  +  --> unused.py:8:19
      |
    7 | # Unused, _not_ marked as required (due to the alias).
    8 | import pathlib as non_alias
  -   |                   ^^^^^^^^^ F401
  +   |                   ^^^^^^^^^
    9 |
   10 | # Unused, marked as required.
      |
  -   = help: Remove unused import: `pathlib`
  +help: Remove unused import: `pathlib`

  For now, the primary difference is the movement of the filename, line number, and column information to a second line in the header. This new representation will allow us to make further additions to Ruff's diagnostics, such as adding sub-diagnostics and multiple annotations to the same snippet.

Contributors

• @AlexWaygood
• @Gankra
• @MatthewMckee4
• @MichaReiser
• @PrettyWood
• @RazerM
• @carljm
• @danparizher
• @dcreager
• @deliro
• @dhruvmanila
• @ember91
• @ffgan
• @harupy
• @ibraheemdev
• @mtshiba
• @nguu0123
• @ntBre
• @oconnor663
• @prabhusneha
• @renovate
• @thejchap

Install ruff 0.12.9

Install prebuilt binaries via shell script

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

Install prebuilt binaries via powershell script

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

Download ruff 0.12.9

Release Notes

Preview features

• [flake8-use-pathlib] Expand PTH201 to check all PurePath subclasses (#19440)

Bug fixes

• [flake8-blind-except] Change BLE001 to correctly parse exception tuples (#19747)
• [flake8-errmsg] Exclude typing.cast from EM101 (#19656)
• [flake8-simplify] Fix raw string handling in SIM905 for embedded quotes (#19591)
• [flake8-import-conventions] Avoid false positives for NFKC-normalized __debug__ import aliases in ICN001 (#19411)
• [isort] Fix syntax error after docstring ending with backslash (I002) (#19505)
• [pylint] Mark PLC0207 fixes as unsafe when *args unpacking is present (#19679)
• [pyupgrade] Prevent infinite loop with I002 (UP010, UP035) (#19413)
• [ruff] Parenthesize generator expressions in f-strings (RUF010) (#19434)

Rule changes

• [eradicate] Don't flag pyrefly pragmas as unused code (ERA001) (#19731)

Documentation

• Replace "associative" with "commutative" in docs for RUF036 (#19706)
• Fix copy and line separator colors in dark mode (#19630)
• Fix link to typing documentation (#19648)
• [refurb] Make more examples error out-of-the-box (#19695,#19673,#19672)

Other changes

• Include column numbers in GitLab output format (#19708)
• Always expand tabs to four spaces in diagnostics (#19618)
• Update pre-commit's ruff id (#19654)

Contributors

• @AlexWaygood
• @BurntSushi
• @MatthewMckee4
• @MeGaGiGaGon
• @MichaReiser
• @UnboundVariable
• @cristian64
• @danparizher
• @dcreager
• @deliro
• @dhruvmanila
• @github-actions
• @harshil21
• @hunterhogan
• @ibraheemdev
• @jimhoekstra
• @jscanvic
• @leandrobbraga
• @mtshiba
• @ngroman
• @ntBre
• @renovate
• @sharkdp
• @silamon

Install ruff 0.12.8

Install prebuilt binaries via shell script

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

Install prebuilt binaries via powershell script

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

Download ruff 0.12.8

Release Notes

This is a follow-up release to 0.12.6. Because of an issue in the package metadata, 0.12.6 failed to publish fully to PyPI and has been yanked. Similarly, there is no GitHub release or Git tag for 0.12.6. The contents of the 0.12.7 release are identical to 0.12.6, except for the updated metadata.

0.12.6 Release Notes

Preview features

• [flake8-commas] Add support for trailing comma checks in type parameter lists (COM812, COM819) (#19390)
• [pylint] Implement auto-fix for missing-maxsplit-arg (PLC0207) (#19387)
• [ruff] Offer fixes for RUF039 in more cases (#19065)

Bug fixes

• Support .pyi files in ruff analyze graph (#19611)
• [flake8-pyi] Preserve inline comment in ellipsis removal (PYI013) (#19399)
• [perflint] Ignore rule if target is global or nonlocal (PERF401) (#19539)
• [pyupgrade] Fix UP030 to avoid modifying double curly braces in format strings (#19378)
• [refurb] Ignore decorated functions for FURB118 (#19339)
• [refurb] Mark int and bool cases for Decimal.from_float as safe fixes (FURB164) (#19468)
• [ruff] Fix RUF033 for named default expressions (#19115)

Rule changes

• [flake8-blind-except] Change BLE001 to permit logging.critical(..., exc_info=True) (#19520)

Performance

• Add support for specifying minimum dots in detected string imports (#19538)

Contributors

• @AlexWaygood
• @BurntSushi
• @CodeMan62
• @DimitriPapadopoulos
• @IDrokin117
• @Luunynliny
• @MichaReiser
• @UnboundVariable
• @carljm
• @charliermarsh
• @clockback
• @danparizher
• @dcreager
• @dhruvmanila
• @dylwil3
• @github-actions
• @junhsonjb
• @mtshiba
• @ntBre
• @renovate
• @robsdedude
• @sharkdp
• @thejchap

Install ruff 0.12.7

Install prebuilt binaries via shell script

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

Install prebuilt binaries via powershell script

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

Download ruff 0.12.7

Release Notes

Preview features

• [flake8-use-pathlib] Add autofix for PTH101, PTH104, PTH105, PTH121 (#19404)
• [ruff] Support byte strings (RUF055) (#18926)

Bug fixes

• Fix unreachable panic in parser (#19183)
• [flake8-pyi] Skip fix if all Union members are None (PYI016) (#19416)
• [perflint] Parenthesize generator expressions (PERF401) (#19325)
• [pylint] Handle empty comments after line continuation (PLR2044) (#19405)

Rule changes

• [pep8-naming] Fix N802 false positives for CGIHTTPRequestHandler and SimpleHTTPRequestHandler (#19432)

Contributors

• @AlexWaygood
• @BurntSushi
• @CodeMan62
• @Gankra
• @MichaReiser
• @UnboundVariable
• @chirizxc
• @danparizher
• @dcreager
• @dhruvmanila
• @dylwil3
• @github-actions
• @ibraheemdev
• @ntBre
• @oconnor663
• @renovate
• @sharkdp
• @soundsonacid
• @thejchap

Install ruff 0.12.5

Install prebuilt binaries via shell script

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

Install prebuilt binaries via powershell script

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

Download ruff 0.12.5