changelogs/0.13.x.md
Check out the blog post for a migration guide and overview of the 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.
The following rules have been removed:
pandas-df-variable-name (PD901)non-pep604-isinstance (UP038)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).multiple-with-statements
(SIM117) is now marked as always safe.pyupgrade] Enable UP043 in stub files (#20027)pyupgrade] Apply UP008 only when the __class__ cell exists (#19424)ruff] Fix empty f-string detection in in-empty-collection (RUF060) (#20249)pep8-naming] Fix formatting of __all__ (N816) (#20301)Released on 2025-09-18.
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)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)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)output-format=sarif (#20300)ruff] Add analyze.string-imports-min-dots to settings (#20375)Released on 2025-09-25.
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).pyw files by default when linting and formatting (#20458)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)ruff-wasm-web (#20539)flake8-bandit] Clarify the supported hashing functions (S324) (#20534)playground] Allow hover quick fixes to appear for overlapping diagnostics (#20527)playground] Fix non‑BMP code point handling in quick fixes and markers (#20526)Released on 2025-10-02.
ruff format --check and add support for different output formats (#20443)pyflakes] Handle some common submodule import situations for unused-import (F401) (#20200)ruff] Do not flag %r + repr() combinations (RUF065) (#20600)cli] Add conflict between --add-noqa and --diff options (#20642)pylint] Exempt required imports from PLR0402 (#20381)pylint] Fix missing max-nested-blocks in settings display (#20574)pyupgrade] Prevent infinite loop with I002 and UP026 (#20634)flake8-simplify] Improve help message clarity (SIM105) (#20548)isort] Clarify dependency between order-by-type and case-sensitive settings (#20559)pylint] Clarify fix safety to include left-hand hashability (PLR6201) (#20518)playground] Fix quick fixes for empty ranges in playground (#20599)