Releases: astral-sh/ruff
Release list
0.16.7
Release Notes
Released on 2026-09-10.
Preview features
- [
ruff] Add rule for default values on method receivers (RUF077) (#26700) - [
ruff] Recognizere.prefixmatch(RUF039,RUF055) (#28311)
Bug fixes
- Alternate nested quotes inside format spec interpolations (#28259)
- [
flake8-implicit-str-concat] Mark fix unsafe when it creates a docstring (ISC003) (#27981) - [
flake8-tidy-imports] Skip fixes for multi-member imports (TID254) (#26584) - [
pylint] GateImportCycleErroron Python 3.15 (PLW0133) (#28310)
Rule changes
- Correct
D211andD203rule conflict diagnostic (#28444) - Recognize
sliceandfrozendictgenerics (#28477) - Stop defining
__cached__for Python 3.15 (#28476) - [
pyupgrade] Stop recommending removedtyping.no_type_check_decorator(UP035) (#28475)
Performance
- Reuse parser name lookups when interning (#28399)
- Speed up inherited configuration resolution (#28299)
Documentation
Other changes
- Embed archive checksums in the shell installer (#28281)
Contributors
- @The-Compiler
- @mdiniz97
- @zsol
- @gorewilliams
- @RafaelJohn9
- @qatcod
- @zanieb
- @MichaReiser
- @ntBre
- @charliermarsh
- @nightt5879
- @jonathandung
- @jogo-openai
Install ruff 0.16.7
Install prebuilt binaries via shell script
curl --proto '=https' --tlsv1.2 -LsSf https://releases.astral.sh/github/ruff/releases/download/0.16.7/ruff-installer.sh | shInstall prebuilt binaries via powershell script
powershell -ExecutionPolicy Bypass -c "irm https://releases.astral.sh/github/ruff/releases/download/0.16.7/ruff-installer.ps1 | iex"Download ruff 0.16.7
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:
gh attestation verify <file-path of downloaded artifact> --repo astral-sh/ruffYou can also download the attestation from GitHub and verify against that directly:
gh attestation verify <file-path of downloaded artifact> --bundle <file-path of downloaded attestation>0.16.6
Release Notes
Released on 2026-09-03.
Preview features
- Move
pytest-fixture-autouseto therestrictioncategory (#28219) - [
flake8-pytest-style] Add an autofix forPT020(#27993) - [
flake8-tidy-imports] Prevent fix loop betweenTID254andTID255(#28262) - [
isort] Exclude pragma comments from line length calculation (I001) (#27313)
Bug fixes
- Validate unary expressions when parsing (#28233)
- [
flake8-async,pylint] Recognizebuiltins.open(ASYNC230,PLW1514) (#28021) - [
flake8-bugbear] Fix panic onmatchsubjects (B031) (#27781) - [
flake8-datetimez] Rejecttzinfo=Nonefordatetimebounds (DTZ901) (#28022) - [
flake8-pytest-style] Avoid duplicatePT017diagnostics (#27918) - [
ruff] Removelint.externalhint for Ruff-specific suppressions (RUF102) (#27923)
Rule changes
- [
flake8-use-pathlib] Add display-only fix foros.listdir(PTH208) (#28027)
Documentation
- Add another example and glob reference for
lint.per-file-ignores(#28106) - Add duplicate work guidance (#28229)
- [
flake8-async] Document thread offloading (ASYNC240) (#28008) - [
pyupgrade] Clarify defaultencodingargument handling (UP012) (#27315)
Other changes
- Allow unary plus in match patterns on Python 3.15 (#28231)
Contributors
- @flying-sheep
- @pikammmmm
- @fly1d
- @waterWang
- @Pierre-Sassoulas
- @ntBre
- @jelle-openai
- @ericbuehl
- @tjkuson
- @AbhinavMir
- @Whning0513
- @chirizxc
Install ruff 0.16.6
Install prebuilt binaries via shell script
curl --proto '=https' --tlsv1.2 -LsSf https://releases.astral.sh/github/ruff/releases/download/0.16.6/ruff-installer.sh | shInstall prebuilt binaries via powershell script
powershell -ExecutionPolicy Bypass -c "irm https://releases.astral.sh/github/ruff/releases/download/0.16.6/ruff-installer.ps1 | iex"Download ruff 0.16.6
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:
gh attestation verify <file-path of downloaded artifact> --repo astral-sh/ruffYou can also download the attestation from GitHub and verify against that directly:
gh attestation verify <file-path of downloaded artifact> --bundle <file-path of downloaded attestation>0.16.5
Release Notes
Released on 2026-08-27.
Preview features
- Allow rules without codes (#28049)
- Introduce category selectors (#27666)
- Update preview default rules and categories (#27877)
Bug fixes
- [
flake8-async] Detect blocking generic HTTP requests (ASYNC210) (#28024) - [
flake8-datetimez] Allow timezone-safestrptimechains (DTZ007) (#28023) - [
flake8-simplify] Respect side effects inlambdadefaults (SIM401) (#28000)
Server
- Fix duplicated "of" in
ClientOptionsdoc comment (#27978)
Documentation
Contributors
Install ruff 0.16.5
Install prebuilt binaries via shell script
curl --proto '=https' --tlsv1.2 -LsSf https://releases.astral.sh/github/ruff/releases/download/0.16.5/ruff-installer.sh | shInstall prebuilt binaries via powershell script
powershell -ExecutionPolicy Bypass -c "irm https://releases.astral.sh/github/ruff/releases/download/0.16.5/ruff-installer.ps1 | iex"Download ruff 0.16.5
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:
gh attestation verify <file-path of downloaded artifact> --repo astral-sh/ruffYou can also download the attestation from GitHub and verify against that directly:
gh attestation verify <file-path of downloaded artifact> --bundle <file-path of downloaded attestation>0.16.4
Release Notes
Released on 2026-08-20.
Preview features
- [
flake8-use-pathlib] Add autofix forPTH116(#26460) - [
refurb] Restrictdelete-full-sliceto lists (FURB131) (#27711) - [
refurb] SkipFURB101andFURB103when theopenargument is a file descriptor (#27643)
Bug fixes
- Fix
InvalidInstructionon Windows CPUs that do not supportPOPCNT(#27803) - [
pyflakes] Emit semantic syntax errors in string type definitions asF722(#27835) - [
pylint] Allowos._exitimports inimport-private-name(PLC2701) (#27738)
Rule changes
- [syntax-errors] Align mixed t-string/bytes error message with CPython 3.14 (#27766)
- [
ruff] Addctypes.LittleEndianStructureand related types to existing exception (RUF012) (#27753) - [syntax-errors] Detect duplicate keyword arguments (#17804)
- [syntax-errors] Detect parameters declared
nonlocal(#27628)
Server
- Offer display-only fixes and mark safe fixes preferred (#27807)
- Support pull diagnostics for notebook cells (#27779)
Documentation
Other changes
- Fix s390x stacker assembly in release builds (#27776)
- Guarantee minimum stack size when parsing a module, standalone expression, and suites (#25464)
- Reduce configuration deserialization code size (#27924)
- Check packed AST index bounds (#27849)
Contributors
- @AbhinavMir
- @eduardorittner
- @royb3
- @MichaReiser
- @carljm
- @rosstitmarsh
- @ntBre
- @zaniebot
- @ewdurbin
- @woodruffw
- @Sacrimento
- @lakshayxi
- @WhiteFox0-0
- @baltasarblanco
Install ruff 0.16.4
Install prebuilt binaries via shell script
curl --proto '=https' --tlsv1.2 -LsSf https://releases.astral.sh/github/ruff/releases/download/0.16.4/ruff-installer.sh | shInstall prebuilt binaries via powershell script
powershell -ExecutionPolicy Bypass -c "irm https://releases.astral.sh/github/ruff/releases/download/0.16.4/ruff-installer.ps1 | iex"Download ruff 0.16.4
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:
gh attestation verify <file-path of downloaded artifact> --repo astral-sh/ruffYou can also download the attestation from GitHub and verify against that directly:
gh attestation verify <file-path of downloaded artifact> --bundle <file-path of downloaded attestation>0.16.3
Release Notes
Released on 2026-08-13.
Preview features
- [
pylint] Fix false negatives on negative numbers (PLR6104) (#27251) - [
pyupgrade] Add rule to replacewhile 1withwhile True(UP048) (#27190)
Bug fixes
- [
flake8-bandit] Also check keyword arguments (S602,S603,S607,S609) (#27687) - [
pylint] Allowcontinueinfinallyon Python 3.8 (#27626) - [
pylint] FixPLE1307false positive with bools (#27651) - [
pylint] Fix false positives and negatives with%bformat character (PLE1300,PLE1307) (#27560) - [
pylint] Improve handling of concatenated strings (PLE1300) (#27659)
Rule changes
- [
numpy] Makenp.chararrayautofix backwards-compatible (NPY201) (#27527)
Performance
- Enable PGO for Linux x86-64 Ruff releases (#27570)
- Enable PGO for Linux ARM64 Ruff releases (#27574)
- Enable PGO for Windows x86-64 Ruff releases (#27573)
- Enable PGO for macOS ARM64 Ruff releases (#27572)
- Reduce
Exprsize to 64 bytes (#27591)
CLI
- Hyperlink rule codes in
ruff check --statisticsoutput (#27646)
Documentation
- [
ruff] Also suggestasyncio.TaskGroup(RUF006) (#27461)
Other changes
- Use mimalloc v3 (#27586)
Contributors
- @Andrej730
- @alonfaraj
- @romero-deshaw
- @Avasam
- @tjkuson
- @charliermarsh
- @chirizxc
- @saberoueslati
- @MichaReiser
Install ruff 0.16.3
Install prebuilt binaries via shell script
curl --proto '=https' --tlsv1.2 -LsSf https://releases.astral.sh/github/ruff/releases/download/0.16.3/ruff-installer.sh | shInstall prebuilt binaries via powershell script
powershell -ExecutionPolicy Bypass -c "irm https://releases.astral.sh/github/ruff/releases/download/0.16.3/ruff-installer.ps1 | iex"Download ruff 0.16.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:
gh attestation verify <file-path of downloaded artifact> --repo astral-sh/ruffYou can also download the attestation from GitHub and verify against that directly:
gh attestation verify <file-path of downloaded artifact> --bundle <file-path of downloaded attestation>0.16.2
Release Notes
Released on 2026-08-06.
Bug fixes
- [
flake8-pyi] Avoid false positives onsingledispatchfunctions (PYI041) (#27335)
Server
- Register formatting capabilities dynamically to exclude TOML files (#27332)
Contributors
Install ruff 0.16.2
Install prebuilt binaries via shell script
curl --proto '=https' --tlsv1.2 -LsSf https://releases.astral.sh/github/ruff/releases/download/0.16.2/ruff-installer.sh | shInstall prebuilt binaries via powershell script
powershell -ExecutionPolicy Bypass -c "irm https://releases.astral.sh/github/ruff/releases/download/0.16.2/ruff-installer.ps1 | iex"Download ruff 0.16.2
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:
gh attestation verify <file-path of downloaded artifact> --repo astral-sh/ruffYou can also download the attestation from GitHub and verify against that directly:
gh attestation verify <file-path of downloaded artifact> --bundle <file-path of downloaded attestation>0.16.1
Release Notes
Released on 2026-07-30.
Preview features
- Add an option to opt out of human-readable names (#27160)
- [
flake8-pytest-style] Make fixes safe by default and unsafe only when comments are present (PT018) (#27201) - [
pyupgrade] Skip fix when a defaultedTypeVarprecedes a non-defaulted one (UP040,UP046,UP047) (#27133) - [
ruff] Fix false positive with unpacked arguments (RUF065) (#26959)
Bug fixes
- Bump
gen-lsp-typesto gracefully handle unknown enumeration values in LSP messages (#27230) - [
flake8-bugbear] Markrangeas immutable (B008) (#27247) - [
flake8-comprehensions] NFKC-normalize keyword names inC408fix (#26813) - [
flake8-return] Fix false positive when variable is read infinallyclause (RET504) (#25441) - [
pydocstyle] Skip section detection inside RST directive bodies (D214,D405,D413) (#23635) - [
refurb] Parenthesizeyieldarguments in theFURB192fix (#27192)
Rule changes
- [
flake8-pytest-style] MarkPT022fixes as unsafe (#26440) - [
refurb] Mark fixes that remove unknown separators as unsafe (FURB105) (#27200)
Server
Documentation
- Cover
pyconMarkdown formatting (#27153) - [
flake8-bandit] DocumentTYPE_CHECKINGexception (S101) (#27004) - [
flake8-import-conventions] Document thatextend-aliasescan override default aliases (#27191) - [
pylint] Add missing fix safety gotchas fornon-augmented-assignment(PLR6104) (#27250)
Other changes
- Reduce syntax error noise by swallowing dedents like indents (#27170)
- Vendor latest annotate-snippets (#27033)
Contributors
- @bxff
- @anishgirianish
- @Avasam
- @epage
- @LHMQ878
- @MichaReiser
- @ntBre
- @HarshalPatel1972
- @mjpieters
- @joshuavetos
- @jesco-absolute
- @vidigoat
- @baltasarblanco
- @ribru17
- @oh-summy
- @Jayashanker-Padishala
Install ruff 0.16.1
Install prebuilt binaries via shell script
curl --proto '=https' --tlsv1.2 -LsSf https://releases.astral.sh/github/ruff/releases/download/0.16.1/ruff-installer.sh | shInstall prebuilt binaries via powershell script
powershell -ExecutionPolicy Bypass -c "irm https://releases.astral.sh/github/ruff/releases/download/0.16.1/ruff-installer.ps1 | iex"Download ruff 0.16.1
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:
gh attestation verify <file-path of downloaded artifact> --repo astral-sh/ruffYou can also download the attestation from GitHub and verify against that directly:
gh attestation verify <file-path of downloaded artifact> --bundle <file-path of downloaded attestation>0.16.0
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. Note that this is primarily an expansion, but 18 of the more opinionated pycodestyle (
E) and pyflakes (F) rules have been removed from the default set:E401,E402,E701,E702,E703,E711,E712,E713,E714,E721,E731,E741,E742,E743,F403,F405,F406, andF722. -
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: ignorecomments at the ends of lines, likenoqacomments, or on the line preceding a diagnostic. For example, these both suppress anunused-import(F401) diagnostic:import math # ruff: ignore[F401] # ruff: ignore[F401] import os
-
Fixes are now shown in
checkandformat --checkoutput:❯ 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 --checknow supports the same output formats as the linter, including thegithubandgitlaboutputs for rendering annotations in CI:❯ 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, andfix.edits[].end_locationfields in the JSON output format may now benullrather 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 vialoggingmethods other thancritical,errorandexception.future-required-type-annotation(FA102) now checks for additional PEP 585-compatible APIs, such as those fromcollections.abc.f-string-in-get-text-func-call(INT001),format-in-get-text-func-call(INT002), andprintf-in-get-text-func-call(INT003) now check for additional common ways of using thegettextmodule, such as assigning it tobuiltins._.suspicious-url-open-usage(S310) now resolves local string literal bindings to avoid more false positives.snmp-insecure-version(S508) andsnmp-weak-cryptography(S509) now support the recommended API from newer versions of PySNMP.typing-text-str-alias(UP019) now recognizestyping_extensions.Textin addition totyping.Text.
Preview features
- [
pyupgrade] Fix false positive withTypeVardefault 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 upunnecessary-future-import(UP010) (#27047)
Documentation
- [
ruff] Add missing period in "Why is this bad?" section (RUF200) (#26930) - [
flake8-simplify] Clarifyos.environbehavior on Windows (SIM112) (#26972) - [
pydocstyle] Document fix safety (D400) (#26971)
Contributors
Install ruff 0.16.0
Install prebuilt binaries via shell script
curl --proto '=https' --tlsv1.2 -LsSf https://releases.astral.sh/github/ruff/releases/download/0.16.0/ruff-installer.sh | shInstall prebuilt binaries via powershell script
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 | 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-unknow... |
0.15.22
Release Notes
Released on 2026-07-16.
Preview features
- [
pycodestyle] Add an autofix forE402(#22212) - [
refurb] Allow subclassing builtins in stub files (FURB189) (#26812) - [
ruff] Add rule to replacenoqacomments withruff:ignore(RUF105) (#26423) - [
ruff] Add rule to use human-readable names inruff:ignorecomments (RUF106) (#26682) - [
ruff] Add rule to use human-readable names in configuration selectors (RUF201) (#26772)
Bug fixes
- [
flake8-pyi] Fix false positive in__all__(PYI053) (#26872)
Rule changes
- [
pylint] Ignore mutable type updates inredefined-loop-name(PLW2901) (#25733)
Performance
- Avoid redundant lexer token bookkeeping (#26765)
- Avoid redundant pending-indentation writes (#26774)
- Avoid unnecessary identifier lookahead (#26525)
- Reuse parser scratch buffers (#26798)
Documentation
- Document argfile support (#26803)
- [
flake8-datetimez] Clarify naming guidance fordatetime.today(DTZ002) (#26658) - [
pycodestyle] DocumentE731fix safety (#26847) - [
ruff] Clarify intentional async contexts forunused-async(RUF029) (#26641)
Contributors
Install ruff 0.15.22
Install prebuilt binaries via shell script
curl --proto '=https' --tlsv1.2 -LsSf https://releases.astral.sh/github/ruff/releases/download/0.15.22/ruff-installer.sh | shInstall prebuilt binaries via powershell script
powershell -ExecutionPolicy Bypass -c "irm https://releases.astral.sh/github/ruff/releases/download/0.15.22/ruff-installer.ps1 | iex"Download ruff 0.15.22
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:
gh attestation verify <file-path of downloaded artifact> --repo astral-sh/ruffYou can also download the attestation from GitHub and verify against that directly:
gh attestation verify <file-path of downloaded artifact> --bundle <file-path of downloaded attestation>0.15.21
Release Notes
Released on 2026-07-09.
Preview features
- Add
--add-ignorefor addingruff:ignorecomments (#26346) - [
flake8-comprehensions] DropC409tuple comprehension preview behavior (#25707) - Avoid whitespace normalization when formatting comments (#26455)
- [
pyupgrade] Lint and fix use of deprecatedabcdecorators (UP051) (#26417)
Bug fixes
- Refine non-empty f-string detection (#26526)
- Detect syntax errors in individual notebook cells (#26419)
- [
flake8-implicit-str-concat] FixISC003autofix incorrectly stripping+from comments (#26554)
Rule changes
- [
flake8-executable] MarkEXE004fix as unsafe (#26033) - [
flake8-pyi] MarkPYI061fixes as unsafe in Python files (#26533) - [
pydocstyle] Skipoverload-with-docstringin stub files (D418) (#26318)
Performance
- Avoid per-token source index visitor calls (#26506)
- Cache parenthesized expression boundaries in the formatter (#26344)
- Improve performance of rendering edits in preview mode (#26565)
- Inline
fits_elementin formatter (#26429) - Inline formatter printing hot paths (#26504)
- Lazily create builtin bindings (#26510)
- Skip empty trivia scans in the source indexer (#26507)
- Use ICF for macOS release builds (#25780)
Formatter
- Add
--extend-excludetoruff format(#26372)
Documentation
- Add "How does Ruff's import sorting compare to isort?" link to README (#26530)
- Fix Mozilla Firefox repository link in README (#26537)
- [
flake8-bandit] Fix misleading docstring formako-templates(S702) (#26432) - [
ruff] Fix non-triggering example forif-key-in-dict-del(RUF051) (#26433)
Contributors
- @EkriirkE
- @tingerrr
- @s-rigaud
- @nikolauspschuetz
- @Avasam
- @ntBre
- @omar-y-abdi
- @AlexWaygood
- @sylvestre
- @shaanmajid
- @lerebear
- @baltasarblanco
- @Sanjays2402
- @ZedThree
- @servusdei2018
- @charliermarsh
- @jesco-absolute
- @velikodniy
- @zaniebot
- @epage
Install ruff 0.15.21
Install prebuilt binaries via shell script
curl --proto '=https' --tlsv1.2 -LsSf https://releases.astral.sh/github/ruff/releases/download/0.15.21/ruff-installer.sh | shInstall prebuilt binaries via powershell script
powershell -ExecutionPolicy Bypass -c "irm https://releases.astral.sh/github/ruff/releases/download/0.15.21/ruff-installer.ps1 | iex"Download ruff 0.15.21
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:
gh attestation verify <file-path of downloaded artifact> --repo astral-sh/ruffYou can also download the attestation from GitHub and verify against that directly:
gh attestation verify <file-path of downloaded artifact> --bundle <file-path of downloaded attestation>