Released on 2026-03-19.
pycodestyle] Recognize pyrefly: as a pragma comment (E501) (#24019)pylint] Improve phrasing (PLC0208) (#24033)Released on 2026-03-12.
lazy import parsing (#23755)airflow] Flag Variable.get() calls outside of task execution context (AIR003) (#23584)airflow] Flag runtime-varying values in DAG/task constructor arguments (AIR304) (#23631)flake8-bugbear] Implement delattr-with-constant (B043) (#23737)flake8-tidy-imports] Add TID254 to enforce lazy imports (#23777)flake8-tidy-imports] Allow users to ban lazy imports with TID254 (#23847)isort] Retain lazy keyword when sorting imports (#23762)pyupgrade] Add from __future__ import annotations automatically (UP006) (#23260)refurb] Support newline parameter in FURB101 for Python 3.13+ (#23754)ruff] Add os-path-commonprefix (RUF071) (#23814)ruff] Add unsafe fix for os-path-commonprefix (RUF071) (#23852)ruff] Limit RUF036 to typing contexts; make it unsafe for non-typing-only (#23765)ruff] Use starred unpacking for RUF017 in Python 3.15+ (#23789)--add-noqa creating unwanted leading whitespace (#23773)--add-noqa breaking shebangs (#23577)flake8-annotations] Fix stack overflow in ANN401 on quoted annotations with escape sequences (#23912)pep8-naming] Check naming conventions in match pattern bindings (N806, N815, N816) (#23899)perflint] Fix comment duplication in fixes (PERF401, PERF403) (#23729)pyupgrade] Properly trigger super change in nested class (UP008) (#22677)ruff] Avoid syntax errors in RUF036 fixes (#23764)flake8-bandit] Flag S501 with requests.request (#23873)flake8-executable] Fix WSL detection in non-Docker containers (#22879)flake8-print] Ignore pprint calls with stream= (#23787)flake8-bugbear] Fix misleading description for B904 (#23731)Released on 2026-03-05.
perflint] Extend PERF102 to comprehensions and generators (#23473)refurb] Fix FURB101 and FURB103 false positives when I/O variable is used later (#23542)ruff] Add fix for none-not-at-end-of-union (RUF036) (#22829)ruff] Fix false positive for re.split with empty string pattern (RUF055) (#23634)fastapi] Handle callable class dependencies with __call__ method (FAST003) (#23553)pydocstyle] Fix numpy section ordering (D420) (#23685)pyflakes] Fix false positive for names shadowing re-exports (F811) (#23356)pyupgrade] Avoid inserting redundant None elements in UP045 (#23459)Released on 2026-02-26.
This is a follow-up release to 0.15.3 that resolves a panic when the new rule PLR1712 was enabled with any rule that analyzes definitions, such as many of the ANN or D rules.
pyflakes] Suppress false positive in F821 for names used before del in stub files (#23550)Released on 2026-02-26.
Drop explicit support for .qmd file extension (#23572)
This can now be enabled instead by setting the extension option:
# ruff.toml extension = { qmd = "markdown" } # pyproject.toml [tool.ruff] extension = { qmd = "markdown" }
Include configured extensions in file discovery (#23400)
[flake8-bandit] Allow suspicious imports in TYPE_CHECKING blocks (S401-S415) (#23441)
[flake8-bugbear] Allow B901 in pytest hook wrappers (#21931)
[flake8-import-conventions] Add missing conventions from upstream (ICN001, ICN002) (#21373)
[pydocstyle] Add rule to enforce docstring section ordering (D420) (#23537)
[pylint] Implement swap-with-temporary-variable (PLR1712) (#22205)
[ruff] Add unnecessary-assign-before-yield (RUF070) (#23300)
[ruff] Support file-level noqa in RUF102 (#23535)
[ruff] Suppress diagnostic for invalid f-strings before Python 3.12 (RUF027) (#23480)
[flake8-bandit] Don't flag BaseLoader/CBaseLoader as unsafe (S506) (#23510)
I002 and PYI025 (#23352)pyflakes] Fix false positive for @overload from lint.typing-modules (F811) (#23357)pyupgrade] Fix false positive for TypeVar default before Python 3.12 (UP046) (#23540)pyupgrade] Fix handling of \N in raw strings (UP032) (#22149)Render sub-diagnostics in the GitHub output format (#23455)
[flake8-bugbear] Tag certain B007 diagnostics as unnecessary (#23453)
[ruff] Ignore unknown rule codes in RUF100 (#23531)
These are now flagged by RUF102 instead.
pydocstyle] Fix double comma in description of D404 (#23440)find_ruff_bin) for parity with uv (#23406)Released on 2026-02-19.
Expand the default rule set (#23385)
In preview, Ruff now enables a significantly expanded default rule set of 412 rules, up from the stable default set of 59 rules. The new rules are mostly a superset of the stable defaults, with the exception of these rules, which are removed from the preview defaults:
multiple-imports-on-one-line (E401)module-import-not-at-top-of-file (E402)module-import-not-at-top-of-file (E701)multiple-statements-on-one-line-semicolon (E702)useless-semicolon (E703)none-comparison (E711)true-false-comparison (E712)not-in-test (E713)not-is-test (E714)type-comparison (E721)lambda-assignment (E731)ambiguous-variable-name (E741)ambiguous-class-name (E742)ambiguous-function-name (E743)undefined-local-with-import-star (F403)undefined-local-with-import-star-usage (F405)undefined-local-with-nested-import-star-usage (F406)forward-annotation-syntax-error (F722)If you use preview and prefer the old defaults, you can restore them with configuration like:
# ruff.toml [lint] select = ["E4", "E7", "E9", "F"] # pyproject.toml [tool.ruff.lint] select = ["E4", "E7", "E9", "F"]
If you do give them a try, feel free to share your feedback in the GitHub discussion!
[flake8-pyi] Also check string annotations (PYI041) (#19023)
flake8-async] Fix in_async_context logic (#23426)ruff] Fix for RUF102 should delete entire comment (#23380)ruff] Suppress diagnostic for strings with backslashes in interpolations before Python 3.12 (RUF027) (#21069)flake8-bugbear] Fix B023 false positive for immediately-invoked lambdas (#23294)flake8-executable] Allow global flags in uv shebangs (EXE003) (#22582)pyupgrade] Fix handling of typing.{io,re} (UP035) (#23131)ruff] Detect PLC0207 on chained str.split() calls (#23275)noqa warning (#23270)Q004 to the list of conflicting rules (#23340)ruff] Expand lint.external docs and add sub-diagnostic (RUF100, RUF102) (#23268)Released on 2026-02-12.
airflow] Add ruff rules to catch deprecated Airflow imports for Airflow 3.1 (AIR321) (#22376)airflow] Third positional parameter not named ti_key should be flagged for BaseOperatorLink.get_link (AIR303) (#22828)flake8-gettext] Fix false negatives for plural argument of ngettext (INT001, INT002, INT003) (#21078)pyflakes] Fix infinite loop in preview fix for unused-import (F401) (#23038)pygrep-hooks] Detect non-existent mock methods in standalone expressions (PGH005) (#22830)pylint] Allow dunder submodules and improve diagnostic range (PLC2701) (#22804)pyupgrade] Improve diagnostic range for tuples (UP024) (#23013)refurb] Check subscripts in tuple do not use lambda parameters in reimplemented-operator (FURB118) (#23079)ruff] Detect mutable defaults in field calls (RUF008) (#23046)ruff] Ignore std cmath.inf (RUF069) (#23120)ruff] New rule float-equality-comparison (RUF069) (#20585)pycon Markdown code blocks (#23112)FAST001 (#23224)FAST003 autofix (#23227)InitVar for __post_init__ that references PEP 695 type parameters (#23226)RUF020 target for multiline fixes (#23210)UP007 target for multiline fixes (#23208)pyupgrade] Fix syntax error on string with newline escape and comment (UP037) (#22968)ruff instead of Ruff as the program name in GitHub output format (#23240)PT006] Fix syntax error when unpacking nested tuples in parametrize fixes (#22441) (#22464)airflow] Catch deprecated attribute access from context key for Airflow 3.0 (AIR301) (#22850)airflow] Capture deprecated arguments and a decorator (AIR301) (#23170)flake8-boolean-trap] Add multiprocessing.Value to excluded functions for FBT003 (#23010)flake8-bugbear] Add a secondary annotation showing the previous occurrence (B033) (#22634)flake8-type-checking] Add sub-diagnostic showing the runtime use of an annotation (TC004) (#23091)isort] Support configurable import section heading comments (#23151)ruff] Improve the diagnostic for RUF012 (#23202)format --check --silent (#17736)runtime-evaluated-decorators example (#23187)Released on 2026-02-03.
Check out the blog post for a migration guide and overview of the changes!
Ruff now formats your code according to the 2026 style guide. See the formatter section below or in the blog post for a detailed list of changes.
The linter now supports block suppression comments. For example, to suppress N803 for all parameters in this function:
# ruff: disable[N803] def foo( legacyArg1, legacyArg2, legacyArg3, legacyArg4, ): ... # ruff: enable[N803]
See the documentation for more details.
The ruff:alpine Docker image is now based on Alpine 3.23 (up from 3.21).
The ruff:debian and ruff:debian-slim Docker images are now based on Debian 13 “Trixie” instead of Debian 12 “Bookworm.”
Binaries for the ppc64 (64-bit big-endian PowerPC) architecture are no longer included in our releases. It should still be possible to build Ruff manually for this platform, if needed.
Ruff now resolves all extended configuration files before falling back on a default Python version.
The following rules have been stabilized and are no longer in preview:
blocking-http-call-httpx-in-async-function (ASYNC212)blocking-path-method-in-async-function (ASYNC240)blocking-input-in-async-function (ASYNC250)map-without-explicit-strict (B912)if-exp-instead-of-or-operator (FURB110)single-item-membership-test (FURB171)missing-maxsplit-arg (PLC0207)unnecessary-lambda (PLW0108)unnecessary-empty-iterable-within-deque-call (RUF037)in-empty-collection (RUF060)legacy-form-pytest-raises (RUF061)non-octal-permissions (RUF064)invalid-rule-code (RUF102)invalid-suppression-comment (RUF103)unmatched-suppression-comment (RUF104)replace-str-enum (UP042)The following behaviors have been stabilized:
--output-format flag is now respected when running Ruff in --watch mode, and the full output format is now used by default, matching the regular CLI output.builtin-attribute-shadowing (A003) now detects the use of shadowed built-in names in additional contexts like decorators, default arguments, and other attribute definitions.duplicate-union-member (PYI016) now considers typing.Optional when searching for duplicate union members.split-static-string (SIM905) now offers an autofix when the maxsplit argument is provided, even without a sep argument.dict-get-with-none-default (SIM910) now applies to more types of key expressions.super-call-with-parameters (UP008) now has a safe fix when it will not delete comments.unnecessary-default-type-args (UP043) now applies to stub (.pyi) files on Python versions before 3.13.This release introduces the new 2026 style guide, with the following changes:
except clauses will now be removed on Python 3.14 and later (#20768)as captures in match statements (#21176)Apply formatting to Markdown code blocks (#22470, #22990, #22996)
See the documentation for more details.
fix_title sub-diagnostic appears (#23044)FastAPI] Add sub-diagnostic explaining why a fix was unavailable (FAST002) (#22565)flake8-annotations] Don't suggest NoReturn for functions raising NotImplementedError (ANN201, ANN202, ANN205, ANN206) (#21311)pyupgrade] Make fix unsafe if it deletes comments (UP017) (#22873)pyupgrade] Make fix unsafe if it deletes comments (UP020) (#22872)pyupgrade] Make fix unsafe if it deletes comments (UP033) (#22871)refurb] Do not add abc.ABC if already present (FURB180) (#22234)refurb] Make fix unsafe if it deletes comments (FURB110) (#22768)ruff] Add sub-diagnostics with permissions (RUF064) (#22972)didOpen instead of .ipynb file extension (#22810)--color CLI option to force colored output (#22806)- stdin convention in CLI help text (#22817)refurb] Change example to re.search with ^ anchor (FURB167) (#22984)pydocstyle] Clarify which quote styles are allowed (D300) (#22825)flake8-bugbear] Improve docs for no-explicit-stacklevel (B028) (#22538)See changelogs/0.9.x
See changelogs/0.8.x
See changelogs/0.7.x
See changelogs/0.6.x
See changelogs/0.5.x
See changelogs/0.4.x
See changelogs/0.3.x
See changelogs/0.2.x
See changelogs/0.1.x