Release Notes

Released on 2026-02-26.

Preview features

• Drop explicit support for .qmd file extension (#23572)

  This can now be enabled instead by setting the extension option:

  ```toml

  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)

Bug fixes

• Avoid infinite loop between 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)

Rule changes

• 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.

Documentation

• Fix missing settings links for several linters (#23519)
• Update isort action comments heading (#23515)
• [pydocstyle] Fix double comma in description of D404 (#23440)

Other changes

• Update the Python module (notably find_ruff_bin) for parity with uv (#23406)

Contributors

• @zanieb
• @o1x3
• @assadyousuf
• @kar-ganap
• @denyszhak
• @amyreese
• @carljm
• @anishgirianish
• @Bnyro
• @danparizher
• @ntBre
• @gcomneno
• @jaap3
• @stakeswky

Install ruff 0.15.3

Install prebuilt binaries via shell script

:::sh
curl --proto '=https' --tlsv1.2 -LsSf https://github.com/astral-sh/ruff/releases/download/0.15.3/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.15.3/ruff-installer.ps1 | iex"

Download ruff 0.15.3

Verifying GitHub Artifact Attestations

The artifacts in this release have attestations generated with GitHub Artifact Attestations. These can be verified by using the GitHub CLI:

:::sh
gh attestation verify <file-path of downloaded artifact> --repo astral-sh/ruff

You can also download the attestation from GitHub and verify against that directly:

:::sh
gh attestation verify <file-path of downloaded artifact> --bundle <file-path of downloaded attestation>