Releases: astral-sh/ruff
Releases · astral-sh/ruff
0.11.4
Release Notes
Preview features
- [
ruff] Implementinvalid-rule-codeasRUF102(#17138) - [syntax-errors] Detect duplicate keys in
matchmapping patterns (#17129) - [syntax-errors] Detect duplicate attributes in
matchclass patterns (#17186) - [syntax-errors] Detect invalid syntax in annotations (#17101)
Bug fixes
- [syntax-errors] Fix multiple assignment error for class fields in
matchpatterns (#17184) - Don't skip visiting non-tuple slice in
typing.Annotatedsubscripts (#17201)
Contributors
Install ruff 0.11.4
Install prebuilt binaries via shell script
curl --proto '=https' --tlsv1.2 -LsSf https://github.com/astral-sh/ruff/releases/download/0.11.4/ruff-installer.sh | shInstall prebuilt binaries via powershell script
powershell -ExecutionPolicy Bypass -c "irm https://github.com/astral-sh/ruff/releases/download/0.11.4/ruff-installer.ps1 | iex"Download ruff 0.11.4
0.11.3
Release Notes
Preview features
- [
airflow] Add more autofixes forAIR302(#16876, #16977, #16976, #16965) - [
airflow] MoveAIR301toAIR002(#16978) - [
airflow] MoveAIR302toAIR301andAIR303toAIR302(#17151) - [
flake8-bandit] Markstrandlist[str]literals as trusted input (S603) (#17136) - [
ruff] Support slices inRUF005(#17078) - [syntax-errors] Start detecting compile-time syntax errors (#16106)
- [syntax-errors] Duplicate type parameter names (#16858)
- [syntax-errors] Irrefutable
casepattern before final case (#16905) - [syntax-errors] Multiple assignments in
casepattern (#16957) - [syntax-errors] Single starred assignment target (#17024)
- [syntax-errors] Starred expressions in
return,yield, andfor(#17134) - [syntax-errors] Store to or delete
__debug__(#16984)
Bug fixes
- Error instead of
panic!when running Ruff from a deleted directory (#16903) (#17054) - [syntax-errors] Fix false positive for parenthesized tuple index (#16948)
CLI
- Check
pyproject.tomlcorrectly when it is passed via stdin (#16971)
Configuration
- [
flake8-import-conventions] Add importnumpy.typing as nptto defaultflake8-import-conventions.aliases(#17133)
Documentation
- [
refurb] Document whyUserDict,UserList, andUserStringare preferred overdict,list, andstr(FURB189) (#16927)
Contributors
- @AlexWaygood
- @BurntSushi
- @InSyncWithFoo
- @Lee-W
- @MatthewMckee4
- @MichaReiser
- @VascoSch92
- @akx
- @alex-700
- @amin-not-found
- @ashb
- @cake-monotone
- @carljm
- @dan-wilton
- @dcreager
- @dhruvmanila
- @dylwil3
- @ericmarkmartin
- @github-actions
- @john-science
- @manzt
- @maxmynter
- @mishamsk
- @mtshiba
- @ntBre
- @renovate
- @sharkdp
- @trag1c
Install ruff 0.11.3
Install prebuilt binaries via shell script
curl --proto '=https' --tlsv1.2 -LsSf https://github.com/astral-sh/ruff/releases/download/0.11.3/ruff-installer.sh | shInstall prebuilt binaries via powershell script
powershell -ExecutionPolicy ByPass -c "irm https://github.com/astral-sh/ruff/releases/download/0.11.3/ruff-installer.ps1 | iex"Download ruff 0.11.3
0.11.2
Release Notes
Preview features
- [syntax-errors] Fix false-positive syntax errors emitted for annotations on variadic parameters before Python 3.11 (#16878)
Contributors
Install ruff 0.11.2
Install prebuilt binaries via shell script
curl --proto '=https' --tlsv1.2 -LsSf https://github.com/astral-sh/ruff/releases/download/0.11.2/ruff-installer.sh | shInstall prebuilt binaries via powershell script
powershell -ExecutionPolicy ByPass -c "irm https://github.com/astral-sh/ruff/releases/download/0.11.2/ruff-installer.ps1 | iex"Download ruff 0.11.2
0.11.1
Release Notes
Preview features
- [
airflow] Addchain,chain_linearandcross_downstreamforAIR302(#16647) - [syntax-errors] Improve error message and range for pre-PEP-614 decorator syntax errors (#16581)
- [syntax-errors] PEP 701 f-strings before Python 3.12 (#16543)
- [syntax-errors] Parenthesized context managers before Python 3.9 (#16523)
- [syntax-errors] Star annotations before Python 3.11 (#16545)
- [syntax-errors] Star expression in index before Python 3.11 (#16544)
- [syntax-errors] Unparenthesized assignment expressions in sets and indexes (#16404)
Bug fixes
- Server: Allow
FixAllaction in presence of version-specific syntax errors (#16848) - [
flake8-bandit] Allow raw strings insuspicious-mark-safe-usage(S308) #16702 (#16770) - [
refurb] Avoid panickingunwrapinverbose-decimal-constructor(FURB157) (#16777) - [
refurb] Fix starred expressions fix (FURB161) (#16550) - Fix
--statisticsreporting for unsafe fixes (#16756)
Rule changes
- [
flake8-executables] Allowuv runin shebang line forshebang-missing-python(EXE003) (#16849,#16855)
CLI
- Add
--exit-non-zero-on-format(#16009)
Documentation
- Update Ruff tutorial to avoid non-existent fix in
__init__.py(#16818) - [
flake8-gettext] Swapformat-andprintf-in-get-text-func-callexamples (INT002,INT003) (#16769)
Contributors
- @AlexWaygood
- @BurntSushi
- @InSyncWithFoo
- @MatthewMckee4
- @MichaReiser
- @VascoSch92
- @ZedThree
- @cake-monotone
- @carljm
- @charliermarsh
- @dcreager
- @dhruvmanila
- @dylwil3
- @github-actions
- @junhsonjb
- @kaxil
- @mfontanaar
- @ntBre
- @renovate
- @sharkdp
- @thejcannon
- @zanieb
Install ruff 0.11.1
Install prebuilt binaries via shell script
curl --proto '=https' --tlsv1.2 -LsSf https://github.com/astral-sh/ruff/releases/download/0.11.1/ruff-installer.sh | shInstall prebuilt binaries via powershell script
powershell -ExecutionPolicy ByPass -c "irm https://github.com/astral-sh/ruff/releases/download/0.11.1/ruff-installer.ps1 | iex"Download ruff 0.11.1
0.11.0
Release Notes
This is a follow-up to release 0.10.0. The requires-python inference changes were unintentionally omitted from 0.10.0, and have been included here. This release also includes stabilization of the preview behavior for PGH004.
Breaking changes
-
Changes to how the Python version is inferred when a
target-versionis not specified (#16319)In previous versions of Ruff, you could specify your Python version with:
- The
target-versionoption in aruff.tomlfile or the[tool.ruff]section of a pyproject.toml file. - The
project.requires-pythonfield in apyproject.tomlfile with a[tool.ruff]section.
These options worked well in most cases, and are still recommended for fine control of the Python version. However, because of the way Ruff discovers config files,
pyproject.tomlfiles without a[tool.ruff]section would be ignored, including therequires-pythonsetting. Ruff would then use the default Python version (3.9 as of this writing) instead, which is surprising when you've attempted to request another version.In v0.10, config discovery has been updated to address this issue:
- If Ruff finds a
ruff.tomlfile without atarget-version, it will check
for apyproject.tomlfile in the same directory and respect its
requires-pythonversion, even if it does not contain a[tool.ruff]
section. - If Ruff finds a user-level configuration, the
requires-pythonfield of the closestpyproject.tomlin a parent directory will take precedence. - If there is no config file (
ruff.tomlorpyproject.tomlwith a
[tool.ruff]section) in the directory of the file being checked, Ruff will
search for the closestpyproject.tomlin the parent directories and use its
requires-pythonsetting.
- The
Stabilization
The following behaviors have been stabilized:
blanket-noqa(PGH004): Also detect blanked file-level noqa comments (and not just line level comments).
Preview features
- [syntax-errors] Tuple unpacking in
forstatement iterator clause before Python 3.9 (#16558)
Install ruff 0.11.0
Install prebuilt binaries via shell script
curl --proto '=https' --tlsv1.2 -LsSf https://github.com/astral-sh/ruff/releases/download/0.11.0/ruff-installer.sh | shInstall prebuilt binaries via powershell script
powershell -ExecutionPolicy ByPass -c "irm https://github.com/astral-sh/ruff/releases/download/0.11.0/ruff-installer.ps1 | iex"Download ruff 0.11.0
0.10.0
Release Notes
Check out the blog post for a migration guide and overview of the changes!
Breaking changes
See also, the "Remapped rules" section which may result in disabled rules.
-
Changes to how the Python version is inferred when a
target-versionis not specified (#16319)While this change was intended to be released in 0.10.0, it was unintentionally omitted. It was subsequently released in 0.11.0 — see the changelog there for details.
-
Updated
TYPE_CHECKINGbehavior (#16669)Previously, Ruff only recognized typechecking blocks that tested the
typing.TYPE_CHECKINGsymbol. Now, Ruff recognizes any local variable namedTYPE_CHECKING. This release also removes support for the legacyif 0:andif False:typechecking checks. Use a localTYPE_CHECKINGvariable instead. -
More robust noqa parsing (#16483)
The syntax for both file-level and in-line suppression comments has been unified and made more robust to certain errors. In most cases, this will result in more suppression comments being read by Ruff, but there are a few instances where previously read comments will now log an error to the user instead. Please refer to the documentation on Error suppression for the full specification.
-
Avoid unnecessary parentheses around with statements with a single context manager and a trailing comment (#14005)
This change fixes a bug in the formatter where it introduced unnecessary parentheses around with statements with a single context manager and a trailing comment. This change may result in a change in formatting for some users.
-
Bump alpine default tag to 3.21 for derived Docker images (#16456)
Alpine 3.21 was released in Dec 2024 and is used in the official Alpine-based Python images. Now the ruff:alpine image will use 3.21 instead of 3.20 and ruff:alpine3.20 will no longer be updated.
Deprecated Rules
The following rules have been deprecated:
non-pep604-isinstance(UP038)suspicious-xmle-tree-usage(S320)
Remapped rules
The following rules have been remapped to new rule codes:
- [
unsafe-markup-use]:RUF035toS704
Stabilization
The following rules have been stabilized and are no longer in preview:
batched-without-explicit-strict(B911)unnecessary-dict-comprehension-for-iterable(C420)datetime-min-max(DTZ901)fast-api-unused-path-parameter(FAST003)root-logger-call(LOG015)len-test(PLC1802)shallow-copy-environ(PLW1507)os-listdir(PTH208)invalid-pathlib-with-suffix(PTH210)invalid-assert-message-literal-argument(RUF040)unnecessary-nested-literal(RUF041)unnecessary-cast-to-int(RUF046)map-int-version-parsing(RUF048)if-key-in-dict-del(RUF051)unsafe-markup-use(S704). This rule has also been renamed fromRUF035.split-static-string(SIM905)runtime-cast-value(TC006)unquoted-type-alias(TC007)non-pep646-unpack(UP044)
The following behaviors have been stabilized:
bad-staticmethod-argument(PLW0211)invalid-first-argument-name-for-class-method(N804):__new__methods are now no longer flagged byinvalid-first-argument-name-for-class-method(N804) but instead bybad-staticmethod-argument(PLW0211)bad-str-strip-call(PLE1310): The rule now applies to objects which are known to have typestrorbytes.custom-type-var-for-self(PYI019): More accurate detection of customTypeVarsreplaceable bySelf. The range of the diagnostic is now the full function header rather than just the return annotation.invalid-argument-name(N803): Ignore argument names of functions decorated withtyping.overrideinvalid-envvar-default(PLW1508): Detect default value arguments toos.environ.getwith invalid type.pytest-raises-with-multiple-statements(PT012)pytest-warns-with-multiple-statements(PT031): Allowforstatements with an empty body inpytest.raisesandpytest.warnswithstatements.redundant-open-modes(UP015): The diagnostic range is now the range of the redundant mode argument where it previously was the range of the entire open call. You may have to replace yournoqacomments when suppressingUP015.stdlib-module-shadowing(A005): Changes the default value oflint.flake8-builtins.strict-checkingfromtruetofalse.type-none-comparison(FURB169): Now also recognizestype(expr) is type(None)comparisons whereexprisn't a name expression.
The following fixes or improvements to fixes have been stabilized:
repeated-equality-comparison(PLR1714) (#16685)needless-bool(SIM103) (#16684)unused-private-type-var(PYI018) (#16682)
Server
- Remove logging output for
ruff.printDebugInformation(#16617)
Configuration
- [
flake8-builtins] Deprecate thebuiltins-prefixed options in favor of the unprefixed options (e.g.builtins-allowed-modulesis now deprecated in favor ofallowed-modules) (#16092)
Bug fixes
- [flake8-bandit] Fix mixed-case hash algorithm names (S324) (#16552)
CLI
- [
ruff] Fixlast_tag/commits_since_last_tagforversioncommand (#16686)
Contributors
- @AlexWaygood
- @Glyphack
- @InSyncWithFoo
- @MichaReiser
- @VascoSch92
- @ZedThree
- @carljm
- @dcreager
- @dhruvmanila
- @dylwil3
- @ericmarkmartin
- @jgeralnik
- @mtshiba
- @ntBre
- @sharkdp
Install ruff 0.10.0
Install prebuilt binaries via shell script
curl --proto '=https' --tlsv1.2 -LsSf https://github.com/astral-sh/ruff/releases/download/0.10.0/ruff-installer.sh | shInstall prebuilt binaries via powershell script
powershell -ExecutionPolicy ByPass -c "irm https://github.com/astral-sh/ruff/releases/download/0.10.0/ruff-installer.ps1 | iex"Download ruff 0.10.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-... |
0.9.10
Release Notes
Preview features
- [
ruff] Add new ruleRUF059: Unused unpacked assignment (#16449) - [
syntax-errors] Detect assignment expressions before Python 3.8 (#16383) - [
syntax-errors] Named expressions in decorators before Python 3.9 (#16386) - [
syntax-errors] Parenthesized keyword argument names after Python 3.8 (#16482) - [
syntax-errors] Positional-only parameters before Python 3.8 (#16481) - [
syntax-errors] Tuple unpacking inreturnandyieldbefore Python 3.8 (#16485) - [
syntax-errors] Type parameter defaults before Python 3.13 (#16447) - [
syntax-errors] Type parameter lists before Python 3.12 (#16479) - [
syntax-errors]except*before Python 3.11 (#16446) - [
syntax-errors]typestatements before Python 3.12 (#16478)
Bug fixes
- Escape template filenames in glob patterns in configuration (#16407)
- [
flake8-simplify] Exempt unittest context methods forSIM115rule (#16439) - Formatter: Fix syntax error location in notebooks (#16499)
- [
pyupgrade] Do not offer fix when at least one target isglobal/nonlocal(UP028) (#16451) - [
flake8-builtins] Ignore variables matching module attribute names (A001) (#16454) - [
pylint] Convertcodekeyword argument to a positional argument in fix for (PLR1722) (#16424)
CLI
- Move rule code from
descriptiontocheck_namein GitLab output serializer (#16437)
Documentation
- [
pydocstyle] Clarify thatD417only checks docstrings with an arguments section (#16494)
Contributors
- @AlexWaygood
- @BurntSushi
- @Glyphack
- @InSyncWithFoo
- @JelleZijlstra
- @MichaReiser
- @VascoSch92
- @adamchainz
- @carljm
- @charliermarsh
- @dcreager
- @dhruvmanila
- @ericmarkmartin
- @github-actions
- @mishamsk
- @mtshiba
- @ntBre
- @renovate
- @sharkdp
Install ruff 0.9.10
Install prebuilt binaries via shell script
curl --proto '=https' --tlsv1.2 -LsSf https://github.com/astral-sh/ruff/releases/download/0.9.10/ruff-installer.sh | shInstall prebuilt binaries via powershell script
powershell -ExecutionPolicy ByPass -c "irm https://github.com/astral-sh/ruff/releases/download/0.9.10/ruff-installer.ps1 | iex"Download ruff 0.9.10
0.9.9
Release Notes
Preview features
- Fix caching of unsupported-syntax errors (#16425)
Bug fixes
- Only show unsupported-syntax errors in editors when preview mode is enabled (#16429)
Contributors
Install ruff 0.9.9
Install prebuilt binaries via shell script
curl --proto '=https' --tlsv1.2 -LsSf https://github.com/astral-sh/ruff/releases/download/0.9.9/ruff-installer.sh | shInstall prebuilt binaries via powershell script
powershell -ExecutionPolicy ByPass -c "irm https://github.com/astral-sh/ruff/releases/download/0.9.9/ruff-installer.ps1 | iex"Download ruff 0.9.9
0.9.8
Release Notes
Preview features
- Start detecting version-related syntax errors in the parser (#16090)
Rule changes
- [
pylint] Mark fix unsafe (PLW1507) (#16343) - [
pylint] Catchcase np.nan/case math.naninmatchstatements (PLW0177) (#16378) - [
ruff] Add more Pydantic models variants to the list of default copy semantics (RUF012) (#16291)
Server
- Avoid indexing the project if
configurationPreferenceiseditorOnly(#16381) - Avoid unnecessary info at non-trace server log level (#16389)
- Expand
ruff.configurationto allow inline config (#16296) - Notify users for invalid client settings (#16361)
Configuration
- Add
per-file-target-versionoption (#16257)
Bug fixes
- [
refurb] Do not consider docstring(s) (FURB156) (#16391) - [
flake8-self] Ignore attribute accesses on instance-like variables (SLF001) (#16149) - [
pylint] Fix false positives, add missing methods, and support positional-only parameters (PLE0302) (#16263) - [
flake8-pyi] MarkPYI030fix unsafe when comments are deleted (#16322)
Documentation
- Fix example for
S611(#16316) - Normalize inconsistent markdown headings in docstrings (#16364)
- Document MSRV policy (#16384)
Contributors
- @AlexWaygood
- @BurntSushi
- @CNSeniorious000
- @InSyncWithFoo
- @MichaReiser
- @VascoSch92
- @Viicos
- @aripollak
- @carljm
- @dcarrier
- @dcreager
- @dhruvmanila
- @mishamsk
- @ntBre
- @renovate
- @sharkdp
- @zanieb
Install ruff 0.9.8
Install prebuilt binaries via shell script
curl --proto '=https' --tlsv1.2 -LsSf https://github.com/astral-sh/ruff/releases/download/0.9.8/ruff-installer.sh | shInstall prebuilt binaries via powershell script
powershell -ExecutionPolicy ByPass -c "irm https://github.com/astral-sh/ruff/releases/download/0.9.8/ruff-installer.ps1 | iex"Download ruff 0.9.8
0.9.7
Release Notes
Preview features
- Consider
__new__methods as special function type for enforcing class method or static method rules (#13305) - [
airflow] Improve the internal logic to differentiate deprecated symbols (AIR303) (#16013) - [
refurb] Manual timezone monkeypatching (FURB162) (#16113) - [
ruff] Implicit class variable in dataclass (RUF045) (#14349) - [
ruff] Skip singleton starred expressions forincorrectly-parenthesized-tuple-in-subscript(RUF031) (#16083) - [
refurb] Check for subclasses includes subscript expressions (FURB189) (#16155)
Rule changes
- [
flake8-debugger] Also flagsys.breakpointhookandsys.__breakpointhook__(T100) (#16191) - [
pycodestyle] Exemptsite.addsitedir(...)calls (E402) (#16251)
Formatter
- Fix unstable formatting of trailing end-of-line comments of parenthesized attribute values (#16187)
Server
- Fix handling of requests received after shutdown message (#16262)
- Ignore
source.organizeImports.ruffandsource.fixAll.ruffcode actions for a notebook cell (#16154) - Include document specific debug info for
ruff.printDebugInformation(#16215) - Update server to return the debug info as string with
ruff.printDebugInformation(#16214)
CLI
- Warn on invalid
noqaeven when there are no diagnostics (#16178) - Better error messages while loading configuration
extends (#15658)
Bug fixes
- [
flake8-comprehensions] Handle trailing comma inC403fix (#16110) - [
flake8-pyi] Avoid flaggingcustom-typevar-for-selfon metaclass methods (PYI019) (#16141) - [
pydocstyle] Handle arguments with the same names as sections (D417) (#16011) - [
pylint] Correct ordering of arguments in fix forif-stmt-min-max(PLR1730) (#16080) - [
pylint] Do not offer fix for raw strings (PLE251) (#16132) - [
pyupgrade] Do not upgrade functionalTypedDictswith private field names to the class-based syntax (UP013) (#16219) - [
pyupgrade] Handle micro version numbers correctly (UP036) (#16091) - [
pyupgrade] Unwrap unary expressions correctly (UP018) (#15919) - [
refurb] Correctly handle lengths of literal strings inslice-to-remove-prefix-or-suffix(FURB188) (#16237) - [
ruff] SkipRUF001diagnostics when visiting string type definitions (#16122)
Documentation
Contributors
- @AlexWaygood
- @BurntSushi
- @Glyphack
- @InSyncWithFoo
- @Lee-W
- @MichaReiser
- @Skylion007
- @VascoSch92
- @ayushbaweja
- @cake-monotone
- @carljm
- @dcreager
- @dhruvmanila
- @dylwil3
- @github-actions
- @ibraheemdev
- @junhsonjb
- @ntBre
- @purajit
- @renovate
- @sharkdp
- @sobolevn
- @vladNed
Install ruff 0.9.7
Install prebuilt binaries via shell script
curl --proto '=https' --tlsv1.2 -LsSf https://github.com/astral-sh/ruff/releases/download/0.9.7/ruff-installer.sh | shInstall prebuilt binaries via powershell script
powershell -ExecutionPolicy ByPass -c "irm https://github.com/astral-sh/ruff/releases/download/0.9.7/ruff-installer.ps1 | iex"