Ruff 0.13.0 download

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)