Ruff Files

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

:::sh
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

:::sh
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

File	Platform	Checksum
ruff-aarch64-apple-darwin.tar.gz	Apple Silicon macOS	checksum
ruff-x86_64-apple-darwin.tar.gz	Intel macOS	checksum
ruff-aarch64-pc-windows-msvc.zip	ARM64 Windows	checksum
ruff-i686-pc-windows-msvc.zip	x86 Windows	checksum
ruff-x86_64-pc-windows-msvc.zip	x64 Windows	checksum
ruff-aarch64-unknown-linux-gnu.tar.gz	ARM64 Linux	checksum
ruff-i686-unknown-linux-gnu.tar.gz	x86 Linux	checksum
ruff-powerpc64-unknown-linux-gnu.tar.gz	PPC64 Linux	checksum
ruff-powerpc64le-unknown-linux-gnu.tar.gz	PPC64LE Linux	checksum
ruff-riscv64gc-unknown-linux-gnu.tar.gz	RISCV Linux	checksum
ruff-s390x-unknown-linux-gnu.tar.gz	S390x Linux	checksum
ruff-x86_64-unknown-linux-gnu.tar.gz	x64 Linux	checksum
ruff-armv7-unknown-linux-gnueabihf.tar.gz	ARMv7 Linux	checksum
ruff-aarch64-unknown-linux-musl.tar.gz	ARM64 MUSL Linux	checksum
ruff-i686-unknown-linux-musl.tar.gz	x86 MUSL Linux	checksum
ruff-x86_64-unknown-linux-musl.tar.gz	x64 MUSL Linux	checksum
ruff-arm-unknown-linux-musleabihf.tar.gz	ARMv6 MUSL Linux (Hardfloat)	checksum
ruff-armv7-unknown-linux-musleabihf.tar.gz	ARMv7 MUSL Linux	checksum