Releases: astral-sh/ruff
Releases · astral-sh/ruff
0.9.1
Release Notes
Preview features
- [
pycodestyle] Runtoo-many-newlines-at-end-of-fileon each cell in notebooks (W391) (#15308) - [
ruff] Omit diagnostic for shadowed private function parameters inused-dummy-variable(RUF052) (#15376)
Rule changes
- [
flake8-bugbear] Improveassert-raises-exceptionmessage (B017) (#15389)
Formatter
- Preserve trailing end-of line comments for the last string literal in implicitly concatenated strings (#15378)
Server
- Fix a bug where the server and client notebooks were out of sync after reordering cells (#15398)
Bug fixes
- [
flake8-pie] Correctly remove wrapping parentheses (PIE800) (#15394) - [
pyupgrade] Handle comments and multiline expressions correctly (UP037) (#15337)
Contributors
Install ruff 0.9.1
Install prebuilt binaries via shell script
curl --proto '=https' --tlsv1.2 -LsSf https://github.com/astral-sh/ruff/releases/download/0.9.1/ruff-installer.sh | shInstall prebuilt binaries via powershell script
powershell -ExecutionPolicy ByPass -c "irm https://github.com/astral-sh/ruff/releases/download/0.9.1/ruff-installer.ps1 | iex"Download ruff 0.9.1
0.9.0
Release Notes
Check out the blog post for a migration guide and overview of the changes!
Breaking changes
Ruff now formats your code according to the 2025 style guide. As a result, your code might now get formatted differently. See the formatter section for a detailed list of changes.
This release doesn’t remove or remap any existing stable rules.
Stabilization
The following rules have been stabilized and are no longer in preview:
stdlib-module-shadowing(A005).
This rule has also been renamed: previously, it was calledbuiltin-module-shadowing.builtin-lambda-argument-shadowing(A006)slice-to-remove-prefix-or-suffix(FURB188)boolean-chained-comparison(PLR1716)decimal-from-float-literal(RUF032)post-init-default(RUF033)useless-if-else(RUF034)
The following behaviors have been stabilized:
pytest-parametrize-names-wrong-type(PT006): Detectpytest.parametrizecalls outside decorators and calls with keyword arguments.module-import-not-at-top-of-file(E402): Ignorepytest.importorskipcalls between import statements.mutable-dataclass-default(RUF008) andfunction-call-in-dataclass-default-argument(RUF009): Add support forattrs.bad-version-info-comparison(PYI006): Extend the rule to check non-stub files.
The following fixes or improvements to fixes have been stabilized:
redundant-numeric-union(PYI041)duplicate-union-members(PYI016)
Formatter
This release introduces the new 2025 stable style (#13371), stabilizing the following changes:
- Format expressions in f-string elements (#7594)
- Alternate quotes for strings inside f-strings (#13860)
- Preserve the casing of hex codes in f-string debug expressions (#14766)
- Choose the quote style for each string literal in an implicitly concatenated f-string rather than for the entire string (#13539)
- Automatically join an implicitly concatenated string into a single string literal if it fits on a single line (#9457)
- Remove the
ISC001incompatibility warning (#15123) - Prefer parenthesizing the
assertmessage over breaking the assertion expression (#9457) - Automatically parenthesize over-long
ifguards inmatchcaseclauses (#13513) - More consistent formatting for
matchcasepatterns (#6933) - Avoid unnecessary parentheses around return type annotations (#13381)
- Keep the opening parentheses on the same line as the
ifkeyword for comprehensions where the condition has a leading comment (#12282) - More consistent formatting for
withstatements with a single context manager for Python 3.8 or older (#10276) - Correctly calculate the line-width for code blocks in docstrings when using
max-doc-code-line-length = "dynamic"(#13523)
Preview features
- [
flake8-bugbear] Implementclass-as-data-structure(B903) (#9601) - [
flake8-type-checking] Applyquoted-type-aliasmore eagerly inTYPE_CHECKINGblocks and ignore it in stubs (TC008) (#15180) - [
pylint] Ignoreeq-without-hashin stub files (PLW1641) (#15310) - [
pyupgrade] SplitUP007into two individual rules:UP007forUnionandUP045forOptional(UP007,UP045) (#15313) - [
ruff] New rule that detects classes that are both an enum and adataclass(RUF049) (#15299) - [
ruff] RecodeRUF025toRUF037(RUF037) (#15258)
Rule changes
- [
flake8-builtins] Ignorestdlib-module-shadowingin stub files(A005) (#15350) - [
flake8-return] Add support for functions returningtyping.Never(RET503) (#15298)
Server
- Improve the observability by removing the need for the "trace" value to turn on or off logging. The server logging is solely controlled using the
logLevelserver setting
which defaults toinfo. This addresses the issue where users were notified about an error and told to consult the log, but it didn’t contain any messages. (#15232) - Ignore diagnostics from other sources for code action requests (#15373)
CLI
- Improve the error message for
--config key=valuewhen thekeyis for a table and it’s a simplevalue
Bug fixes
- [
eradicate] Ignore metadata blocks directly followed by normal blocks (ERA001) (#15330) - [
flake8-django] Recognize other magic methods (DJ012) (#15365) - [
pycodestyle] Avoid false positives related to type aliases (E252) (#15356) - [
pydocstyle] Avoid treating newline-separated sections as sub-sections (D405) (#15311) - [
pyflakes] Remove call when removing final argument fromformat(F523) (#15309) - [
refurb] Mark fix as unsafe when the right-hand side is a string (FURB171) (#15273) - [
ruff] Treat)as a regex metacharacter (RUF043,RUF055) (#15318) - [
ruff] Parenthesize theint-call argument when removing theintcall would change semantics (RUF046) (#15277)
Contributors
- @AlexWaygood
- @Avasam
- @Daverball
- @Glyphack
- @InSyncWithFoo
- @MichaReiser
- @augustelalande
- @carljm
- @charliermarsh
- @dcreager
- @dhruvmanila
- @diceroll123
- @dylwil3
- @eclbg
- @rtpg
- @sharkdp
- @viccie30
Install ruff 0.9.0
Install prebuilt binaries via shell script
curl --proto '=https' --tlsv1.2 -LsSf https://github.com/astral-sh/ruff/releases/download/0.9.0/ruff-installer.sh | shInstall prebuilt binaries via powershell script
powershell -ExecutionPolicy ByPass -c "irm https://github.com/astral-sh/ruff/releases/download/0.9.0/ruff-installer.ps1 | iex"Download ruff 0.9.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](https://github.com/astral-sh/ruff/releases/downlo... |
0.8.6
Release Notes
Preview features
- [
format]: Preserve multiline implicit concatenated strings in docstring positions (#15126) - [
ruff] Add rule to detect empty literal in deque call (RUF025) (#15104) - [
ruff] Avoid reporting whenndigitsis possibly negative (RUF057) (#15234)
Rule changes
- [
flake8-todos] remove issue code length restriction (TD003) (#15175) - [
pyflakes] Ignore errors in@no_type_checkstring annotations (F722,F821) (#15215)
CLI
- Show errors for attempted fixes only when passed
--verbose(#15237)
Bug fixes
- [
ruff] Avoid syntax error when removing int over multiple lines (RUF046) (#15230) - [
pyupgrade] Revert "Add all PEP-585 names toUP006rule" (#15250)
Contributors
- @AlexWaygood
- @InSyncWithFoo
- @Lee-W
- @MichaReiser
- @augustelalande
- @charliermarsh
- @dcreager
- @dylwil3
- @mdbernard
- @sharkdp
- @w0nder1ng
Install ruff 0.8.6
Install prebuilt binaries via shell script
curl --proto '=https' --tlsv1.2 -LsSf https://github.com/astral-sh/ruff/releases/download/0.8.6/ruff-installer.sh | shInstall prebuilt binaries via powershell script
powershell -ExecutionPolicy ByPass -c "irm https://github.com/astral-sh/ruff/releases/download/0.8.6/ruff-installer.ps1 | iex"Download ruff 0.8.6
0.8.5
Release Notes
Preview features
- [
airflow] Extend names moved from core to provider (AIR303) (#15145, #15159, #15196, #15216) - [
airflow] Extend rule to check class attributes, methods, arguments (AIR302) (#15054, #15083) - [
fastapi] UpdateFAST002to check keyword-only arguments (#15119) - [
flake8-type-checking] DisableTC006andTC007in stub files (#15179) - [
pylint] Detect nested methods correctly (PLW1641) (#15032) - [
ruff] Detect more strict-integer expressions (RUF046) (#14833) - [
ruff] Implementfalsy-dict-get-fallback(RUF056) (#15160) - [
ruff] Implementunnecessary-round(RUF057) (#14828)
Rule changes
- Visit PEP 764 inline
TypedDictkeys as non-type-expressions (#15073) - [
flake8-comprehensions] SkipC416if comprehension contains unpacking (#14909) - [
flake8-pie] Allowcast(SomeType, ...)(PIE796) (#15141) - [
flake8-simplify] More precise inference for dictionaries (SIM300) (#15164) - [
flake8-use-pathlib] Catch redundant joins inPTH201and avoid syntax errors (#15177) - [
pycodestyle] Preserve original value format (E731) (#15097) - [
pydocstyle] Split on first whitespace character (D403) (#15082) - [
pyupgrade] Add all PEP-585 names toUP006rule (#5454)
Configuration
- [
flake8-type-checking] Improve flexibility ofruntime-evaluated-decorators(#15204) - [
pydocstyle] Add setting to ignore missing documentation for*argsand**kwargsparameters (D417) (#15210) - [
ruff] Add an allowlist forunsafe-markup-use(RUF035) (#15076)
Bug fixes
- Fix type subscript on older python versions (#15090)
- Use
TypeCheckerfor detectingfastapiroutes (#15093) - [
pycodestyle] Avoid false positives and negatives related to type parameter default syntax (E225,E251) (#15214)
Documentation
- Fix incorrect doc in
shebang-not-executable(EXE001) and add git+windows solution to executable bit (#15208) - Rename rules currently not conforming to naming convention (#15102)
Contributors
- @AlexWaygood
- @Avasam
- @Daverball
- @InSyncWithFoo
- @KotlinIsland
- @Lee-W
- @MichaReiser
- @TomerBin
- @Viicos
- @aaron-skydio
- @cclauss
- @dhruvmanila
- @dylwil3
- @enochkan
- @github-actions
- @guptaarnav
- @harupy
- @hauntsaninja
- @my1e5
- @purajit
- @renovate
- @sharkdp
- @sobolevn
- @wookie184
Install ruff 0.8.5
Install prebuilt binaries via shell script
curl --proto '=https' --tlsv1.2 -LsSf https://github.com/astral-sh/ruff/releases/download/0.8.5/ruff-installer.sh | shInstall prebuilt binaries via powershell script
powershell -ExecutionPolicy ByPass -c "irm https://github.com/astral-sh/ruff/releases/download/0.8.5/ruff-installer.ps1 | iex"Download ruff 0.8.5
0.8.4
Release Notes
Preview features
- [
airflow] ExtendAIR302with additional functions and classes (#15015) - [
airflow] Implementmoved-to-provider-in-3for modules that has been moved to Airflow providers (AIR303) (#14764) - [
flake8-use-pathlib] Extend check for invalid path suffix to include the case"."(PTH210) (#14902) - [
perflint] Fix panic inPERF401when list variable is after theforloop (#14971) - [
perflint] Simplify finding the loop target inPERF401(#15025) - [
pylint] Preserve original value format (PLR6104) (#14978) - [
ruff] Avoid false positives forRUF027for typing context bindings (#15037) - [
ruff] Check for ambiguous pattern passed topytest.raises()(RUF043) (#14966)
Rule changes
- [
flake8-bandit] CheckS105for annotated assignment (#15059) - [
flake8-pyi] More autofixes forredundant-none-literal(PYI061) (#14872) - [
pydocstyle] Skip leading whitespace forD403(#14963) - [
ruff] SkipSQLModelbase classes formutable-class-default(RUF012) (#14949)
Bug
- [
perflint] Parenthesize walrus expressions in autofix formanual-list-comprehension(PERF401) (#15050)
Server
- Check diagnostic refresh support from client capability which enables dynamic configuration for various editors (#15014)
Contributors
- @AlexWaygood
- @Daverball
- @DimitriPapadopoulos
- @InSyncWithFoo
- @Lee-W
- @MichaReiser
- @TheBits
- @cake-monotone
- @carljm
- @dcreager
- @dhruvmanila
- @dylwil3
- @github-actions
- @kiran-4444
- @krishnan-chandra
- @rchen152
- @renovate
- @sharkdp
- @tarasmatsyk
- @w0nder1ng
Install ruff 0.8.4
Install prebuilt binaries via shell script
curl --proto '=https' --tlsv1.2 -LsSf https://github.com/astral-sh/ruff/releases/download/0.8.4/ruff-installer.sh | shInstall prebuilt binaries via powershell script
powershell -ExecutionPolicy ByPass -c "irm https://github.com/astral-sh/ruff/releases/download/0.8.4/ruff-installer.ps1 | iex"Download ruff 0.8.4
0.8.3
Release Notes
Preview features
- Fix fstring formatting removing overlong implicit concatenated string in expression part (#14811)
- [
airflow] Add fix to remove deprecated keyword arguments (AIR302) (#14887) - [
airflow]: Extend rule to include deprecated names for Airflow 3.0 (AIR302) (#14765 and #14804) - [
flake8-bugbear] Improve error messages forexcept*(B025,B029,B030,B904) (#14815) - [
flake8-bugbear]itertools.batched()without explicitstrict(B911) (#14408) - [
flake8-use-pathlib] Dotless suffix passed toPath.with_suffix()(PTH210) (#14779) - [
pylint] Include parentheses and multiple comparators in check forboolean-chained-comparison(PLR1716) (#14781) - [
ruff] Do not simplifyround()calls (RUF046) (#14832) - [
ruff] Don't emitused-dummy-variableon function parameters (RUF052) (#14818) - [
ruff] Implementif-key-in-dict-del(RUF051) (#14553) - [
ruff] Mark autofix forRUF052as always unsafe (#14824) - [
ruff] Teach autofix forused-dummy-variableabout TypeVars etc. (RUF052) (#14819)
Rule changes
- [
flake8-bugbear] Offer unsafe autofix forno-explicit-stacklevel(B028) (#14829) - [
flake8-pyi] Skip all type definitions instring-or-bytes-too-long(PYI053) (#14797) - [
pyupgrade] Do not report when a UTF-8 comment is followed by a non-UTF-8 one (UP009) (#14728) - [
pyupgrade] Mark fixes forconvert-typed-dict-functional-to-classandconvert-named-tuple-functional-to-classas unsafe if they will remove comments (UP013,UP014) (#14842)
Bug fixes
- Raise syntax error for mixing
exceptandexcept*(#14895) - [
flake8-bugbear] FixB028to allowstacklevelto be explicitly assigned as a positional argument (#14868) - [
flake8-bugbear] SkipB028ifwarnings.warnis called with*argsor**kwargs(#14870) - [
flake8-comprehensions] Skip iterables with named expressions inunnecessary-map(C417) (#14827) - [
flake8-pyi] Also removeselfandcls's annotation (PYI034) (#14801) - [
flake8-pytest-style] Fixpytest-parametrize-names-wrong-type(PT006) to edit bothargnamesandargvaluesif both of them are single-element tuples/lists (#14699) - [
perflint] Improve autofix forPERF401(#14369) - [
pylint] FixPLW1508false positive for default string created via a mult operation (#14841)
Contributors
- @AlexWaygood
- @BurntSushi
- @DimitriPapadopoulos
- @Glyphack
- @InSyncWithFoo
- @Lee-W
- @MichaReiser
- @UnknownPlatypus
- @carljm
- @cclauss
- @dcreager
- @dhruvmanila
- @dylwil3
- @harupy
- @mitya57
- @notpeter
- @ognevny
- @renovate
- @sharkdp
- @smokyabdulrahman
- @tirkarthi
- @w0nder1ng
Install ruff 0.8.3
Install prebuilt binaries via shell script
curl --proto '=https' --tlsv1.2 -LsSf https://github.com/astral-sh/ruff/releases/download/0.8.3/ruff-installer.sh | shInstall prebuilt binaries via powershell script
powershell -ExecutionPolicy ByPass -c "irm https://github.com/astral-sh/ruff/releases/download/0.8.3/ruff-installer.ps1 | iex"Download ruff 0.8.3
0.8.2
Release Notes
Preview features
- [
airflow] Avoid deprecated values (AIR302) (#14582) - [
airflow] Extend removed names forAIR302(#14734) - [
ruff] Extendunnecessary-regular-expressionto non-literal strings (RUF055) (#14679) - [
ruff] Implementused-dummy-variable(RUF052) (#14611) - [
ruff] Implementunnecessary-cast-to-int(RUF046) (#14697)
Rule changes
- [
airflow] CheckAIR001from builtin or providersoperatorsmodule (#14631) - [
flake8-pytest-style] Remove@inpytest.mark.parametrizerule messages (#14770) - [
pandas-vet] Skip rules if thepandamodule hasn't been seen (#14671) - [
pylint] Fix false negatives forasciiandsortedinlen-as-condition(PLC1802) (#14692) - [
refurb] Guardhashlibimports and markhashlib-digest-hexfix as safe (FURB181) (#14694)
Configuration
- [
flake8-import-conventions] Improve syntax check for aliases supplied in configuration forunconventional-import-alias(ICN001) (#14745)
Bug fixes
- Revert: [pyflakes] Avoid false positives in
@no_type_checkcontexts (F821,F722) (#14615) (#14726) - [
pep8-naming] Avoid false positive forclass Bar(type(foo))(N804) (#14683) - [
pycodestyle] Handle f-strings properly forinvalid-escape-sequence(W605) (#14748) - [
pylint] Ignore@overloadinPLR0904(#14730) - [
refurb] Handle non-finite decimals inverbose-decimal-constructor(FURB157) (#14596) - [
ruff] Avoid emittingassignment-in-assertwhen all references to the assigned variable are themselves insideasserts (RUF018) (#14661)
Documentation
- Improve docs for
flake8-use-pathlibrules (#14741) - Improve error messages and docs for
flake8-comprehensionsrules (#14729) - [
flake8-type-checking] ExpandsTC006docs to better explain itself (#14749)
Contributors
- @AlexWaygood
- @Daverball
- @InSyncWithFoo
- @Lee-W
- @Lokejoke
- @Matt-Ord
- @MichaReiser
- @Well2333
- @connorskees
- @dcreager
- @dhruvmanila
- @dylwil3
- @github-actions
- @harupy
- @ntBre
- @renovate
- @sbrugman
- @sharkdp
- @uranusjr
Install ruff 0.8.2
Install prebuilt binaries via shell script
curl --proto '=https' --tlsv1.2 -LsSf https://github.com/astral-sh/ruff/releases/download/0.8.2/ruff-installer.sh | shInstall prebuilt binaries via powershell script
powershell -ExecutionPolicy ByPass -c "irm https://github.com/astral-sh/ruff/releases/download/0.8.2/ruff-installer.ps1 | iex"Download ruff 0.8.2
0.8.1
Release Notes
Preview features
- Formatter: Avoid invalid syntax for format-spec with quotes for all Python versions (#14625)
- Formatter: Consider quotes inside format-specs when choosing the quotes for an f-string (#14493)
- Formatter: Do not consider f-strings with escaped newlines as multiline (#14624)
- Formatter: Fix f-string formatting in assignment statement (#14454)
- Formatter: Fix unnecessary space around power operator (
**) in overlong f-string expressions (#14489) - [
airflow] Avoid implicitscheduleargument toDAGand@dag(AIR301) (#14581) - [
flake8-builtins] Exempt private built-in modules (A005) (#14505) - [
flake8-pytest-style] Fixpytest.mark.parametrizerules to check calls instead of decorators (#14515) - [
flake8-type-checking] Implementruntime-cast-value(TC006) (#14511) - [
flake8-type-checking] Implementunquoted-type-alias(TC007) andquoted-type-alias(TC008) (#12927) - [
flake8-use-pathlib] RecommendPath.iterdir()overos.listdir()(PTH208) (#14509) - [
pylint] Extendinvalid-envvar-defaultto detectos.environ.get(PLW1508) (#14512) - [
pylint] Implementlen-test(PLC1802) (#14309) - [
refurb] Fix bug where methods defined using lambdas were flagged byFURB118(#14639) - [
ruff] Auto-addrprefix when string has no backslashes forunraw-re-pattern(RUF039) (#14536) - [
ruff] Implementinvalid-assert-message-literal-argument(RUF040) (#14488) - [
ruff] Implementunnecessary-nested-literal(RUF041) (#14323) - [
ruff] Implementunnecessary-regular-expression(RUF055) (#14659)
Rule changes
- Ignore more rules for stub files (#14541)
- [
pep8-naming] Eliminate false positives for single-letter names (N811,N814) (#14584) - [
pyflakes] Avoid false positives in@no_type_checkcontexts (F821,F722) (#14615) - [
ruff] Detect redirected-noqa in file-level comments (RUF101) (#14635) - [
ruff] Mark fixes forunsorted-dunder-allandunsorted-dunder-slotsas unsafe when there are complex comments in the sequence (RUF022,RUF023) (#14560)
Bug fixes
- Avoid fixing code to
None | Noneforredundant-none-literal(PYI061) andnever-union(RUF020) (#14583, #14589) - [
flake8-bugbear] Fixmutable-contextvar-defaultto resolve annotated function calls properly (B039) (#14532) - [
flake8-pyi,ruff] Fix traversal of nested literals and unions (PYI016,PYI051,PYI055,PYI062,RUF041) (#14641) - [
flake8-pyi] Avoid rewriting invalid type expressions inunnecessary-type-union(PYI055) (#14660) - [
flake8-type-checking] Avoid syntax errors and type checking problem for quoted annotations autofix (TC003,TC006) (#14634) - [
pylint] Do not wrap function calls in parentheses in the fix for unnecessary-dunder-call (PLC2801) (#14601) - [
ruff] Handleattrs'sauto_attribscorrectly (RUF009) (#14520)
Contributors
- @AlexWaygood
- @Daverball
- @Glyphack
- @InSyncWithFoo
- @Lokejoke
- @MichaReiser
- @cake-monotone
- @carljm
- @charliermarsh
- @connorskees
- @dhruvmanila
- @dylwil3
- @harupy
- @njhearp
- @ntBre
- @renovate
- @sbrugman
- @sharkdp
- @snowdrop4
- @sransara
- @uranusjr
Install ruff 0.8.1
Install prebuilt binaries via shell script
curl --proto '=https' --tlsv1.2 -LsSf https://github.com/astral-sh/ruff/releases/download/0.8.1/ruff-installer.sh | shInstall prebuilt binaries via powershell script
powershell -ExecutionPolicy ByPass -c "irm https://github.com/astral-sh/ruff/releases/download/0.8.1/ruff-installer.ps1 | iex"Download ruff 0.8.1
0.8.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.
-
Default to Python 3.9
Ruff now defaults to Python 3.9 instead of 3.8 if no explicit Python version is configured using
ruff.target-versionorproject.requires-python(#13896) -
Changed location of
pydoclintdiagnosticspydoclintdiagnostics now point to the first-line of the problematic docstring. Previously, this was not the case.If you've opted into these preview rules but have them suppressed using
noqacomments in
some places, this change may mean that you need to move thenoqasuppression
comments. Most users should be unaffected by this change. -
Use XDG (i.e.
~/.local/bin) instead of the Cargo home directory in the standalone installerPreviously, Ruff's installer used
$CARGO_HOMEor~/.cargo/binfor its target install directory. Now, Ruff will be installed into$XDG_BIN_HOME,$XDG_DATA_HOME/../bin, or~/.local/bin(in that order).This change is only relevant to users of the standalone Ruff installer (using the shell or PowerShell script). If you installed Ruff using uv or pip, you should be unaffected.
-
Changes to the line width calculation
Ruff now uses a new version of the unicode-width Rust crate to calculate the line width. In very rare cases, this may lead to lines containing Unicode characters being reformatted, or being considered too long when they were not before (
E501).
Removed Rules
The following deprecated rules have been removed:
missing-type-self(ANN101)missing-type-cls(ANN102)syntax-error(E999)pytest-missing-fixture-name-underscore(PT004)pytest-incorrect-fixture-name-underscore(PT005)unpacked-list-comprehension(UP027)
Remapped rules
The following rules have been remapped to new rule codes:
flake8-type-checking:TCHtoTC
Stabilization
The following rules have been stabilized and are no longer in preview:
builtin-import-shadowing(A004)mutable-contextvar-default(B039)fast-api-redundant-response-model(FAST001)fast-api-non-annotated-dependency(FAST002)dict-index-missing-items(PLC0206)pep484-style-positional-only-parameter(PYI063)redundant-final-literal(PYI064)bad-version-info-order(PYI066)parenthesize-chained-operators(RUF021)unsorted-dunder-all(RUF022)unsorted-dunder-slots(RUF023)assert-with-print-message(RUF030)unnecessary-default-type-args(UP043)
The following behaviors have been stabilized:
ambiguous-variable-name(E741): Violations in stub files are now ignored. Stub authors typically don't control variable names.printf-string-formatting(UP031): Report allprintf-like usages even if no autofix is available
The following fixes have been stabilized:
zip-instead-of-pairwise(RUF007)
Preview features
- [
flake8-datetimez] Exemptmin.time()andmax.time()(DTZ901) (#14394) - [
flake8-pie] Mark fix as unsafe if the following statement is a string literal (PIE790) (#14393) - [
flake8-pyi] New ruleredundant-none-literal(PYI061) (#14316) - [
flake8-pyi] Add autofix forredundant-numeric-union(PYI041) (#14273) - [
ruff] New rulemap-int-version-parsing(RUF048) (#14373) - [
ruff] New ruleredundant-bool-literal(RUF038) (#14319) - [
ruff] New ruleunraw-re-pattern(RUF039) (#14446) - [
pycodestyle] Exemptpytest.importorskip()calls (E402) (#14474) - [
pylint] Autofix suggests using sets when possible (PLR1714) (#14372)
Rule changes
invalid-pyproject-toml(RUF200): Updated to reflect the provisionally accepted PEP 639.- [
flake8-pyi] Avoid panic in unfixable case (PYI041) (#14402) - [
flake8-type-checking] Correctly handle quotes in subscript expression when generating an autofix (#14371) - [
pylint] Suggest correct autofix for__contains__(PLC2801) (#14424)
Configuration
- Ruff now emits a warning instead of an error when a configuration
ignores a rule that has been removed (#14435) - Ruff now validates that
lint.flake8-import-conventions.aliasesonly uses valid module names and aliases (#14477)
Contributors
- @AlexWaygood
- @CarrotManMatt
- @Daverball
- @Glyphack
- @InSyncWithFoo
- @MichaReiser
- @cake-monotone
- @charliermarsh
- @dhruvmanila
- @diceroll123
- @dylwil3
- @hauntsaninja
- @konstin
- @sbrugman
- @sharkdp
- @takaya0
- @tjkuson
- @zanieb
Install ruff 0.8.0
Install prebuilt binaries via shell script
curl --proto '=https' --tlsv1.2 -LsSf https://github.com/astral-sh/ruff/releases/download/0.8.0/ruff-installer.sh | shInstall prebuilt binaries via powershell script
powershell -ExecutionPolicy ByPass -c "irm https://github.com/astral-sh/ruff/releases/download/0.8.0/ruff-installer.ps1 | iex"Download ruff 0.8.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](https://github.com/astral-sh/ruff/releases/download/0.8.0/ruff-aarch64-... |
0.7.4
Release Notes
Preview features
- [
flake8-datetimez] Detect usages ofdatetime.max/datetime.min(DTZ901) (#14288) - [
flake8-logging] Implementroot-logger-calls(LOG015) (#14302) - [
flake8-no-pep420] Detect empty implicit namespace packages (INP001) (#14236) - [
flake8-pyi] Add "replace withSelf" fix (PYI019) (#14238) - [
perflint] Implement quick-fix formanual-list-comprehension(PERF401) (#13919) - [
pylint] Implementshallow-copy-environ(W1507) (#14241) - [
ruff] Implementnone-not-at-end-of-union(RUF036) (#14314) - [
ruff] Implementationunsafe-markup-callfromflake8-markupsafeplugin (RUF035) (#14224) - [
ruff] Report problems forattrsdataclasses (RUF008,RUF009) (#14327)
Rule changes
- [
flake8-boolean-trap] Exclude dunder methods that define operators (FBT001) (#14203) - [
flake8-pyi] Add "replace withSelf" fix (PYI034) (#14217) - [
flake8-pyi] Always autofixduplicate-union-members(PYI016) (#14270) - [
flake8-pyi] Improve autofix for nested and mixed type unions forunnecessary-type-union(PYI055) (#14272) - [
flake8-pyi] Mark fix as unsafe when type annotation contains comments forduplicate-literal-member(PYI062) (#14268)
Server
- Use the current working directory to resolve settings from
ruff.configuration(#14352)
Bug fixes
- Avoid conflicts between
PLC014(useless-import-alias) andI002(missing-required-import) by consideringlint.isort.required-importsforPLC014(#14287) - [
flake8-type-checking] Skip quoting annotation if it becomes invalid syntax (TCH001) - [
flake8-pyi] Avoid usingtyping.Selfin stub files pre-Python 3.11 (PYI034) (#14230) - [
flake8-pytest-style] Flagpytest.raisescall with keyword argumentexpected_exception(PT011) (#14298) - [
flake8-simplify] Infer "unknown" truthiness for literal iterables whose items are all unpacks (SIM222) (#14263) - [
flake8-type-checking] Fix false positives fortyping.Annotated(TCH001) (#14311) - [
pylint] Allowawaitat the top-level scope of a notebook (PLE1142) (#14225) - [
pylint] Fix miscellaneous issues inawait-outside-asyncdetection (PLE1142) (#14218) - [
pyupgrade] Avoid applying PEP 646 rewrites in invalid contexts (UP044) (#14234) - [
pyupgrade] Detect permutations in redundant open modes (UP015) (#14255) - [
refurb] Avoid triggeringhardcoded-string-charsetfor reordered sets (FURB156) (#14233) - [
refurb] Further special cases added toverbose-decimal-constructor(FURB157) (#14216) - [
refurb] UseUserStringinstead of non-existentUserStr(FURB189) (#14209) - [
ruff] Avoid treating lowercase letters as# noqacodes (RUF100) (#14229) - [
ruff] Do not report whenOptionalhas no type arguments (RUF013) (#14181)
Documentation
- Add "Notebook behavior" section for
F704,PLE1142(#14266) - Document comment policy around fix safety (#14300)
Contributors
- @AlexWaygood
- @Daverball
- @Glyphack
- @InSyncWithFoo
- @MichaReiser
- @carljm
- @charliermarsh
- @dhruvmanila
- @dylwil3
- @github-actions
- @harupy
- @nijel
- @pgiraud
- @randolf-scholz
- @renovate
- @sbrugman
- @sharkdp
- @w0nder1ng
Install ruff 0.7.4
Install prebuilt binaries via shell script
curl --proto '=https' --tlsv1.2 -LsSf https://github.com/astral-sh/ruff/releases/download/0.7.4/ruff-installer.sh | shInstall prebuilt binaries via powershell script
powershell -ExecutionPolicy ByPass -c "irm https://github.com/astral-sh/ruff/releases/download/0.7.4/ruff-installer.ps1 | iex"Download ruff 0.7.4
| 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 |
| ruff-x86_64-unknown-linux-gnu.tar.gz | x64 Linux | checksum |
| ruff-armv7-unknown-linux-gnueabihf.tar.gz | ARMv7 Linux | checksum |
| ruff-aarch64-unknown-linux-musl.tar.gz | ARM64 MUSL Linux | checksum |
| ruff-i686-unknown-linux-musl.tar.gz | x86 MUSL Linux | checksum |
| ruff-x86_64-unknown-linux-musl.tar.gz | x64 MUSL Linux | checksum |
| [ruff-arm-unknown-linux-musleabihf.tar.gz](h... |