Releases: astral-sh/ruff
Releases · astral-sh/ruff
0.12.8
Release Notes
Preview features
- [
flake8-use-pathlib] ExpandPTH201to check allPurePathsubclasses (#19440)
Bug fixes
- [
flake8-blind-except] ChangeBLE001to correctly parse exception tuples (#19747) - [
flake8-errmsg] Excludetyping.castfromEM101(#19656) - [
flake8-simplify] Fix raw string handling inSIM905for embedded quotes (#19591) - [
flake8-import-conventions] Avoid false positives for NFKC-normalized__debug__import aliases inICN001(#19411) - [
isort] Fix syntax error after docstring ending with backslash (I002) (#19505) - [
pylint] MarkPLC0207fixes as unsafe when*argsunpacking is present (#19679) - [
pyupgrade] Prevent infinite loop withI002(UP010,UP035) (#19413) - [
ruff] Parenthesize generator expressions in f-strings (RUF010) (#19434)
Rule changes
- [
eradicate] Don't flagpyreflypragmas as unused code (ERA001) (#19731)
Documentation
- Replace "associative" with "commutative" in docs for
RUF036(#19706) - Fix copy and line separator colors in dark mode (#19630)
- Fix link to
typingdocumentation (#19648) - [
refurb] Make more examples error out-of-the-box (#19695,#19673,#19672)
Other changes
- Include column numbers in GitLab output format (#19708)
- Always expand tabs to four spaces in diagnostics (#19618)
- Update pre-commit's
ruffid (#19654)
Contributors
- @AlexWaygood
- @BurntSushi
- @MatthewMckee4
- @MeGaGiGaGon
- @MichaReiser
- @UnboundVariable
- @cristian64
- @danparizher
- @dcreager
- @deliro
- @dhruvmanila
- @github-actions
- @harshil21
- @hunterhogan
- @ibraheemdev
- @jimhoekstra
- @jscanvic
- @leandrobbraga
- @mtshiba
- @ngroman
- @ntBre
- @renovate
- @sharkdp
- @silamon
Install ruff 0.12.8
Install prebuilt binaries via shell script
curl --proto '=https' --tlsv1.2 -LsSf https://github.com/astral-sh/ruff/releases/download/0.12.8/ruff-installer.sh | shInstall prebuilt binaries via powershell script
powershell -ExecutionPolicy Bypass -c "irm https://github.com/astral-sh/ruff/releases/download/0.12.8/ruff-installer.ps1 | iex"Download ruff 0.12.8
0.12.7
Release Notes
This is a follow-up release to 0.12.6. Because of an issue in the package metadata, 0.12.6 failed to publish fully to PyPI and has been yanked. Similarly, there is no GitHub release or Git tag for 0.12.6. The contents of the 0.12.7 release are identical to 0.12.6, except for the updated metadata.
0.12.6 Release Notes
Preview features
- [
flake8-commas] Add support for trailing comma checks in type parameter lists (COM812,COM819) (#19390) - [
pylint] Implement auto-fix formissing-maxsplit-arg(PLC0207) (#19387) - [
ruff] Offer fixes forRUF039in more cases (#19065)
Bug fixes
- Support
.pyifiles in ruff analyze graph (#19611) - [
flake8-pyi] Preserve inline comment in ellipsis removal (PYI013) (#19399) - [
perflint] Ignore rule if target isglobalornonlocal(PERF401) (#19539) - [
pyupgrade] FixUP030to avoid modifying double curly braces in format strings (#19378) - [
refurb] Ignore decorated functions forFURB118(#19339) - [
refurb] Markintandboolcases forDecimal.from_floatas safe fixes (FURB164) (#19468) - [
ruff] FixRUF033for named default expressions (#19115)
Rule changes
- [
flake8-blind-except] ChangeBLE001to permitlogging.critical(..., exc_info=True)(#19520)
Performance
- Add support for specifying minimum dots in detected string imports (#19538)
Contributors
- @AlexWaygood
- @BurntSushi
- @CodeMan62
- @DimitriPapadopoulos
- @IDrokin117
- @Luunynliny
- @MichaReiser
- @UnboundVariable
- @carljm
- @charliermarsh
- @clockback
- @danparizher
- @dcreager
- @dhruvmanila
- @dylwil3
- @github-actions
- @junhsonjb
- @mtshiba
- @ntBre
- @renovate
- @robsdedude
- @sharkdp
- @thejchap
Install ruff 0.12.7
Install prebuilt binaries via shell script
curl --proto '=https' --tlsv1.2 -LsSf https://github.com/astral-sh/ruff/releases/download/0.12.7/ruff-installer.sh | shInstall prebuilt binaries via powershell script
powershell -ExecutionPolicy Bypass -c "irm https://github.com/astral-sh/ruff/releases/download/0.12.7/ruff-installer.ps1 | iex"Download ruff 0.12.7
0.12.5
Release Notes
Preview features
- [
flake8-use-pathlib] Add autofix forPTH101,PTH104,PTH105,PTH121(#19404) - [
ruff] Support byte strings (RUF055) (#18926)
Bug fixes
- Fix
unreachablepanic in parser (#19183) - [
flake8-pyi] Skip fix if allUnionmembers areNone(PYI016) (#19416) - [
perflint] Parenthesize generator expressions (PERF401) (#19325) - [
pylint] Handle empty comments after line continuation (PLR2044) (#19405)
Rule changes
- [
pep8-naming] FixN802false positives forCGIHTTPRequestHandlerandSimpleHTTPRequestHandler(#19432)
Contributors
- @AlexWaygood
- @BurntSushi
- @CodeMan62
- @Gankra
- @MichaReiser
- @UnboundVariable
- @chirizxc
- @danparizher
- @dcreager
- @dhruvmanila
- @dylwil3
- @github-actions
- @ibraheemdev
- @ntBre
- @oconnor663
- @renovate
- @sharkdp
- @soundsonacid
- @thejchap
Install ruff 0.12.5
Install prebuilt binaries via shell script
curl --proto '=https' --tlsv1.2 -LsSf https://github.com/astral-sh/ruff/releases/download/0.12.5/ruff-installer.sh | shInstall prebuilt binaries via powershell script
powershell -ExecutionPolicy Bypass -c "irm https://github.com/astral-sh/ruff/releases/download/0.12.5/ruff-installer.ps1 | iex"Download ruff 0.12.5
0.12.4
Release Notes
Preview features
- [
flake8-type-checking,pyupgrade,ruff] Addfrom __future__ import annotationswhen it would allow new fixes (TC001,TC002,TC003,UP037,RUF013) (#19100) - [
flake8-use-pathlib] Add autofix forPTH109(#19245) - [
pylint] Detect indirectpathlib.Pathusages forunspecified-encoding(PLW1514) (#19304)
Bug fixes
- [
flake8-bugbear] FixB017false negatives for keyword exception arguments (#19217) - [
flake8-use-pathlib] Fix false negative on directPath()instantiation (PTH210) (#19388) - [
flake8-django] FixDJ008false positive for abstract models with type-annotatedabstractfield (#19221) - [
isort] FixI002import insertion after docstring with multiple string statements (#19222) - [
isort] Treat form feed as valid whitespace before a semicolon (#19343) - [
pydoclint] FixSyntaxErrorfrom fixes with line continuations (D201,D202) (#19246) - [
refurb]FURB164fix should validate arguments and should usually be marked unsafe (#19136)
Rule changes
- [
flake8-use-pathlib] Skip single dots forinvalid-pathlib-with-suffix(PTH210) on versions >= 3.14 (#19331) - [
pep8_naming] Avoid false positives on standard library functions with uppercase names (N802) (#18907) - [
pycodestyle] Handle brace escapes for t-strings in logical lines (#19358) - [
pylint] Extend invalid string character rules to include t-strings (#19355) - [
ruff] Allowstrictkwarg when checking forstarmap-zip(RUF058) in Python 3.14+ (#19333)
Documentation
- [
flake8-type-checking] MakeTC010docs example more realistic (#19356) - Make more documentation examples error out-of-the-box (#19288,#19272,#19291,#19296,#19292,#19295,#19297,#19309)
Contributors
- @AlexWaygood
- @BurntSushi
- @Gankra
- @MatthewMckee4
- @MeGaGiGaGon
- @MichaReiser
- @UnboundVariable
- @chirizxc
- @close2code-palm
- @corneliusroemer
- @danparizher
- @dcreager
- @dhruvmanila
- @dylwil3
- @github-actions
- @ntBre
- @oconnor663
- @renovate
- @sharkdp
- @soundsonacid
- @w0nder1ng
- @zanieb
Install ruff 0.12.4
Install prebuilt binaries via shell script
curl --proto '=https' --tlsv1.2 -LsSf https://github.com/astral-sh/ruff/releases/download/0.12.4/ruff-installer.sh | shInstall prebuilt binaries via powershell script
powershell -ExecutionPolicy Bypass -c "irm https://github.com/astral-sh/ruff/releases/download/0.12.4/ruff-installer.ps1 | iex"Download ruff 0.12.4
0.12.3
Release Notes
Preview features
- [
flake8-bugbear] Support non-context-manager calls inB017(#19063) - [
flake8-use-pathlib] Add autofixes forPTH100,PTH106,PTH107,PTH108,PTH110,PTH111,PTH112,PTH113,PTH114,PTH115,PTH117,PTH119,PTH120(#19213) - [
flake8-use-pathlib] Add autofixes forPTH203,PTH204,PTH205(#18922)
Bug fixes
- [
flake8-return] Fix false-positive for variables used inside nested functions inRET504(#18433) - Treat form feed as valid whitespace before a line continuation (#19220)
- [
flake8-type-checking] Fix syntax error introduced by fix (TC008) (#19150) - [
pyupgrade] Keyword arguments insupershould suppress theUP008fix (#19131)
Documentation
- [
flake8-pyi] Make example error out-of-the-box (PYI007,PYI008) (#19103) - [
flake8-simplify] Make example error out-of-the-box (SIM116) (#19111) - [
flake8-type-checking] Make example error out-of-the-box (TC001) (#19151) - [
flake8-use-pathlib] Make example error out-of-the-box (PTH210) (#19189) - [
pycodestyle] Make example error out-of-the-box (E272) (#19191) - [
pycodestyle] Make example not raise unnecessarySyntaxError(E114) (#19190) - [
pydoclint] Make example error out-of-the-box (DOC501) (#19218) - [
pylint,pyupgrade] Fix syntax errors in examples (PLW1501,UP028) (#19127) - [
pylint] Updatemissing-maxsplit-argdocs and error to suggest proper usage (PLC0207) (#18949) - [
flake8-bandit] Make example error out-of-the-box (S412) (#19241)
Contributors
- @AlexWaygood
- @BurntSushi
- @Gankra
- @InSyncWithFoo
- @LaBatata101
- @MatthewMckee4
- @MeGaGiGaGon
- @MichaReiser
- @NamelessGO
- @UnboundVariable
- @abhijeetbodas2001
- @carljm
- @charliermarsh
- @chirizxc
- @danparizher
- @dhruvmanila
- @fdosani
- @github-actions
- @ibraheemdev
- @iyakushev
- @junhsonjb
- @ntBre
- @renovate
- @sharkdp
- @soundsonacid
- @thejchap
- @zanieb
Install ruff 0.12.3
Install prebuilt binaries via shell script
curl --proto '=https' --tlsv1.2 -LsSf https://github.com/astral-sh/ruff/releases/download/0.12.3/ruff-installer.sh | shInstall prebuilt binaries via powershell script
powershell -ExecutionPolicy Bypass -c "irm https://github.com/astral-sh/ruff/releases/download/0.12.3/ruff-installer.ps1 | iex"Download ruff 0.12.3
0.12.2
Release Notes
Preview features
- [
flake8-pyi] ExpandOptional[A]toA | None(PYI016) (#18572) - [
pyupgrade] MarkUP008fix safe if no comments are in range (#18683)
Bug fixes
- [
flake8-comprehensions] FixC420to prepend whitespace when needed (#18616) - [
perflint] FixPERF403panic on attribute or subscription loop variable (#19042) - [
pydocstyle] FixD413infinite loop for parenthesized docstring (#18930) - [
pylint] FixPLW0108autofix introducing a syntax error when the lambda's body contains an assignment expression (#18678) - [
refurb] Fix false positive on empty tuples (FURB168) (#19058) - [
ruff] Allow morefieldcalls fromattrs(RUF009) (#19021) - [
ruff] Fix syntax error introduced for an empty string followed by a u-prefixed string (UP025) (#18899)
Rule changes
- [
flake8-executable] Allowuvxin shebang line (EXE003) (#18967) - [
pandas] Avoid flaggingPD002ifpandasis not imported (#18963) - [
pyupgrade] Avoid PEP-604 unions withtyping.NamedTuple(UP007,UP045) (#18682)
Documentation
- Document link between
import-outside-top-level (PLC0415)andlint.flake8-tidy-imports.banned-module-level-imports(#18733) - Fix description of the
format.skip-magic-trailing-commaexample (#19095) - [
airflow] MakeAIR302example error out-of-the-box (#18988) - [
airflow] MakeAIR312example error out-of-the-box (#18989) - [
flake8-annotations] MakeANN401example error out-of-the-box (#18974) - [
flake8-async] MakeASYNC100example error out-of-the-box (#18993) - [
flake8-async] MakeASYNC105example error out-of-the-box (#19002) - [
flake8-async] MakeASYNC110example error out-of-the-box (#18975) - [
flake8-async] MakeASYNC210example error out-of-the-box (#18977) - [
flake8-async] MakeASYNC220,ASYNC221, andASYNC222examples error out-of-the-box (#18978) - [
flake8-async] MakeASYNC251example error out-of-the-box (#18990) - [
flake8-bandit] MakeS201example error out-of-the-box (#19017) - [
flake8-bandit] MakeS604andS609examples error out-of-the-box (#19049) - [
flake8-bugbear] MakeB028example error out-of-the-box (#19054) - [
flake8-bugbear] MakeB911example error out-of-the-box (#19051) - [
flake8-datetimez] MakeDTZ011example error out-of-the-box (#19055) - [
flake8-datetimez] MakeDTZ901example error out-of-the-box (#19056) - [
flake8-pyi] MakePYI032example error out-of-the-box (#19061) - [
flake8-pyi] Make example error out-of-the-box (PYI014,PYI015) (#19097) - [
flake8-pyi] Make example error out-of-the-box (PYI042) (#19101) - [
flake8-pyi] Make example error out-of-the-box (PYI059) (#19080) - [
flake8-pyi] Make example error out-of-the-box (PYI062) (#19079) - [
flake8-pytest-style] Make example error out-of-the-box (PT023) (#19104) - [
flake8-pytest-style] Make example error out-of-the-box (PT030) (#19105) - [
flake8-quotes] Make example error out-of-the-box (Q003) (#19106) - [
flake8-simplify] Make example error out-of-the-box (SIM110) (#19113) - [
flake8-simplify] Make example error out-of-the-box (SIM113) (#19109) - [
flake8-simplify] Make example error out-of-the-box (SIM401) (#19110) - [
pyflakes] Fix backslash in docs (F621) (#19098) - [
pylint] FixPLC0415example (#18970)
Contributors
- @AlexWaygood
- @Avasam
- @BurntSushi
- @CodeMan62
- @Gankra
- @InSyncWithFoo
- @LaBatata101
- @LeanderCS
- @MatthewMckee4
- @MeGaGiGaGon
- @MichaReiser
- @NamelessGO
- @adriencaccia
- @carljm
- @danparizher
- @dcreager
- @dhruvmanila
- @dylwil3
- @github-actions
- @ibraheemdev
- @jordyjwilliams
- @lubaskinc0de
- @med1844
- @mtshiba
- @ntBre
- @renovate
- @robsdedude
- @sharkdp
- @yairp03
- @zanieb
Install ruff 0.12.2
Install prebuilt binaries via shell script
curl --proto '=https' --tlsv1.2 -LsSf https://github.com/astral-sh/ruff/releases/download/0.12.2/ruff-installer.sh | shInstall prebuilt binaries via powershell script
powershell -ExecutionPolicy Bypass -c "irm https://github.com/astral-sh/ruff/releases/download/0.12.2/ruff-installer.ps1 | iex"Download ruff 0.12.2
| 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-s390x-unknown-linux-gnu.tar.gz | S390x Linux | [checksum]... |
0.12.1
Release Notes
Preview features
- [
flake8-errmsg] ExtendEM101to support byte strings (#18867) - [
flake8-use-pathlib] Add autofix forPTH202(#18763) - [
pygrep-hooks] AddAsyncMockmethods toinvalid-mock-access(PGH005) (#18547) - [
pylint] Ignore__init__.pyfiles in (PLC0414) (#18400) - [
ruff] TriggerRUF037for empty string and byte strings (#18862) - [formatter] Fix missing blank lines before decorated classes in
.pyifiles (#18888)
Bug fixes
- Avoid generating diagnostics with per-file ignores (#18801)
- Handle parenthesized arguments in
remove_argument(#18805) - [
flake8-logging] Avoid false positive forexc_info=Trueoutsidelogger.exception(LOG014) (#18737) - [
flake8-pytest-style] Enforcepytestimport for decorators (#18779) - [
flake8-pytest-style] Mark autofix forPT001andPT023as unsafe if there's comments in the decorator (#18792) - [
flake8-pytest-style]PT001/PT023fix makes syntax error on parenthesized decorator (#18782) - [
flake8-raise] Make fix unsafe if it deletes comments (RSE102) (#18788) - [
flake8-simplify] FixSIM911autofix creating a syntax error (#18793) - [
flake8-simplify] Fix false negatives for shadowed bindings (SIM910,SIM911) (#18794) - [
flake8-simplify] Preserve original behavior forexcept ()and bareexcept(SIM105) (#18213) - [
flake8-pyi] FixPYI041's fix causingTypeErrorwithNone | None | ...(#18637) - [
perflint] FixPERF101autofix creating a syntax error and mark autofix as unsafe if there are comments in thelistcall expr (#18803) - [
perflint] Fix false negative inPERF401(#18866) - [
pylint] Avoid flattening nestedmin/maxwhen outer call has single argument (PLW3301) (#16885) - [
pylint] FixPLC2801autofix creating a syntax error (#18857) - [
pylint] MarkPLE0241autofix as unsafe if there's comments in the base classes (#18832) - [
pylint] SuppressPLE2510/PLE2512/PLE2513/PLE2514/PLE2515autofix if the text contains an odd number of backslashes (#18856) - [
refurb] Detect more exotic float literals inFURB164(#18925) - [
refurb] FixFURB163autofix creating a syntax error foryieldexpressions (#18756) - [
refurb] MarkFURB129autofix as unsafe if there's comments in thereadlinescall (#18858) - [
ruff] Fix false positives and negatives inRUF010(#18690) - Fix casing of
analyze.directionvariant names (#18892)
Rule changes
- Fix f-string interpolation escaping in generated fixes (#18882)
- [
flake8-return] MarkRET501fix unsafe if comments are inside (#18780) - [
flake8-async] Fix detection for large integer sleep durations inASYNC116rule (#18767) - [
flake8-async] Mark autofix forASYNC115as unsafe if the call expression contains comments (#18753) - [
flake8-bugbear] Mark autofix forB004as unsafe if thehasattrcall expr contains comments (#18755) - [
flake8-comprehension] Mark autofix forC420as unsafe if there's comments inside the dict comprehension (#18768) - [
flake8-comprehensions] Handle template strings for comprehension fixes (#18710) - [
flake8-future-annotations] Add autofix (FA100) (#18903) - [
pyflakes] MarkF504/F522/F523autofix as unsafe if there's a call with side effect (#18839) - [
pylint] Allow fix with comments and document performance implications (PLW3301) (#18936) - [
pylint] Detect more exoticNaNliterals inPLW0177(#18630) - [
pylint] FixPLC1802autofix creating a syntax error and mark autofix as unsafe if there's comments in thelencall (#18836) - [
pyupgrade] Extend version detection to includesys.version_info.major(UP036) (#18633) - [
ruff] Add lint ruleRUF064for callingchmodwith non-octal integers (#18541) - [
ruff] Addedcls.__dict__.get('__annotations__')check (RUF063) (#18233) - [
ruff] Frozendataclassdefault should be valid (RUF009) (#18735)
Server
- Consider virtual path for various server actions (#18910)
Documentation
- Add fix safety sections (#18940,#18841,#18802,#18837,#18800,#18415,#18853,#18842)
- Use updated pre-commit id (#18718)
- [
perflint] Small docs improvement toPERF401(#18786) - [
pyupgrade]: Usesuper(), not__super__in error messages (UP008) (#18743) - [
flake8-pie] Small docs fix toPIE794(#18829) - [
flake8-pyi] Correctcollections-named-tupleexample to use PascalCase assignment (#16884) - [
flake8-pie] Add note on type checking benefits tounnecessary-dict-kwargs(PIE804) (#18666) - [
pycodestyle] Clarify PEP 8 relationship towhitespace-around-operatorrules (#18870)
Other changes
- Disallow newlines in format specifiers of single quoted f- or t-strings (#18708)
- [
flake8-logging] Add fix safety section toLOG002(#18840) - [
pyupgrade] Add fix safety section toUP010(#18838)
Contributors
- @AlexWaygood
- @Andrej730
- @BurntSushi
- @GideonBear
- @InSyncWithFoo
- @JosiahKane
- @LaBatata101
- @LyricalToxic
- @MeGaGiGaGon
- @MichaReiser
- @RazerM
- @VascoSch92
- @alpaylan
- @carljm
- @charliermarsh
- @chirizxc
- @danparizher
- @dcreager
- @dericcrago
- @dhruvmanila
- @dylwil3
- @gopoto
- @hmvp
- @krikera
- @lubaskinc0de
- @mashehu
- @med1844
- @njhearp
- @ntBre
- @renovate
- @robsdedude
- @sharkdp
- @sobolevn
- @suneettipirneni
- @yunchipang
- @zanieb
Install ruff 0.12.1
Install prebuilt binaries via shell script
curl --proto '=https' --tlsv1.2 -LsSf https://github.com/astral-sh/ruff/releases/download/0.12.1/ruff-installer.sh | shInstall prebuilt binaries via powershell scrip...
0.12.0
Release Notes
Check out the blog post for a migration guide and overview of the changes!
Breaking changes
-
Detection of more syntax errors
Ruff now detects version-related syntax errors, such as the use of the
match
statement on Python versions before 3.10, and syntax errors emitted by
CPython's compiler, such as irrefutablematchpatterns before the final
casearm. -
New default Python version handling for syntax errors
Ruff will default to the latest supported Python version (3.13) when
checking for the version-related syntax errors mentioned above to prevent
false positives in projects without a Python version configured. The default
in all other cases, like applying lint rules, is unchanged and remains at the
minimum supported Python version (3.9). -
Updated f-string formatting
Ruff now formats multi-line f-strings with format specifiers to avoid adding a
line break after the format specifier. This addresses a change to the Python
grammar in version 3.13.4 that made such a line break a syntax error. -
rust-toolchain.tomlis no longer included in source distributionsThe
rust-toolchain.tomlis used to specify a higher Rust version than Ruff's
minimum supported Rust version (MSRV) for development and building release
artifacts. However, when present in source distributions, it would also cause
downstream package maintainers to pull in the same Rust toolchain, even if
their available toolchain was MSRV-compatible.
Removed Rules
The following rules have been removed:
suspicious-xmle-tree-usage(S320)
Deprecated Rules
The following rules have been deprecated:
Stabilization
The following rules have been stabilized and are no longer in preview:
for-loop-writes(FURB122)check-and-remove-from-set(FURB132)verbose-decimal-constructor(FURB157)fromisoformat-replace-z(FURB162)int-on-sliced-str(FURB166)exc-info-outside-except-handler(LOG014)import-outside-top-level(PLC0415)unnecessary-dict-index-lookup(PLR1733)nan-comparison(PLW0177)eq-without-hash(PLW1641)pytest-parameter-with-default-argument(PT028)pytest-warns-too-broad(PT030)pytest-warns-with-multiple-statements(PT031)invalid-formatter-suppression-comment(RUF028)dataclass-enum(RUF049)class-with-mixed-type-vars(RUF053)unnecessary-round(RUF057)starmap-zip(RUF058)non-pep604-annotation-optional(UP045)non-pep695-generic-class(UP046)non-pep695-generic-function(UP047)private-type-parameter(UP049)
The following behaviors have been stabilized:
collection-literal-concatenation(RUF005) now recognizes slices, in
addition to list literals and variables.- The fix for
readlines-in-for(FURB129) is now marked as always safe. if-else-block-instead-of-if-exp(SIM108) will now further simplify
expressions to useorinstead of anifexpression, where possible.unused-noqa(RUF100) now checks for file-levelnoqacomments as well
as inline comments.subprocess-without-shell-equals-true(S603) now accepts literal strings,
as well as lists and tuples of literal strings, as trusted input.boolean-type-hint-positional-argument(FBT001) now applies to types that
includebool, likebool | intortyping.Optional[bool], in addition to
plainboolannotations.non-pep604-annotation-union(UP007) has now been split into two rules.
UP007now applies only totyping.Union, while
non-pep604-annotation-optional(UP045) checks for use of
typing.Optional.UP045has also been stabilized in this release, but you
may need to update existinginclude,ignore, ornoqasettings to
accommodate this change.
Preview features
- [
ruff] Check for non-context-manager use ofpytest.raises,pytest.warns, andpytest.deprecated_call(RUF061) (#17368) - [syntax-errors] Raise unsupported syntax error for template strings prior to Python 3.14 (#18664)
Bug fixes
- Add syntax error when conversion flag does not immediately follow exclamation mark (#18706)
- Add trailing space around
readlines(#18542) - Fix
\rand\r\nhandling in t- and f-string debug texts (#18673) - Hug closing
}when f-string expression has a format specifier (#18704) - [
flake8-pyi] Avoid syntax error in the case of starred and keyword arguments (PYI059) (#18611) - [
flake8-return] FixRET504autofix generating a syntax error (#18428) - [
pep8-naming] Suppress fix forN804andN805if the recommended name is already used (#18472) - [
pycodestyle] Avoid causing a syntax error in expressions spanning multiple lines (E731) (#18479) - [
pyupgrade] SuppressUP008ifsuperis shadowed (#18688) - [
refurb] Parenthesize lambda and ternary expressions (FURB122,FURB142) (#18592) - [
ruff] Handle extra arguments todeque(RUF037) (#18614) - [
ruff] Preserve parentheses arounddequein fix forunnecessary-empty-iterable-within-deque-call(RUF037) (#18598) - [
ruff] Validate arguments before offering a fix (RUF056) (#18631) - [
ruff] Skip fix forRUF059if dummy name is already bound (#18509) - [
pylint] FixPLW0128to check assignment targets in square brackets and after asterisks (#18665)
Rule changes
- Fix false positive on mutations in
returnstatements (B909) (#18408) - Treat
ty:comments as pragma comments (#18532) - [
flake8-pyi] Applycustom-typevar-for-selfto string annotations (PYI019) (#18311) - [
pyupgrade] Don't offer a fix forOptional[None](UP007,UP045)(#18545) - [
pyupgrade] Fixsuper(__class__, self)detection (UP008) (#18478) - [
refurb] Make the fix forFURB163unsafe forlog2,log10,*args, and deleted comments (#18645)
Server
- Support cancellation requests (#18627)
Documentation
0.11.13
Release Notes
Preview features
- [
airflow] Add unsafe fix for module moved cases (AIR301,AIR311,AIR312,AIR302) (#18367,#18366,#18363,#18093) - [
refurb] Add coverage ofsetandfrozensetcalls (FURB171) (#18035) - [
refurb] MarkFURB180fix unsafe when class has bases (#18149)
Bug fixes
- [
perflint] Fix missing parentheses for lambda and ternary conditions (PERF401,PERF403) (#18412) - [
pyupgrade] ApplyUP035only on py313+ forget_type_hints()(#18476) - [
pyupgrade] Make fix unsafe if it deletes comments (UP004,UP050) (#18393, #18390)
Rule changes
- [
fastapi] Avoid false positive for class dependencies (FAST003) (#18271)
Documentation
- Update editor setup docs for Neovim and Vim (#18324)
Other changes
- Support Python 3.14 template strings (t-strings) in formatter and parser (#17851)
Contributors
- @AlexWaygood
- @BurntSushi
- @InSyncWithFoo
- @Lee-W
- @MatthewMckee4
- @MichaReiser
- @Viicos
- @abhijeetbodas2001
- @carljm
- @chirizxc
- @dcreager
- @dhruvmanila
- @dylwil3
- @github-actions
- @ibraheemdev
- @lipefree
- @mtshiba
- @naslundx
- @ntBre
- @otakutyrant
- @renovate
- @robsdedude
- @sharkdp
- @twentyone212121
- @zanieb
Install ruff 0.11.13
Install prebuilt binaries via shell script
curl --proto '=https' --tlsv1.2 -LsSf https://github.com/astral-sh/ruff/releases/download/0.11.13/ruff-installer.sh | shInstall prebuilt binaries via powershell script
powershell -ExecutionPolicy Bypass -c "irm https://github.com/astral-sh/ruff/releases/download/0.11.13/ruff-installer.ps1 | iex"Download ruff 0.11.13
0.11.12
Release Notes
Preview features
- [
airflow] Revise fix titles (AIR3) (#18215) - [
pylint] Implementmissing-maxsplit-arg(PLC0207) (#17454) - [
pyupgrade] New ruleUP050(useless-class-metaclass-type) (#18334) - [
flake8-use-pathlib] Replaceos.symlinkwithPath.symlink_to(PTH211) (#18337)
Bug fixes
- [
flake8-bugbear] Ignore__debug__attribute inB010(#18357) - [
flake8-async] Fixanyio.sleepargument name (ASYNC115,ASYNC116) (#18262) - [
refurb] FixFURB129autofix generating invalid syntax (#18235)
Rule changes
- [
flake8-implicit-str-concat] Add autofix forISC003(#18256) - [
pycodestyle] Improve the diagnostic message forE712(#18328) - [
flake8-2020] Fix diagnostic message for!=comparisons (YTT201) (#18293) - [
pyupgrade] Make fix unsafe if it deletes comments (UP010) (#18291)
Documentation
- Simplify rules table to improve readability (#18297)
- Update editor integrations link in README (#17977)
- [
flake8-bugbear] Add fix safety section (B006) (#17652)
Contributors
- @AlexWaygood
- @CodeMan62
- @InSyncWithFoo
- @Kalmaegi
- @LaBatata101
- @Lee-W
- @MaddyGuthridge
- @MatthewMckee4
- @MichaReiser
- @Vasanth-96
- @carljm
- @charliermarsh
- @chirizxc
- @dcreager
- @dhruvmanila
- @dsherret
- @dylwil3
- @felixscherz
- @fennr
- @j178
- @lipefree
- @maxmynter
- @ntBre
- @otakutyrant
- @renovate
- @sharkdp
- @thejchap
- @vjurczenia
Install ruff 0.11.12
Install prebuilt binaries via shell script
curl --proto '=https' --tlsv1.2 -LsSf https://github.com/astral-sh/ruff/releases/download/0.11.12/ruff-installer.sh | shInstall prebuilt binaries via powershell script
powershell -ExecutionPolicy Bypass -c "irm https://github.com/astral-sh/ruff/releases/download/0.11.12/ruff-installer.ps1 | iex"