Release Notes

Released on 2026-07-23.

Check out the blog post for a migration guide and overview of the changes!

Breaking changes

• Ruff now enables a much larger set of rules by default (413, up from 59). See the blog post for more details and the new Default Rules page for a full listing of the enabled rules.

• Ruff can now format Python code blocks in Markdown files and will do this by default. See the documentation for more details.

• Ruff now supports ruff: ignore comments at the ends of lines, like noqa comments, or on the line preceding a diagnostic. For example, these both suppress an unused-import (F401) diagnostic:

  ```py import math # ruff: ignore[F401]

  ruff: ignore[F401]

  import os ```

• Fixes are now shown in check and format --check output:

  `console ❯ ruff format --check . unformatted: File would be reformatted --> try.md:1:1 | 1 |python

  • import math 2 + import math 3 | ``` |

  1 file would be reformatted ````

  This example also shows off the Markdown formatting.

• format --check now supports the same output formats as the linter, including the github and gitlab outputs for rendering annotations in CI:

  console ❯ ruff format --check --output-format github . ::error title=ruff (unformatted),file=try.md,line=2,col=8,endLine=2,endColumn=10::try.md:2:8: unformatted: File would be reformatted

  See the CLI help or documentation for the full list of supported formats.

• The filename, location, end_location, fix.edits[].location, and fix.edits[].end_location fields in the JSON output format may now be null rather than defaulting to the empty string and row 1, column 1, respectively.

Stabilization

The following rules have been stabilized and are no longer in preview:

• airflow3-incompatible-function-signature (AIR303)
• missing-copyright-notice (CPY001)
• unnecessary-from-float (FURB164)
• sorted-min-max (FURB192)
• implicit-string-concatenation-in-collection-literal (ISC004)
• log-exception-outside-except-handler (LOG004)
• invalid-bool-return-type (PLE0304)
• too-many-positional-arguments (PLR0917)
• stop-iteration-return (PLR1708)
• none-not-at-end-of-union (RUF036)
• access-annotations-from-class-dict (RUF063)
• duplicate-entry-in-dunder-all (RUF068)

The following behaviors have been stabilized:

• blind-except (BLE001) is now suppressed when the exception is logged via logging methods other than critical, error and exception.
• future-required-type-annotation (FA102) now checks for additional PEP 585-compatible APIs, such as those from collections.abc.
• f-string-in-get-text-func-call (INT001), format-in-get-text-func-call (INT002), and printf-in-get-text-func-call (INT003) now check for additional common ways of using the gettext module, such as assigning it to builtins._.
• suspicious-url-open-usage (S310) now resolves local string literal bindings to avoid more false positives.
• snmp-insecure-version (S508) and snmp-weak-cryptography (S509) now support the recommended API from newer versions of PySNMP.
• typing-text-str-alias (UP019) now recognizes typing_extensions.Text in addition to typing.Text.

Preview features

• [pyupgrade] Fix false positive with TypeVar default before Python 3.13 (UP040) (#26888)

Bug fixes

• [ruff] Fix missing check on unrecognized early bound (RUF016) (#26986)

Rule changes

• Insert a space after the colon in Ruff suppression comments (#27123)

Performance

• [pyupgrade] Speed up unnecessary-future-import (UP010) (#27047)

Documentation

• [ruff] Add missing period in "Why is this bad?" section (RUF200) (#26930)
• [flake8-simplify] Clarify os.environ behavior on Windows (SIM112) (#26972)
• [pydocstyle] Document fix safety (D400) (#26971)

Contributors

• @jonathandung
• @Joosboy
• @MichaReiser
• @Andrej730
• @ntBre
• @zaniebot

Install ruff 0.16.0

Install prebuilt binaries via shell script

:::sh
curl --proto '=https' --tlsv1.2 -LsSf https://releases.astral.sh/github/ruff/releases/download/0.16.0/ruff-installer.sh | sh

Install prebuilt binaries via powershell script

:::sh
powershell -ExecutionPolicy Bypass -c "irm https://releases.astral.sh/github/ruff/releases/download/0.16.0/ruff-installer.ps1 | iex"

Download ruff 0.16.0

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

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>