Update dependency ruff to ^0.11.0 - autoclosed
This MR contains the following updates:
Package | Type | Update | Change |
---|---|---|---|
ruff (source, changelog) | dev | minor |
^0.1.5 -> ^0.11.0
|
Release Notes
astral-sh/ruff (ruff)
v0.11.4
Preview features
- [
ruff
] Implementinvalid-rule-code
asRUF102
(#17138) - [syntax-errors] Detect duplicate keys in
match
mapping patterns (#17129) - [syntax-errors] Detect duplicate attributes in
match
class patterns (#17186) - [syntax-errors] Detect invalid syntax in annotations (#17101)
Bug fixes
- [syntax-errors] Fix multiple assignment error for class fields in
match
patterns (#17184) - Don't skip visiting non-tuple slice in
typing.Annotated
subscripts (#17201)
v0.11.3
Preview features
- [
airflow
] Add more autofixes forAIR302
(#16876, #16977, #16976, #16965) - [
airflow
] MoveAIR301
toAIR002
(#16978) - [
airflow
] MoveAIR302
toAIR301
andAIR303
toAIR302
(#17151) - [
flake8-bandit
] Markstr
andlist[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
case
pattern before final case (#16905) - [syntax-errors] Multiple assignments in
case
pattern (#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.toml
correctly when it is passed via stdin (#16971)
Configuration
- [
flake8-import-conventions
] Add importnumpy.typing as npt
to defaultflake8-import-conventions.aliases
(#17133)
Documentation
- [
refurb
] Document whyUserDict
,UserList
, andUserString
are preferred overdict
,list
, andstr
(FURB189
) (#16927)
v0.11.2
Preview features
- [syntax-errors] Fix false-positive syntax errors emitted for annotations on variadic parameters before Python 3.11 (#16878)
v0.11.1
Preview features
- [
airflow
] Addchain
,chain_linear
andcross_downstream
forAIR302
(#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
FixAll
action in presence of version-specific syntax errors (#16848) - [
flake8-bandit
] Allow raw strings insuspicious-mark-safe-usage
(S308
) #16702 (#16770) - [
refurb
] Avoid panickingunwrap
inverbose-decimal-constructor
(FURB157
) (#16777) - [
refurb
] Fix starred expressions fix (FURB161
) (#16550) - Fix
--statistics
reporting for unsafe fixes (#16756)
Rule changes
- [
flake8-executables
] Allowuv run
in 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-call
examples (INT002
,INT003
) (#16769)
v0.11.0
This is a follow-up to release 0.10.0. Because of a mistake in the release process, the requires-python
inference changes were not included in that release. Ruff 0.11.0 now includes this change as well as the stabilization of the preview behavior for PGH004
.
Breaking changes
-
Changes to how the Python version is inferred when a
target-version
is not specified (#16319)In previous versions of Ruff, you could specify your Python version with:
- The
target-version
option in aruff.toml
file or the[tool.ruff]
section of a pyproject.toml file. - The
project.requires-python
field in apyproject.toml
file 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.toml
files without a[tool.ruff]
section would be ignored, including therequires-python
setting. 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.toml
file without atarget-version
, it will check for apyproject.toml
file in the same directory and respect itsrequires-python
version, even if it does not contain a[tool.ruff]
section. - If Ruff finds a user-level configuration, the
requires-python
field of the closestpyproject.toml
in a parent directory will take precedence. - If there is no config file (
ruff.toml
orpyproject.toml
with a[tool.ruff]
section) in the directory of the file being checked, Ruff will search for the closestpyproject.toml
in the parent directories and use itsrequires-python
setting.
- 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
for
statement iterator clause before Python 3.9 (#16558)
v0.10.0
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-version
is not specified (#16319)Because of a mistake in the release process, the
requires-python
inference changes are not included in this release and instead shipped as part of 0.11.0. You can find a description of this change in the 0.11.0 section. -
Updated
TYPE_CHECKING
behavior (#16669)Previously, Ruff only recognized typechecking blocks that tested the
typing.TYPE_CHECKING
symbol. Now, Ruff recognizes any local variable namedTYPE_CHECKING
. This release also removes support for the legacyif 0:
andif False:
typechecking checks. Use a localTYPE_CHECKING
variable 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
]:RUF035
toS704
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 typestr
orbytes
. -
custom-type-var-for-self
(PYI019
): More accurate detection of customTypeVars
replaceable 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.override
-
invalid-envvar-default
(PLW1508
): Detect default value arguments toos.environ.get
with invalid type. -
pytest-raises-with-multiple-statements
(PT012
)pytest-warns-with-multiple-statements
(PT031
): Allowfor
statements with an empty body inpytest.raises
andpytest.warns
with
statements. -
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 yournoqa
comments when suppressingUP015
. -
stdlib-module-shadowing
(A005
): Changes the default value oflint.flake8-builtins.strict-checking
fromtrue
tofalse
. -
type-none-comparison
(FURB169
): Now also recognizestype(expr) is type(None)
comparisons whereexpr
isn'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-modules
is now deprecated in favor ofallowed-modules
) (#16092)
Bug fixes
- [flake8-bandit] Fix mixed-case hash algorithm names (S324) (#16552)
CLI
- [ruff] Fix
last_tag
/commits_since_last_tag
forversion
command (#16686)
v0.9.10
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 inreturn
andyield
before 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
]type
statements before Python 3.12 (#16478)
Bug fixes
- Escape template filenames in glob patterns in configuration (#16407)
- [
flake8-simplify
] Exempt unittest context methods forSIM115
rule (#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
] Convertcode
keyword argument to a positional argument in fix for (PLR1722
) (#16424)
CLI
- Move rule code from
description
tocheck_name
in GitLab output serializer (#16437)
Documentation
- [
pydocstyle
] Clarify thatD417
only checks docstrings with an arguments section (#16494)
v0.9.9
Preview features
- Fix caching of unsupported-syntax errors (#16425)
Bug fixes
- Only show unsupported-syntax errors in editors when preview mode is enabled (#16429)
v0.9.8
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.nan
inmatch
statements (PLW0177
) (#16378) - [
ruff
] Add more Pydantic models variants to the list of default copy semantics (RUF012
) (#16291)
Server
- Avoid indexing the project if
configurationPreference
iseditorOnly
(#16381) - Avoid unnecessary info at non-trace server log level (#16389)
- Expand
ruff.configuration
to allow inline config (#16296) - Notify users for invalid client settings (#16361)
Configuration
- Add
per-file-target-version
option (#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
] MarkPYI030
fix unsafe when comments are deleted (#16322)
Documentation
- Fix example for
S611
(#16316) - Normalize inconsistent markdown headings in docstrings (#16364)
- Document MSRV policy (#16384)
v0.9.7
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.breakpointhook
andsys.__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.ruff
andsource.fixAll.ruff
code 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
noqa
even when there are no diagnostics (#16178) - Better error messages while loading configuration
extend
s (#15658)
Bug fixes
- [
flake8-comprehensions
] Handle trailing comma inC403
fix (#16110) - [
flake8-pyi
] Avoid flaggingcustom-typevar-for-self
on 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 functionalTypedDicts
with 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
] SkipRUF001
diagnostics when visiting string type definitions (#16122)
Documentation
v0.9.6
Preview features
- [
airflow
] Addexternal_task.{ExternalTaskMarker, ExternalTaskSensor}
forAIR302
(#16014) - [
flake8-builtins
] Make strict module name comparison optional (A005
) (#15951) - [
flake8-pyi
] Extend fix to Python <= 3.9 forredundant-none-literal
(PYI061
) (#16044) - [
pylint
] Also report when the object isn't a literal (PLE1310
) (#15985) - [
ruff
] Implementindented-form-feed
(RUF054
) (#16049) - [
ruff
] Skip type definitions formissing-f-string-syntax
(RUF027
) (#16054)
Rule changes
- [
flake8-annotations
] Correct syntax fortyping.Union
in suggested return type fixes forANN20x
rules (#16025) - [
flake8-builtins
] Match upstream module name comparison (A005
) (#16006) - [
flake8-comprehensions
] Detect overshadowedlist
/set
/dict
, ignore variadics and named expressions (C417
) (#15955) - [
flake8-pie
] Remove following comma correctly when the unpacked dictionary is empty (PIE800
) (#16008) - [
flake8-simplify
] Only triggerSIM401
on known dictionaries (#15995) - [
pylint
] Do not report calls when object type and argument type mismatch, remove custom escape handling logic (PLE1310
) (#15984) - [
pyupgrade
] Comments within parenthesized value ranges should not affect applicability (UP040
) (#16027) - [
pyupgrade
] Don't introduce invalid syntax when upgrading old-style type aliases with parenthesized multiline values (UP040
) (#16026) - [
pyupgrade
] Ensure we do not rename two type parameters to the same name (UP049
) (#16038) - [
pyupgrade
] [ruff
] Don't apply renamings if the new name is shadowed in a scope of one of the references to the binding (UP049
,RUF052
) (#16032) - [
ruff
] UpdateRUF009
to behave similar toB008
and ignore attributes with immutable types (#16048)
Server
- Root exclusions in the server to project root (#16043)
Bug fixes
- [
flake8-datetime
] Ignore.replace()
calls while looking for.astimezone
(#16050) - [
flake8-type-checking
] AvoidTC004
false positive where the runtime definition is provided by__getattr__
(#16052)
Documentation
v0.9.5
Preview features
- Recognize all symbols named
TYPE_CHECKING
forin_type_checking_block
(#15719) - [
flake8-comprehensions
] Handle builtins at top of file correctly forunnecessary-dict-comprehension-for-iterable
(C420
) (#15837) - [
flake8-logging
].exception()
andexc_info=
outside exception handlers (LOG004
,LOG014
) (#15799) - [
flake8-pyi
] Fix incorrect behaviour ofcustom-typevar-return-type
preview-mode autofix iftyping
was already imported (PYI019
) (#15853) - [
flake8-pyi
] Fix more complex cases (PYI019
) (#15821) - [
flake8-pyi
] MakePYI019
autofixable for.py
files in preview mode as well as stubs (#15889) - [
flake8-pyi
] Remove type parameter correctly when it is the last (PYI019
) (#15854) - [
pylint
] Fix missing parens in unsafe fix forunnecessary-dunder-call
(PLC2801
) (#15762) - [
pyupgrade
] Better messages and diagnostic range (UP015
) (#15872) - [
pyupgrade
] Rename private type parameters in PEP 695 generics (UP049
) (#15862) - [
refurb
] Also report non-name expressions (FURB169
) (#15905) - [
refurb
] Mark fix as unsafe if there are comments (FURB171
) (#15832) - [
ruff
] Classes with mixed type variable style (RUF053
) (#15841) - [
airflow
]BashOperator
has been moved toairflow.providers.standard.operators.bash.BashOperator
(AIR302
) (#15922) - [
flake8-pyi
] Add autofix for unused-private-type-var (PYI018
) (#15999) - [
flake8-pyi
] Significantly improve accuracy ofPYI019
if preview mode is enabled (#15888)
Rule changes
- Preserve triple quotes and prefixes for strings (#15818)
- [
flake8-comprehensions
] Skip whenTypeError
present from too many (kw)args forC410
,C411
, andC418
(#15838) - [
flake8-pyi
] RenamePYI019
and improve its diagnostic message (#15885) - [
pep8-naming
] Ignore@override
methods (N803
) (#15954) - [
pyupgrade
] Reuse replacement logic fromUP046
andUP047
to preserve more comments (UP040
) (#15840) - [
ruff
] Analyze deferred annotations before enforcingmutable-(data)class-default
andfunction-call-in-dataclass-default-argument
(RUF008
,RUF009
,RUF012
) (#15921) - [
pycodestyle
] Exemptsys.path += ...
calls (E402
) (#15980)
Configuration
- Config error only when
flake8-import-conventions
alias conflicts withisort.required-imports
bound name (#15918) - Workaround Even Better TOML crash related to
allOf
(#15992)
Bug fixes
- [
flake8-comprehensions
] Unnecessarylist
comprehension (rewrite as aset
comprehension) (C403
) - Handle extraneous parentheses around list comprehension (#15877) - [
flake8-comprehensions
] Handle trailing comma in fixes forunnecessary-generator-list/set
(C400
,C401
) (#15929) - [
flake8-pyi
] Fix several correctness issues withcustom-type-var-return-type
(PYI019
) (#15851) - [
pep8-naming
] Consider any number of leading underscore forN801
(#15988) - [
pyflakes
] Visit forward annotations inTypeAliasType
as types (F401
) (#15829) - [
pylint
] Correct min/max auto-fix and suggestion for (PL1730
) (#15930) - [
refurb
] Handle unparenthesized tuples correctly (FURB122
,FURB142
) (#15953) - [
refurb
] AvoidNone | None
as well as better detection and fix (FURB168
) (#15779)
Documentation
- Add deprecation warning for
ruff-lsp
related settings (#15850) - Docs (
linter.md
): clarify that Python files are always searched for in subdirectories (#15882) - Fix a typo in
non_pep695_generic_class.rs
(#15946) - Improve Docs: Pylint subcategories' codes (#15909)
- Remove non-existing
lint.extendIgnore
editor setting (#15844) - Update black deviations (#15928)
- Mention
UP049
inUP046
andUP047
, addSee also
section toUP040
(#15956) - Add instance variable examples to
RUF012
(#15982) - Explain precedence for
ignore
andselect
config (#15883)
v0.9.4
Preview features
- [
airflow
] Extend airflow context parameter check forBaseOperator.execute
(AIR302
) (#15713) - [
airflow
] UpdateAIR302
to check for deprecated context keys (#15144) - [
flake8-bandit
] Permit suspicious imports within stub files (S4
) (#15822) - [
pylint
] Do not triggerPLR6201
on empty collections (#15732) - [
refurb
] Do not emit diagnostic when loop variables are used outside loop body (FURB122
) (#15757) - [
ruff
] Add support for morere
patterns (RUF055
) (#15764) - [
ruff
] Check for shadowedmap
before suggesting fix (RUF058
) (#15790) - [
ruff
] Do not emit diagnostic when all arguments tozip()
are variadic (RUF058
) (#15744) - [
ruff
] Parenthesize fix when argument spans multiple lines forunnecessary-round
(RUF057
) (#15703)
Rule changes
- Preserve quote style in generated code (#15726, #15778, #15794)
- [
flake8-bugbear
] ExemptNewType
calls where the original type is immutable (B008
) (#15765) - [
pylint
] Honor banned top-level imports byTID253
inPLC0415
. (#15628) - [
pyupgrade
] Ignoreis_typeddict
andTypedDict
fordeprecated-import
(UP035
) (#15800)
CLI
- Fix formatter warning message for
flake8-quotes
option (#15788) - Implement tab autocomplete for
ruff config
(#15603)
Bug fixes
- [
flake8-comprehensions
] Do not emitunnecessary-map
diagnostic when lambda has different arity (C417
) (#15802) - [
flake8-comprehensions
] Parenthesizesorted
when needed forunnecessary-call-around-sorted
(C413
) (#15825) - [
pyupgrade
] Handle end-of-line comments forquoted-annotation
(UP037
) (#15824)
Documentation
- Add missing config docstrings (#15803)
- Add references to
trio.run_process
andanyio.run_process
(#15761) - Use
uv init --lib
in tutorial (#15718)
v0.9.3
Preview features
- [
airflow
] Argumentfail_stop
in DAG has been renamed asfail_fast
(AIR302
) (#15633) - [
airflow
] ExtendAIR303
with more symbols (#15611) - [
flake8-bandit
] Report all references to suspicious functions (S3
) (#15541) - [
flake8-pytest-style
] Do not emit diagnostics for emptyfor
loops (PT012
,PT031
) (#15542) - [
flake8-simplify
] Avoid double negations (SIM103
) (#15562) - [
pyflakes
] Fix infinite loop with unused local import in__init__.py
(F401
) (#15517) - [
pylint
] Do not report methods with only oneEM101
-compatibleraise
(PLR6301
) (#15507) - [
pylint
] Implementredefined-slots-in-subclass
(W0244
) (#9640) - [
pyupgrade
] Add rules to use PEP 695 generics in classes and functions (UP046
,UP047
) (#15565, #15659) - [
refurb
] Implementfor-loop-writes
(FURB122
) (#10630) - [
ruff
] Implementneedless-else
clause (RUF047
) (#15051) - [
ruff
] Implementstarmap-zip
(RUF058
) (#15483)
Rule changes
- [
flake8-bugbear
] Do not raise error if keyword argument is present and target-python version is less or equals than 3.9 (B903
) (#15549) - [
flake8-comprehensions
] strip parentheses around generators inunnecessary-generator-set
(C401
) (#15553) - [
flake8-pytest-style
] Rewrite references to.exception
(PT027
) (#15680) - [
flake8-simplify
] Mark fixes as unsafe (SIM201
,SIM202
) (#15626) - [
flake8-type-checking
] Fix some safe fixes being labeled unsafe (TC006
,TC008
) (#15638) - [
isort
] Omit trailing whitespace inunsorted-imports
(I001
) (#15518) - [
pydoclint
] Allow ignoring one line docstrings forDOC
rules (#13302) - [
pyflakes
] Apply redefinition fixes by source code order (F811
) (#15575) - [
pyflakes
] Avoid removing too many imports inredefined-while-unused
(F811
) (#15585) - [
pyflakes
] Group redefinition fixes by source statement (F811
) (#15574) - [
pylint
] Include name of base class in message forredefined-slots-in-subclass
(W0244
) (#15559) - [
ruff
] Update fix forRUF055
to usevar == value
(#15605)
Formatter
- Fix bracket spacing for single-element tuples in f-string expressions (#15537)
- Fix unstable f-string formatting for expressions containing a trailing comma (#15545)
Performance
- Avoid quadratic membership check in import fixes (#15576)
Server
- Allow
unsafe-fixes
settings for code actions (#15666)
Bug fixes
- [
flake8-bandit
] Add missing single-line/dotall regex flag (S608
) (#15654) - [
flake8-import-conventions
] Fix infinite loop betweenICN001
andI002
(ICN001
) (#15480) - [
flake8-simplify
] Do not emit diagnostics for expressions inside string type annotations (SIM222
,SIM223
) (#15405) - [
pyflakes
] Treat arguments passed to thedefault=
parameter ofTypeVar
as type expressions (F821
) (#15679) - [
pyupgrade
] Avoid syntax error when the iterable is a non-parenthesized tuple (UP028
) (#15543) - [
ruff
] ExemptNewType
calls where the original type is immutable (RUF009
) (#15588) - Preserve raw string prefix and escapes in all codegen fixes (#15694)
Documentation
- Generate documentation redirects for lowercase rule codes (#15564)
-
TRY300
: Add some extra notes on not catching exceptions you didn't expect (#15036)
v0.9.2
Preview features
- [
airflow
] Fix typo "security_managr" to "security_manager" (AIR303
) (#15463) - [
airflow
] extend and fix AIR302 rules (#15525) - [
fastapi
] Handle parameters withDepends
correctly (FAST003
) (#15364) - [
flake8-pytest-style
] Implement pytest.warns diagnostics (PT029
,PT030
,PT031
) (#15444) - [
flake8-pytest-style
] Test function parameters with default arguments (PT028
) (#15449) - [
flake8-type-checking
] Avoid false positives for|
inTC008
(#15201)
Rule changes
- [
flake8-todos
] Allow VSCode GitHub MR extension style links inmissing-todo-link
(TD003
) (#15519) - [
pyflakes
] Show syntax error message forF722
(#15523)
Formatter
- Fix curly bracket spacing around f-string expressions containing curly braces (#15471)
- Fix joining of f-strings with different quotes when using quote style
Preserve
(#15524)
Server
- Avoid indexing the same workspace multiple times (#15495)
- Display context for
ruff.configuration
errors (#15452)
Configuration
- Remove
flatten
to improve deserialization error messages (#15414)
Bug fixes
- Parse triple-quoted string annotations as if parenthesized (#15387)
- [
fastapi
] UpdateAnnotated
fixes (FAST002
) (#15462) - [
flake8-bandit
] Check forbuiltins
instead ofbuiltin
(S102
,PTH123
) (#15443) - [
flake8-pathlib
] Fix--select
foros-path-dirname
(PTH120
) (#15446) - [
ruff
] Fix false positive on global keyword (RUF052
) (#15235)
v0.9.1
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 inreturn
andyield
before 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
]type
statements before Python 3.12 (#16478)
Bug fixes
- Escape template filenames in glob patterns in configuration (#16407)
- [
flake8-simplify
] Exempt unittest context methods forSIM115
rule (#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
] Convertcode
keyword argument to a positional argument in fix for (PLR1722
) (#16424)
CLI
- Move rule code from
description
tocheck_name
in GitLab output serializer (#16437)
Documentation
- [
pydocstyle
] Clarify thatD417
only checks docstrings with an arguments section (#16494)
v0.9.0
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.parametrize
calls outside decorators and calls with keyword arguments. -
module-import-not-at-top-of-file
(E402
): Ignorepytest.importorskip
calls 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
ISC001
incompatibility warning (#15123) - Prefer parenthesizing the
assert
message over breaking the assertion expression (#9457) - Automatically parenthesize over-long
if
guards inmatch
case
clauses (#13513) - More consistent formatting for
match
case
patterns (#6933) - Avoid unnecessary parentheses around return type annotations (#13381)
- Keep the opening parentheses on the same line as the
if
keyword for comprehensions where the condition has a leading comment (#12282) - More consistent formatting for
with
statements 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-alias
more eagerly inTYPE_CHECKING
blocks and ignore it in stubs (TC008
) (#15180) - [
pylint
] Ignoreeq-without-hash
in stub files (PLW1641
) (#15310) - [
pyupgrade
] SplitUP007
into two individual rules:UP007
forUnion
andUP045
forOptional
(UP007
,UP045
) (#15313) - [
ruff
] New rule that detects classes that are both an enum and adataclass
(RUF049
) (#15299) - [
ruff
] RecodeRUF025
toRUF037
(RUF037
) (#15258)
Rule changes
- [
flake8-builtins
] Ignorestdlib-module-shadowing
in 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
logLevel
server 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=value
when thekey
is 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 theint
call would change semantics (RUF046
) (#15277)
v0.8.6
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 whenndigits
is possibly negative (RUF057
) (#15234)
Rule changes
- [
flake8-todos
] remove issue code length restriction (TD003
) (#15175) - [
pyflakes
] Ignore errors in@no_type_check
string 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 toUP006
rule" (#15250)
v0.8.5
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
] UpdateFAST002
to check keyword-only arguments (#15119) - [
flake8-type-checking
] DisableTC006
andTC007
in 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
TypedDict
keys as non-type-expressions (#15073) - [
flake8-comprehensions
] SkipC416
if 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 inPTH201
and 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 toUP006
rule (#5454)
Configuration
- [
flake8-type-checking
] Improve flexibility ofruntime-evaluated-decorators
(#15204) - [
pydocstyle
] Add setting to ignore missing documentation for*args
and**kwargs
parameters (D417
) (#15210) - [
ruff
] Add an allowlist forunsafe-markup-use
(RUF035
) (#15076)
Bug fixes
- Fix type subscript on older python versions (#15090)
- Use
TypeChecker
for detectingfastapi
routes (#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)
v0.8.4
Preview features
- [
airflow
] ExtendAIR302
with additional functions and classes (#15015) - [
airflow
] Implementmoved-to-provider-in-3
for 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 inPERF401
when list variable is after thefor
loop (#14971) - [
perflint
] Simplify finding the loop target inPERF401
(#15025) - [
pylint
] Preserve original value format (PLR6104
) (#14978) - [
ruff
] Avoid false positives forRUF027
for typing context bindings (#15037) - [
ruff
] Check for ambiguous pattern passed topytest.raises()
(RUF043
) (#14966)
Rule changes
- [
flake8-bandit
] CheckS105
for annotated assignment (#15059) - [
flake8-pyi
] More autofixes forredundant-none-literal
(PYI061
) (#14872) - [
pydocstyle
] Skip leading whitespace forD403
(#14963) - [
ruff
] SkipSQLModel
base 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)
v0.8.3
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-variable
on function parameters (RUF052
) (#14818) - [
ruff
] Implementif-key-in-dict-del
(RUF051
) (#14553) - [
ruff
] Mark autofix forRUF052
as always unsafe (#14824) - [
ruff
] Teach autofix forused-dummy-variable
about 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-class
andconvert-named-tuple-functional-to-class
as unsafe if they will remove comments (UP013
,UP014
) (#14842)
Bug fixes
- Raise syntax error for mixing
except
andexcept*
(#14895) - [
flake8-bugbear
] FixB028
to allowstacklevel
to be explicitly assigned as a positional argument (#14868) - [
flake8-bugbear
] SkipB028
ifwarnings.warn
is called with*args
or**kwargs
(#14870) - [
flake8-comprehensions
] Skip iterables with named expressions inunnecessary-map
(C417
) (#14827) - [
flake8-pyi
] Also removeself
andcls
's annotation (PYI034
) (#14801) - [
flake8-pytest-style
] Fixpytest-parametrize-names-wrong-type
(PT006
) to edit bothargnames
andargvalues
if both of them are single-element tuples/lists (#14699) - [
perflint
] Improve autofix forPERF401
(#14369) - [
pylint
] FixPLW1508
false positive for default string created via a mult operation (#14841)
v0.8.2
Preview features
- [
airflow
] Avoid deprecated values (AIR302
) (#14582) - [
airflow
] Extend removed names forAIR302
(#14734) - [
ruff
] Extendunnecessary-regular-expression
to non-literal strings (RUF055
) (#14679) - [
ruff
] Implementused-dummy-variable
(RUF052
) (#14611) - [
ruff
] Implementunnecessary-cast-to-int
(RUF046
) (#14697)
Rule changes
- [
airflow
] CheckAIR001
from builtin or providersoperators
module (#14631) - [
flake8-pytest-style
] Remove@
inpytest.mark.parametrize
rule messages (#14770) - [
pandas-vet
] Skip rules if thepanda
module hasn't been seen (#14671) - [
pylint
] Fix false negatives forascii
andsorted
inlen-as-condition
(PLC1802
) (#14692) - [
refurb
] Guardhashlib
imports and markhashlib-digest-hex
fix 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_check
contexts (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@overload
inPLR0904
(#14730) - [
refurb
] Handle non-finite decimals inverbose-decimal-constructor
(FURB157
) (#14596) - [
ruff
] Avoid emittingassignment-in-assert
when all references to the assigned variable are themselves insideassert
s (RUF018
) (#14661)
Documentation
- Improve docs for
flake8-use-pathlib
rules (#14741) - Improve error messages and docs for
flake8-comprehensions
rules (#14729) - [
flake8-type-checking
] ExpandsTC006
docs to better explain itself (#14749)
v0.8.1
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 implicitschedule
argument toDAG
and@dag
(AIR301
) (#14581) - [
flake8-builtins
] Exempt private built-in modules (A005
) (#14505) - [
flake8-pytest-style
] Fixpytest.mark.parametrize
rules 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-default
to detectos.environ.get
(PLW1508
) (#14512) - [
pylint
] Implementlen-test
(PLC1802
) (#14309) - [
refurb
] Fix bug where methods defined using lambdas were flagged byFURB118
(#14639) - [
ruff
] Auto-addr
prefix 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_check
contexts (F821
,F722
) (#14615) - [
ruff
] Detect redirected-noqa in file-level comments (RUF101
) (#14635) - [
ruff
] Mark fixes forunsorted-dunder-all
andunsorted-dunder-slots
as unsafe when there are complex comments in the sequence (RUF022
,RUF023
) (#14560)
Bug fixes
- Avoid fixing code to
None | None
forredundant-none-literal
(PYI061
) andnever-union
(RUF020
) (#14583, #14589) - [
flake8-bugbear
] Fixmutable-contextvar-default
to 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_attribs
correctly (RUF009
) (#14520)
v0.8.0
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-version
orproject.requires-python
(#13896) -
Changed location of
pydoclint
diagnosticspydoclint
diagnostics 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
noqa
comments in some places, this change may mean that you need to move thenoqa
suppression 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_HOME
or~/.cargo/bin
for 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
:TCH
toTC
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
ignore
s a rule that has been removed (#14435) - Ruff now validates that
lint.flake8-import-conventions.aliases
only uses valid module names and aliases (#14477)
v0.7.4
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-call
fromflake8-markupsafe
plugin (RUF035
) (#14224) - [
ruff
] Report problems forattrs
dataclasses (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-imports
forPLC014
(#14287) - [
flake8-type-checking
] Skip quoting annotation if it becomes invalid syntax (TCH001
) - [
flake8-pyi
] Avoid usingtyping.Self
in stub files pre-Python 3.11 (PYI034
) (#14230) - [
flake8-pytest-style
] Flagpytest.raises
call 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
] Allowawait
at the top-level scope of a notebook (PLE1142
) (#14225) - [
pylint
] Fix miscellaneous issues inawait-outside-async
detection (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-charset
for reordered sets (FURB156
) (#14233) - [
refurb
] Further special cases added toverbose-decimal-constructor
(FURB157
) (#14216) - [
refurb
] UseUserString
instead of non-existentUserStr
(FURB189
) (#14209) - [
ruff
] Avoid treating lowercase letters as# noqa
codes (RUF100
) (#14229) - [
ruff
] Do not report whenOptional
has no type arguments (RUF013
) (#14181)
Documentation
- Add "Notebook behavior" section for
F704
,PLE1142
(#14266) - Document comment policy around fix safety (#14300)
v0.7.3
Preview features
- Formatter: Disallow single-line implicit concatenated strings (#13928)
- [
flake8-pyi
] Include all Python file types forPYI006
andPYI066
(#14059) - [
flake8-simplify
] Implementsplit-of-static-string
(SIM905
) (#14008) - [
refurb
] Implementsubclass-builtin
(FURB189
) (#14105) - [
ruff
] Improve diagnostic messages and docs (RUF031
,RUF032
,RUF034
) (#14068)
Rule changes
- Detect items that hash to same value in duplicate sets (
B033
,PLC0208
) (#14064) - [
eradicate
] Better detection of IntelliJ language injection comments (ERA001
) (#14094) - [
flake8-pyi
] Add autofix fordocstring-in-stub
(PYI021
) (#14150) - [
flake8-pyi
] Updateduplicate-literal-member
(PYI062
) to alawys provide an autofix (#14188) - [
pyflakes
] Detect items that hash to same value in duplicate dictionaries (F601
) (#14065) - [
ruff
] Fix false positive for decorators (RUF028
) (#14061)
Bug fixes
- Avoid parsing joint rule codes as distinct codes in
# noqa
(#12809) - [
eradicate
] ignore# language=
in commented-out-code rule (ERA001) (#14069) - [
flake8-bugbear
] - do not runmutable-argument-default
on stubs (B006
) (#14058) - [
flake8-builtins
] Skip lambda expressions inbuiltin-argument-shadowing (A002)
(#14144) - [
flake8-comprehension
] Also remove trailing comma while fixingC409
andC419
(#14097) - [
flake8-simplify
] Allowopen
without context manager inreturn
statement (SIM115
) (#14066) - [
pylint
] Respect hash-equivalent literals initeration-over-set
(PLC0208
) (#14063) - [
pylint
] Update known dunder methods for Python 3.13 (PLW3201
) (#14146) - [
pyupgrade
] - ignore kwarg unpacking forUP044
(#14053) - [
refurb
] Parse more exotic decimal strings inverbose-decimal-constructor
(FURB157
) (#14098)
Documentation
- Add links to missing related options within rule documentations (#13971)
- Add rule short code to mkdocs tags to allow searching via rule codes (#14040)
v0.7.2
Preview features
- Fix formatting of single with-item with trailing comment (#14005)
- [
pyupgrade
] Add PEP 646Unpack
conversion to*
with fix (UP044
) (#13988)
Rule changes
- Regenerate
known_stdlibs.rs
with stdlibs 2024.10.25 (#13963) - [
flake8-no-pep420
] Skip namespace package enforcement for PEP 723 scripts (INP001
) (#13974)
Server
- Fix server panic when undoing an edit (#14010)
Bug fixes
- Fix issues in discovering ruff in pip build environments (#13881)
- [
flake8-type-checking
] Fix false positive forsingledispatchmethod
(TCH003
) (#13941) - [
flake8-type-checking
] Treat return type ofsingledispatch
as runtime-required (TCH003
) (#13957)
Documentation
- [
flake8-simplify
] Include caveats of enablingif-else-block-instead-of-if-exp
(SIM108
) (#14019)
v0.7.1
Preview features
- Fix
E221
andE222
to flag missing or extra whitespace around==
operator (#13890) - Formatter: Alternate quotes for strings inside f-strings in preview (#13860)
- Formatter: Join implicit concatenated strings when they fit on a line (#13663)
- [
pylint
] Restrictiteration-over-set
to only work on sets of literals (PLC0208
) (#13731)
Rule changes
- [
flake8-type-checking
] Support auto-quoting when annotations contain quotes (#11811)
Server
- Avoid indexing the workspace for single-file mode (#13770)
Bug fixes
- Make
ARG002
compatible withEM101
when raisingNotImplementedError
(#13714)
Other changes
- Introduce more Docker tags for Ruff (similar to uv) (#13274)
v0.7.0
Check out the blog post for a migration guide and overview of the changes!
Breaking changes
- The pytest rules
PT001
andPT023
now default to omitting the decorator parentheses when there are no arguments (#12838, #13292). This was a change that we attempted to make in Ruff v0.6.0, but only partially made due to an error on our part. See the blog post for more details. - The
useless-try-except
rule (in ourtryceratops
category) has been recoded fromTRY302
toTRY203
(#13502). This ensures Ruff's code is consistent with the same rule in thetryceratops
linter. - The
lint.allow-unused-imports
setting has been removed (#13677). Uselint.pyflakes.allow-unused-imports
instead.
Formatter preview style
- Normalize implicit concatenated f-string quotes per part (#13539)
Preview linter features
- [
refurb
] implementhardcoded-string-charset
(FURB156) (#13530) - [
refurb
] Count codepoints not bytes forslice-to-remove-prefix-or-suffix (FURB188)
(#13631)
Rule changes
- [
pylint
] MarkPLE1141
fix as unsafe (#13629) - [
flake8-async
] Consider async generators to be "checkpoints" forcancel-scope-no-checkpoint
(ASYNC100
) (#13639) - [
flake8-bugbear
] Do not suggest setting parameterstrict=
toFalse
inB905
diagnostic message (#13656) - [
flake8-todos
] Only flag the word "TODO", not words starting with "todo" (TD006
) (#13640) - [
pycodestyle
] Fix whitespace-related false positives and false negatives inside type-parameter lists (E231
,E251
) (#13704) - [
flake8-simplify
] Stabilize preview behavior forSIM115
so that the rule can detect files being opened from a wider range of standard-library functions (#12959).
CLI
- Add explanation of fixable in
--statistics
command (#13774)
Bug fixes
- [
pyflakes
] Allowipytest
cell magic (F401
) (#13745) - [
flake8-use-pathlib
] FixPTH123
false positive whenopen
is passed a file descriptor (#13616) - [
flake8-bandit
] Detect patterns from multi line SQL statements (S608
) (#13574) - [
flake8-pyi
] - Fix dropped expressions inPYI030
autofix (#13727)
v0.6.9
Preview features
- Fix codeblock dynamic line length calculation for indented docstring examples (#13523)
- [
refurb
] MarkFURB118
fix as unsafe (#13613)
Rule changes
- [
pydocstyle
] Don't raiseD208
when last line is non-empty (#13372) - [
pylint
] Preserve trivia (i.e. comments) inPLR5501
autofix (#13573)
Configuration
- [
pyflakes
] Addallow-unused-imports
setting forunused-import
rule (F401
) (#13601)
Bug fixes
- Support ruff discovery in pip build environments (#13591)
- [
flake8-bugbear
] Avoid short circuitingB017
for multiple context managers (#13609) - [
pylint
] Do not offer an invalid fix forPLR1716
when the comparisons contain parenthesis (#13527) - [
pyupgrade
] FixUP043
to apply tocollections.abc.Generator
andcollections.abc.AsyncGenerator
(#13611) - [
refurb
] Fix handling of slices in tuples forFURB118
, e.g.,x[:, 1]
(#13518)
Documentation
- Update GitHub Action link to
astral-sh/ruff-action
(#13551)
v0.6.8
Preview features
- Remove unnecessary parentheses around
match case
clauses (#13510) - Parenthesize overlong
if
guards inmatch..case
clauses (#13513) - Detect basic wildcard imports in
ruff analyze graph
(#13486) - [
pylint
] Implementboolean-chained-comparison
(R1716
) (#13435)
Rule changes
- [
lake8-simplify
] DetectSIM910
when using variadic keyword arguments, i.e.,**kwargs
(#13503) - [
pyupgrade
] Avoid false negatives with non-reference shadowed bindings of loop variables (UP028
) (#13504)
Bug fixes
- Detect tuples bound to variadic positional arguments i.e.
*args
(#13512) - Exit gracefully on broken pipe errors (#13485)
- Avoid panic when analyze graph hits broken pipe (#13484)
Performance
v0.6.7
Preview features
- Add Python version support to ruff analyze CLI (#13426)
- Add
exclude
support toruff analyze
(#13425) - Fix parentheses around return type annotations (#13381)
Rule changes
- [
pycodestyle
] Fix: Don't autofix if the first line ends in a question mark? (D400) (#13399)
Bug fixes
- Respect
lint.exclude
in ruff check--add-noqa
(#13427)
Performance
- Avoid tracking module resolver files in Salsa (#13437)
- Use
forget
for module resolver database (#13438)
v0.6.6
Preview features
- [
refurb
] Skipslice-to-remove-prefix-or-suffix
(FURB188
) when non-trivial slice steps are present (#13405) - Add a subcommand to generate dependency graphs (#13402)
Formatter
- Fix placement of inline parameter comments (#13379)
Server
- Fix off-by one error in the
LineIndex::offset
calculation (#13407)
Bug fixes
- [
fastapi
] Respect FastAPI aliases in route definitions (#13394) - [
pydocstyle
] Respect word boundaries when detecting function signature in docs (#13388)
Documentation
- Add backlinks to rule overview linter (#13368)
- Fix documentation for editor vim plugin ALE (#13348)
- Fix rendering of
FURB188
docs (#13406)
v0.6.5
Preview features
- [
pydoclint
] IgnoreDOC201
when function name is "new" (#13300) - [
refurb
] Implementslice-to-remove-prefix-or-suffix
(FURB188
) (#13256)
Rule changes
- [
eradicate
] Ignore script-comments with multiple end-tags (ERA001
) (#13283) - [
pyflakes
] Improve error message forUndefinedName
when a builtin was added in a newer version than specified in Ruff config (F821
) (#13293)
Server
- Add support for extensionless Python files for server (#13326)
- Fix configuration inheritance for configurations specified in the LSP settings (#13285)
Bug fixes
- [
ruff
] Handle unary operators indecimal-from-float-literal
(RUF032
) (#13275)
CLI
- Only include rules with diagnostics in SARIF metadata (#13268)
Playground
- Add "Copy as pyproject.toml/ruff.toml" and "Paste from TOML" (#13328)
- Fix errors not shown for restored snippet on page load (#13262)
v0.6.4
Preview features
- [
flake8-builtins
] Use dynamic builtins list based on Python version (#13172) - [
pydoclint
] Permit yieldingNone
inDOC402
andDOC403
(#13148) - [
pylint
] Update diagnostic message forPLW3201
(#13194) - [
ruff
] Implementpost-init-default
(RUF033
) (#13192) - [
ruff
] Implement useless if-else (RUF034
) (#13218)
Rule changes
- [
flake8-pyi
] Respectpep8_naming.classmethod-decorators
settings when determining if a method is a classmethod incustom-type-var-return-type
(PYI019
) (#13162) - [
flake8-pyi
] Teach various rules that annotations might be stringized (#12951) - [
pylint
] Avoidno-self-use
forattrs
-style validators (#13166) - [
pylint
] Recurse into subscript subexpressions when searching for list/dict lookups (PLR1733
,PLR1736
) (#13186) - [
pyupgrade
] Detectaiofiles.open
calls inUP015
(#13173) - [
pyupgrade
] Marksys.version_info[0] < 3
and similar comparisons as outdated (UP036
) (#13175)
CLI
- Enrich messages of SARIF results (#13180)
- Handle singular case for incompatible rules warning in
ruff format
output (#13212)
Bug fixes
- [
pydocstyle
] Improve heuristics for detecting Google-style docstrings (#13142) - [
refurb
] Treatsep
arguments with effects as unsafe removals (FURB105
) (#13165)
v0.6.3
Preview features
- [
flake8-simplify
] Extendopen-file-with-context-handler
to work withdbm.sqlite3
(SIM115
) (#13104) - [
pycodestyle
] DisableE741
in stub files (.pyi
) (#13119) - [
pydoclint
] AvoidDOC201
on explicit returns in functions that only returnNone
(#13064)
Rule changes
- [
flake8-async
] Disable check forasyncio
before Python 3.11 (ASYNC109
) (#13023)
Bug fixes
- [
FastAPI
] Avoid introducing invalid syntax in fix forfast-api-non-annotated-dependency
(FAST002
) (#13133) - [
flake8-implicit-str-concat
] Normalize octals before merging concatenated strings insingle-line-implicit-string-concatenation
(ISC001
) (#13118) - [
flake8-pytest-style
] Improve help message forpytest-incorrect-mark-parentheses-style
(PT023
) (#13092) - [
pylint
] Avoid autofix for calls that aren'tmin
ormax
as starred expression (PLW3301
) (#13089) - [
ruff
] Adddatetime.time
,datetime.tzinfo
, anddatetime.timezone
as immutable function calls (RUF009
) (#13109) - [
ruff
] Extend comment deletion forRUF100
to include trailing text fromnoqa
directives while preserving any following comments on the same line, if any (#13105) - Fix dark theme on initial page load for the Ruff playground (#13077)
v0.6.2
Preview features
- [
flake8-simplify
] Extendopen-file-with-context-handler
to work with other standard-library IO modules (SIM115
) (#12959) - [
ruff
] Avoidunused-async
for functions with FastAPI route decorator (RUF029
) (#12938) - [
ruff
] Ignorefstring-missing-syntax
(RUF027
) forfastAPI
paths (#12939) - [
ruff
] Implement check for Decimal called with a float literal (RUF032) (#12909)
Rule changes
- [
flake8-bugbear
] Update diagnostic message when expression is at the end of function (B015
) (#12944) - [
flake8-pyi
] Skip type annotations instring-or-bytes-too-long
(PYI053
) (#13002) - [
flake8-type-checking
] Always recognise relative imports as first-party (#12994) - [
flake8-unused-arguments
] Ignore unused arguments on stub functions (ARG001
) (#12966) - [
pylint
] Ignore augmented assignment forself-cls-assignment
(PLW0642
) (#12957)
Server
- Show full context in error log messages (#13029)
Bug fixes
- [
pep8-naming
] Don't flagfrom
imports following conventional import names (N817
) (#12946) - [
pylint
] - Allow__new__
methods to havecls
as their first argument even if decorated with@staticmethod
forbad-staticmethod-argument
(PLW0211
) (#12958)
Documentation
- Add
hyperfine
installation instructions; updatehyperfine
code samples (#13034) - Expand note to use Ruff with other language server in Kate (#12806)
- Update example for
PT001
as per the new default behavior (#13019) - [
perflint
] Improve docs fortry-except-in-loop
(PERF203
) (#12947) - [
pydocstyle
] Add reference tolint.pydocstyle.ignore-decorators
setting to rule docs (#12996)
v0.6.1
This is a hotfix release to address an issue with ruff-pre-commit
. In v0.6,
Ruff changed its behavior to lint and format Jupyter notebooks by default;
however, due to an oversight, these files were still excluded by default if
Ruff was run via pre-commit, leading to inconsistent behavior.
This has now been fixed.
Preview features
- [
fastapi
] Implementfast-api-unused-path-parameter
(FAST003
) (#12638)
Rule changes
- [
pylint
] Renametoo-many-positional
totoo-many-positional-arguments
(R0917
) (#12905)
Server
- Fix crash when applying "fix-all" code-action to notebook cells (#12929)
Other changes
- [
flake8-naming
]: Respect import conventions (N817
) (#12922)
v0.6.0
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.
- Lint and format Jupyter Notebook by default (#12878).
- Detect imports in
src
layouts by default forisort
rules (#12848) - The pytest rules
PT001
andPT023
now default to omitting the decorator parentheses when there are no arguments (#12838).
Deprecations
The following rules are now deprecated:
-
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:
-
unnecessary-dict-comprehension-for-iterable
:RUF025
toC420
Stabilization
The following rules have been stabilized and are no longer in preview:
-
singledispatch-method
(PLE1519
) -
singledispatchmethod-function
(PLE1520
) -
bad-staticmethod-argument
(PLW0211
) -
if-stmt-min-max
(PLR1730
) -
invalid-bytes-return-type
(PLE0308
) -
invalid-hash-return-type
(PLE0309
) -
invalid-index-return-type
(PLE0305
) -
invalid-length-return-type
(PLEE303
) -
self-or-cls-assignment
(PLW0642
) -
byte-string-usage
(PYI057
) -
duplicate-literal-member
(PYI062
) -
redirected-noqa
(RUF101
)
The following behaviors have been stabilized:
-
cancel-scope-no-checkpoint
(ASYNC100
): Supportasyncio
andanyio
context managers. -
async-function-with-timeout
(ASYNC109
): Supportasyncio
andanyio
context managers. -
async-busy-wait
(ASYNC110
): Supportasyncio
andanyio
context managers. -
async-zero-sleep
(ASYNC115
): Supportanyio
context managers. -
long-sleep-not-forever
(ASYNC116
): Supportanyio
context managers.
The following fixes have been stabilized:
-
superfluous-else-return
(RET505
) -
superfluous-else-raise
(RET506
) -
superfluous-else-continue
(RET507
) -
superfluous-else-break
(RET508
)
Preview features
- [
flake8-simplify
] Further simplify to binary in preview for (SIM108
) (#12796) - [
pyupgrade
] Show violations without auto-fix (UP031
) (#11229)
Rule changes
- [
flake8-import-conventions
] Addxml.etree.ElementTree
to default conventions (#12455) - [
flake8-pytest-style
] Add a space after comma in CSV output (PT006
) (#12853)
Server
- Show a message for incorrect settings (#12781)
Bug fixes
- [
flake8-async
] Do not lint yield in context manager (ASYNC100
) (#12896) - [
flake8-comprehensions
] Do not lintasync for
comprehensions (C419
) (#12895) - [
flake8-return
] Only add returnNone
at end of a function (RET503
) (#11074) - [
flake8-type-checking
] Avoid treatingdataclasses.KW_ONLY
as typing-only (TCH003
) (#12863) - [
pep8-naming
] Treattype(Protocol)
et al as metaclass base (N805
) (#12770) - [
pydoclint
] Don't enforce returns and yields in abstract methods (DOC201
,DOC202
) (#12771) - [
ruff
] Skip tuples with slice expressions in (RUF031
) (#12768) - [
ruff
] Ignore unparenthesized tuples in subscripts when the subscript is a type annotation or type alias (RUF031
) (#12762) - [
ruff
] Ignore template strings passed to logging andbuiltins._()
calls (RUF027
) (#12889) - [
ruff
] Do not remove parens for tuples with starred expressions in Python <=3.10 (RUF031
) (#12784) - Evaluate default parameter values for a function in that function's enclosing scope (#12852)
Other changes
- Respect VS Code cell metadata when detecting the language of Jupyter Notebook cells (#12864)
- Respect
kernelspec
notebook metadata when detecting the preferred language for a Jupyter Notebook (#12875)
v0.5.7
Preview features
- [
flake8-comprehensions
] Account for list and set comprehensions inunnecessary-literal-within-tuple-call
(C409
) (#12657) - [
flake8-pyi
] Add autofix forfuture-annotations-in-stub
(PYI044
) (#12676) - [
flake8-return
] Avoid syntax error when auto-fixingRET505
with mixed indentation (space and tabs) (#12740) - [
pydoclint
] Adddocstring-missing-yields
(DOC402
) anddocstring-extraneous-yields
(DOC403
) (#12538) - [
pydoclint
] AvoidDOC201
if docstring begins with "Return", "Returns", "Yield", or "Yields" (#12675) - [
pydoclint
] Deduplicate collected exceptions after traversing function bodies (DOC501
) (#12642) - [
pydoclint
] IgnoreDOC
errors for stub functions (#12651) - [
pydoclint
] Teach rules to understand reraised exceptions as being explicitly raised (DOC501
,DOC502
) (#12639) - [
ruff
] Implementincorrectly-parenthesized-tuple-in-subscript
(RUF031
) (#12480) - [
ruff
] MarkRUF023
fix as unsafe if__slots__
is not a set and the binding is used elsewhere (#12692)
Rule changes
- [
refurb
] Add autofix forimplicit-cwd
(FURB177
) (#12708) - [
ruff
] Add autofix forzip-instead-of-pairwise
(RUF007
) (#12663) - [
tryceratops
] AddBaseException
toraise-vanilla-class
rule (TRY002
) (#12620)
Server
- Ignore non-file workspace URL; Ruff will display a warning notification in this case (#12725)
CLI
- Fix cache invalidation for nested
pyproject.toml
files (#12727)
Bug fixes
- [
flake8-async
] Fix false positives with multipleasync with
items (ASYNC100
) (#12643) - [
flake8-bandit
] Avoid false-positives for list concatenations in SQL construction (S608
) (#12720) - [
flake8-bugbear
] Treatreturn
as equivalent tobreak
(B909
) (#12646) - [
flake8-comprehensions
] Set comprehensions not a violation forsum
inunnecessary-comprehension-in-call
(C419
) (#12691) - [
flake8-simplify
] Parenthesize conditions based on precedence when merging if arms (SIM114
) (#12737) - [
pydoclint
] Try both 'Raises' section styles when convention is unspecified (DOC501
) (#12649)
v0.5.6
Ruff 0.5.6 automatically enables linting and formatting of notebooks in preview mode.
You can opt-out of this behavior by adding *.ipynb
to the extend-exclude
setting.
[tool.ruff]
extend-exclude = ["*.ipynb"]
Preview features
- Enable notebooks by default in preview mode (#12621)
- [
flake8-builtins
] Implement import, lambda, and module shadowing (#12546) - [
pydoclint
] Adddocstring-missing-returns
(DOC201
) anddocstring-extraneous-returns
(DOC202
) (#12485)
Rule changes
- [
flake8-return
] Exempt cached properties and other property-like decorators from explicit return rule (RET501
) (#12563)
Server
- Make server panic hook more error resilient (#12610)
- Use
$/logTrace
for server trace logs in Zed and VS Code (#12564) - Keep track of deleted cells for reorder change request (#12575)
Configuration
- [
flake8-implicit-str-concat
] Always allow explicit multi-line concatenations when implicit concatenations are banned (#12532)
Bug fixes
- [
flake8-async
] Avoid flaggingasyncio.timeout
s as unused when the context manager includesasyncio.TaskGroup
(#12605) - [
flake8-slots
] Avoid recommending__slots__
for classes that inherit from more thannamedtuple
(#12531) - [
isort
] Avoid marking required imports as unused (#12537) - [
isort
] Preserve trailing inline comments on import-from statements (#12498) - [
pycodestyle
] Add newlines before comments (E305
) (#12606) - [
pycodestyle
] Don't attach comments with mismatched indents (#12604) - [
pyflakes
] Fix preview-mode bugs inF401
when attempting to autofix unused first-party submodule imports in an__init__.py
file (#12569) - [
pylint
] Respect start index inunnecessary-list-index-lookup
(#12603) - [
pyupgrade
] Avoid recommending no-argument super inslots=True
dataclasses (#12530) - [
pyupgrade
] Use colon rather than dot formatting for integer-only types (#12534) - Fix NFKC normalization bug when removing unused imports (#12571)
Other changes
- Consider more stdlib decorators to be property-like (#12583)
- Improve handling of metaclasses in various linter rules (#12579)
- Improve consistency between linter rules in determining whether a function is property (#12581)
v0.5.5
Preview features
- [
fastapi
] Implementfastapi-redundant-response-model
(FAST001
) andfastapi-non-annotated-dependency
(FAST002
) (#11579) - [
pydoclint
] Implementdocstring-missing-exception
(DOC501
) anddocstring-extraneous-exception
(DOC502
) (#11471)
Rule changes
- [
numpy
] Fix NumPy 2.0 rule fornp.alltrue
andnp.sometrue
(#12473) - [
numpy
] IgnoreNPY201
insideexcept
blocks for compatibility with older numpy versions (#12490) - [
pep8-naming
] Avoid applyingignore-names
toself
andcls
function names (N804
,N805
) (#12497)
Formatter
- Fix incorrect placement of leading function comment with type params (#12447)
Server
- Do not bail code action resolution when a quick fix is requested (#12462)
Bug fixes
- Fix
Ord
implementation ofcmp_fix
(#12471) - Raise syntax error for unparenthesized generator expression in multi-argument call (#12445)
- [
pydoclint
] Fix panic inDOC501
reported in #12428 (#12435) - [
flake8-bugbear
] Allow singleton tuples with starred expressions inB013
(#12484)
Documentation
- Add Eglot setup guide for Emacs editor (#12426)
- Add note about the breaking change in
nvim-lspconfig
(#12507) - Add note to include notebook files for native server (#12449)
- Add setup docs for Zed editor (#12501)
v0.5.4
Rule changes
- [
ruff
] RenameRUF007
tozip-instead-of-pairwise
(#12399)
Bug fixes
- [
flake8-builtins
] Avoid shadowing diagnostics for@override
methods (#12415) - [
flake8-comprehensions
] Insert parentheses for multi-argument generators (#12422) - [
pydocstyle
] Handle escaped docstrings within docstring (D301
) (#12192)
Documentation
v0.5.3
Ruff 0.5.3 marks the stable release of the Ruff language server and introduces revamped documentation, including setup guides for your editor of choice and the language server itself.
Preview features
- Formatter: Insert empty line between suite and alternative branch after function/class definition (#12294)
- [
pyupgrade
] Implementunnecessary-default-type-args
(UP043
) (#12371)
Rule changes
- [
flake8-bugbear
] Detect enumerate iterations inloop-iterator-mutation
(B909
) (#12366) - [
flake8-bugbear
] Removediscard
,remove
, andpop
allowance forloop-iterator-mutation
(B909
) (#12365) - [
pylint
] Allowrepeated-equality-comparison
for mixed operations (PLR1714
) (#12369) - [
pylint
] Ignoreself
andcls
when counting arguments (PLR0913
) (#12367) - [
pylint
] Use UTF-8 as default encoding inunspecified-encoding
fix (PLW1514
) (#12370)
Server
- Build settings index in parallel for the native server (#12299)
- Use fallback settings when indexing the project (#12362)
- Consider
--preview
flag forserver
subcommand for the linter and formatter (#12208)
Bug fixes
- [
flake8-comprehensions
] Allow additional arguments forsum
andmax
comprehensions (C419
) (#12364) - [
pylint
] Avoid dropping extra boolean operations inrepeated-equality-comparison
(PLR1714
) (#12368) - [
pylint
] Consider expression before statement when determining binding kind (PLR1704
) (#12346)
Documentation
- Add docs for Ruff language server (#12344)
- Migrate to standalone docs repo (#12341)
- Update versioning policy for editor integration (#12375)
Other changes
- Publish Wasm API to npm (#12317)
v0.5.2
Preview features
- Use
space
separator before parenthesized expressions in comprehensions with leading comments (#12282) - [
flake8-async
] UpdateASYNC100
to includeanyio
andasyncio
(#12221) - [
flake8-async
] UpdateASYNC109
to includeanyio
andasyncio
(#12236) - [
flake8-async
] UpdateASYNC110
to includeanyio
andasyncio
(#12261) - [
flake8-async
] UpdateASYNC115
to includeanyio
andasyncio
(#12262) - [
flake8-async
] UpdateASYNC116
to includeanyio
andasyncio
(#12266)
Rule changes
- [
flake8-return
] Exempt properties from explicit return rule (RET501
) (#12243) - [
numpy
] Addnp.NAN
-to-np.nan
diagnostic (#12292) - [
refurb
] Makelist-reverse-copy
an unsafe fix (#12303)
Server
- Consider
include
andextend-include
settings in native server (#12252) - Include nested configurations in settings reloading (#12253)
CLI
- Omit code frames for fixes with empty ranges (#12304)
- Warn about formatter incompatibility for
D203
(#12238)
Bug fixes
- Make cache-write failures non-fatal on Windows (#12302)
- Treat
not
operations as boolean tests (#12301) - [
flake8-bandit
] AvoidS310
violations for HTTP-safe f-strings (#12305) - [
flake8-bandit
] Support explicit string concatenations in S310 HTTP detection (#12315) - [
flake8-bandit
] fix S113 false positive for httpx withouttimeout
argument (#12213) - [
pycodestyle
] Remove "non-obvious" allowance for E721 (#12300) - [
pyflakes
] Considerwith
blocks as single-item branches for redefinition analysis (#12311) - [
refurb
] Restrict forwarding fornewline
argument inopen()
calls to Python versions >= 3.10 (#12244)
Documentation
- Update help and documentation to reflect
--output-format full
default (#12248)
Performance
- Use more threads when discovering Python files (#12258)
v0.5.1
Preview features
- [
flake8-bugbear
] Implement mutable-contextvar-default (B039) (#12113) - [
pycodestyle
] Whitespace after decorator (E204
) (#12140) - [
pytest
] ReversePT001
andPT0023
defaults (#12106)
Rule changes
- Enable token-based rules on source with syntax errors (#11950)
- [
flake8-bandit
] Detecthttpx
forS113
(#12174) - [
numpy
] UpdateNPY201
to include exception deprecations (#12065) - [
pylint
] Generate autofix forduplicate-bases
(PLE0241
) (#12105)
Server
- Avoid syntax error notification for source code actions (#12148)
- Consider the content of the new cells during notebook sync (#12203)
- Fix replacement edit range computation (#12171)
Bug fixes
- Disable auto-fix when source has syntax errors (#12134)
- Fix cache key collisions for paths with separators (#12159)
- Make
requires-python
inference robust to==
(#12091) - Use char-wise width instead of
str
-width (#12135) - [
pycodestyle
] AvoidE275
if keyword followed by comma (#12136) - [
pycodestyle
] AvoidE275
if keyword is followed by a semicolon (#12095) - [
pylint
] Skip dummy variables forPLR1704
(#12190)
Performance
v0.5.0
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.
- Follow the XDG specification to discover user-level configurations on macOS (same as on other Unix platforms)
- Selecting
ALL
now excludes deprecated rules - The released archives now include an extra level of nesting, which can be removed with
--strip-components=1
when untarring. - The release artifact's file name no longer includes the version tag. This enables users to install via
/latest
URLs on GitHub. - The diagnostic ranges for some
flake8-bandit
rules were modified (#10667).
Deprecations
The following rules are now deprecated:
-
syntax-error
(E999
): Syntax errors are now always shown
Remapped rules
The following rules have been remapped to new rule codes:
-
blocking-http-call-in-async-function
:ASYNC100
toASYNC210
-
open-sleep-or-subprocess-in-async-function
:ASYNC101
split intoASYNC220
,ASYNC221
,ASYNC230
, andASYNC251
-
blocking-os-call-in-async-function
:ASYNC102
has been merged intoASYNC220
andASYNC221
-
trio-timeout-without-await
:TRIO100
toASYNC100
-
trio-sync-call
:TRIO105
toASYNC105
-
trio-async-function-with-timeout
:TRIO109
toASYNC109
-
trio-unneeded-sleep
:TRIO110
toASYNC110
-
trio-zero-sleep-call
:TRIO115
toASYNC115
-
repeated-isinstance-calls
:PLR1701
toSIM101
Stabilization
The following rules have been stabilized and are no longer in preview:
-
mutable-fromkeys-value
(RUF024
) -
default-factory-kwarg
(RUF026
) -
django-extra
(S610
) -
manual-dict-comprehension
(PERF403
) -
print-empty-string
(FURB105
) -
readlines-in-for
(FURB129
) -
if-expr-min-max
(FURB136
) -
bit-count
(FURB161
) -
redundant-log-base
(FURB163
) -
regex-flag-alias
(FURB167
) -
isinstance-type-none
(FURB168
) -
type-none-comparison
(FURB169
) -
implicit-cwd
(FURB177
) -
hashlib-digest-hex
(FURB181
) -
list-reverse-copy
(FURB187
) -
bad-open-mode
(PLW1501
) -
empty-comment
(PLR2044
) -
global-at-module-level
(PLW0604
) -
misplaced-bare-raise
(PLE0744
) -
non-ascii-import-name
(PLC2403
) -
non-ascii-name
(PLC2401
) -
nonlocal-and-global
(PLE0115
) -
potential-index-error
(PLE0643
) -
redeclared-assigned-name
(PLW0128
) -
redefined-argument-from-local
(PLR1704
) -
repeated-keyword-argument
(PLE1132
) -
super-without-brackets
(PLW0245
) -
unnecessary-list-index-lookup
(PLR1736
) -
useless-exception-statement
(PLW0133
) -
useless-with-lock
(PLW2101
)
The following behaviors have been stabilized:
-
is-literal
(F632
) now warns for identity checks against list, set or dictionary literals -
needless-bool
(SIM103
) now detectsif
expressions with implicitelse
branches -
module-import-not-at-top-of-file
(E402
) now allowsos.environ
modifications between import statements -
type-comparison
(E721
) now allows idioms such astype(x) is int
-
yoda-condition
(SIM300
) now flags a wider range of expressions
Removals
The following deprecated settings have been removed:
-
output-format=text
; useoutput-format=concise
oroutput-format=full
-
tab-size
; useindent-width
The following deprecated CLI options have been removed:
-
--show-source
; use--output-format=full
-
--no-show-source
; use--output-format=concise
The following deprecated CLI commands have been removed:
-
ruff <path>
; useruff check <path>
-
ruff --clean
; useruff clean
-
ruff --generate-shell-completion
; useruff generate-shell-completion
Preview features
- [
ruff
] Addassert-with-print-message
rule (#11981)
CLI
- Use rule name rather than message in
--statistics
(#11697) - Use the output format
full
by default (#12010) - Don't log syntax errors to the console (#11902)
Rule changes
- [
ruff
] Fix false positives ifgettext
is imported using an alias (RUF027
) (#12025) - [
numpy
] Updatetrapz
andin1d
deprecation (NPY201
) (#11948) - [
flake8-bandit
] Modify diagnostic ranges for shell-related rules (#10667)
Server
- Closing an untitled, unsaved notebook document no longer throws an error (#11942)
- Support the usage of tildes and environment variables in
logFile
(#11945) - Add option to configure whether to show syntax errors (#12059)
Bug fixes
- [
pycodestyle
] AvoidE203
for f-string debug expression (#12024) - [
pep8-naming
] Match import-name ignores against both name and alias (N812
,N817
) (#12033) - [
pyflakes
] Detect assignments that shadow definitions (F811
) (#11961)
Parser
- Emit a syntax error for an empty type parameter list (#12030)
- Avoid consuming the newline for unterminated strings (#12067)
- Do not include the newline in the unterminated string range (#12017)
- Use the correct range to highlight line continuation errors (#12016)
- Consider 2-character EOL before line continuations (#12035)
- Consider line continuation character for re-lexing (#12008)
Other changes
- Upgrade the Unicode table used for measuring the line-length (#11194)
- Remove the deprecation error message for the nursery selector (#10172)
v0.4.10
Parser
- Implement re-lexing logic for better error recovery (#11845)
Rule changes
- [
flake8-copyright
] UpdateCPY001
to check the first 4096 bytes instead of 1024 (#11927) - [
pycodestyle
] UpdateE999
to show all syntax errors instead of just the first one (#11900)
Server
- Add tracing setup guide to Helix documentation (#11883)
- Add tracing setup guide to Neovim documentation (#11884)
- Defer notebook cell deletion to avoid an error message (#11864)
Security
- Guard against malicious ecosystem comment artifacts (#11879)
v0.4.9
Preview features
- [
pylint
] Implementconsider-dict-items
(C0206
) (#11688) - [
refurb
] Implementrepeated-global
(FURB154
) (#11187)
Rule changes
- [
pycodestyle
] Adapt fix forE203
to work identical toruff format
(#10999)
Formatter
- Fix formatter instability for lines only consisting of zero-width characters (#11748)
Server
- Add supported commands in server capabilities (#11850)
- Use real file path when available in
ruff server
(#11800) - Improve error message when a command is run on an unavailable document (#11823)
- Introduce the
ruff.printDebugInformation
command (#11831) - Tracing system now respects log level and trace level, with options to log to a file (#11747)
CLI
- Handle non-printable characters in diff view (#11687)
Bug fixes
- [
refurb
] Avoid suggesting starmap when arguments are used outside call (FURB140
) (#11830) - [
flake8-bugbear
] Avoid panic inB909
when checking large loop blocks (#11772) - [
refurb
] Fix misbehavior ofoperator.itemgetter
when getter param is a tuple (FURB118
) (#11774)
v0.4.8
Performance
- Linter performance has been improved by around 10% on some microbenchmarks by refactoring the lexer and parser to maintain synchronicity between them (#11457)
Preview features
- [
flake8-bugbear
] Implementreturn-in-generator
(B901
) (#11644) - [
flake8-pyi
] Implementpep484-style-positional-only-parameter
(PYI063
) (#11699) - [
pygrep_hooks
] Check blanket ignores via file-level pragmas (PGH004
) (#11540)
Rule changes
- [
pyupgrade
] UpdateUP035
for Python 3.13 and the latest version oftyping_extensions
(#11693) - [
numpy
] UpdateNPY001
rule for NumPy 2.0 (#11735)
Server
- Formatting a document with syntax problems no longer spams a visible error popup (#11745)
CLI
- Add RDJson support for
--output-format
flag (#11682)
Bug fixes
- [
pyupgrade
] Write empty string in lieu of panic when fixingUP032
(#11696) - [
flake8-simplify
] Simplify double negatives inSIM103
(#11684) - Ensure the expression generator adds a newline before
type
statements (#11720) - Respect per-file ignores for blanket and redirected noqa rules (#11728)
v0.4.7
Preview features
- [
flake8-pyi
] ImplementPYI064
(#11325) - [
flake8-pyi
] ImplementPYI066
(#11541) - [
flake8-pyi
] ImplementPYI057
(#11486) - [
pyflakes
] EnableF822
in__init__.py
files by default (#11370)
Formatter
- Fix incorrect placement of trailing stub function comments (#11632)
Server
- Respect file exclusions in
ruff server
(#11590) - Add support for documents not exist on disk (#11588)
- Add Vim and Kate setup guide for
ruff server
(#11615)
Bug fixes
- Avoid removing newlines between docstring headers and rST blocks (#11609)
- Infer indentation with imports when logical indent is absent (#11608)
- Use char index rather than position for indent slice (#11645)
- [
flake8-comprehension
] Strip parentheses around generators inC400
(#11607) - Mark
repeated-isinstance-calls
as unsafe on Python 3.10 and later (#11622)
v0.4.6
Breaking changes
- Use project-relative paths when calculating GitLab fingerprints (#11532)
- Bump minimum supported Windows version to Windows 10 (#11613)
Preview features
- [
flake8-async
] Sleep with >24 hour interval should usually sleep forever (ASYNC116
) (#11498)
Rule changes
- [
numpy
] Add missing functions to NumPy 2.0 migration rule (#11528) - [
mccabe
] Consider irrefutable pattern similar toif .. else
forC901
(#11565) - Consider
match
-case
statements forC901
,PLR0912
, andPLR0915
(#11521) - Remove empty strings when converting to f-string (
UP032
) (#11524) - [
flake8-bandit
]request-without-timeout
should warn forrequests.request
(#11548) - [
flake8-self
] Ignore sunder accesses inflake8-self
rules (#11546) - [
pyupgrade
] Lint forTypeAliasType
usages (UP040
) (#11530)
Server
- Respect excludes in
ruff server
configuration discovery (#11551) - Use default settings if initialization options is empty or not provided (#11566)
-
ruff server
correctly treats.pyi
files as stub files (#11535) -
ruff server
searches for configuration in parent directories (#11537) -
ruff server
: An empty code action filter no longer returns notebook source actions (#11526)
Bug fixes
- [
flake8-logging-format
] Fix autofix title inlogging-warn
(G010
) (#11514) - [
refurb
] Avoid recommendingoperator.itemgetter
with dependence on lambda arguments (#11574) - [
flake8-simplify
] Avoid recommending context manager in__enter__
implementations (#11575) - Create intermediary directories for
--output-file
(#11550) - Propagate reads on global variables (#11584)
- Treat all
singledispatch
arguments as runtime-required (#11523)
v0.4.5
Ruff's language server is now in Beta
v0.4.5
marks the official Beta release of ruff server
, an integrated language server built into Ruff.
ruff server
supports the same feature set as ruff-lsp
, powering linting, formatting, and
code fixes in Ruff's editor integrations -- but with superior performance and
no installation required. We'd love your feedback!
You can enable ruff server
in the VS Code extension today.
To read more about this exciting milestone, check out our blog post!
Rule changes
- [
flake8-future-annotations
] Rewordfuture-rewritable-type-annotation
(FA100
) message (#11381) - [
isort
] Expanded the set of standard-library modules to include_string
, etc. (#11374) - [
pycodestyle
] Consider soft keywords forE27
rules (#11446) - [
pyflakes
] Recommend adding unused import bindings to__all__
(#11314) - [
pyflakes
] Update documentation and deprecateignore_init_module_imports
(#11436) - [
pyupgrade
] Mark quotes as unnecessary for non-evaluated annotations (#11485)
Formatter
- Avoid multiline quotes warning with
quote-style = preserve
(#11490)
Server
- Support Jupyter Notebook files (#11206)
- Support
noqa
comment code actions (#11276) - Fix automatic configuration reloading (#11492)
- Fix several issues with configuration in Neovim and Helix (#11497)
CLI
- Add
--output-format
as a CLI option forruff config
(#11438)
Bug fixes
- Avoid
PLE0237
for property with setter (#11377) - Avoid
TCH005
forif
stmt withelif
/else
block (#11376) - Avoid flagging
__future__
annotations as required for non-evaluated type annotations (#11414) - Check for ruff executable in 'bin' directory as installed by 'pip install --target'. (#11450)
- Sort edits prior to deduplicating in quotation fix (#11452)
- Treat escaped newline as valid sequence (#11465)
- [
flake8-pie
] Preserve parentheses inunnecessary-dict-kwargs
(#11372) - [
pylint
] Ignore__slots__
with dynamic values (#11488) - [
pylint
] Removetry
body from branch counting (#11487) - [
refurb
] Respect operator precedence inFURB110
(#11464)
Documentation
- Add
--preview
to the README (#11395) - Add Python 3.13 to list of allowed Python versions (#11411)
- Simplify Neovim setup documentation (#11489)
- Update CONTRIBUTING.md to reflect the new parser (#11434)
- Update server documentation with new migration guide (#11499)
- [
pycodestyle
] Clarify motivation forE713
andE714
(#11483) - [
pyflakes
] Update docs to describe WAI behavior (F541) (#11362) - [
pylint
] Clearly indicate what is counted as a branch (#11423)
v0.4.4
Preview features
- [
pycodestyle
] Ignore end-of-line comments when determining blank line rules (#11342) - [
pylint
] Detectpathlib.Path.open
calls inunspecified-encoding
(PLW1514
) (#11288) - [
flake8-pyi
] ImplementPYI059
(generic-not-last-base-class
) (#11233) - [
flake8-pyi
] ImplementPYI062
(duplicate-literal-member
) (#11269)
Rule changes
- [
flake8-boolean-trap
] Allow passing booleans as positional-only arguments in code such asset(True)
(#11287) - [
flake8-bugbear
] Ignore enum classes incached-instance-method
(B019
) (#11312)
Server
- Expand tildes when resolving Ruff server configuration file (#11283)
- Fix
ruff server
hanging after Neovim closes (#11291) - Editor settings are used by default if no file-based configuration exists (#11266)
Bug fixes
- [
pylint
] Considerwith
statements fortoo-many-branches
(PLR0912
) (#11321) - [
flake8-blind-except
,tryceratops
] Respect logged and re-raised expressions in nested statements (BLE001
,TRY201
) (#11301) - Recognise assignments such as
__all__ = builtins.list(["foo", "bar"])
as valid__all__
definitions (#11335)
v0.4.3
Enhancements
- Add support for PEP 696 syntax (#11120)
Preview features
- [
refurb
] Use function range forreimplemented-operator
diagnostics (#11271) - [
refurb
] Ignore methods inreimplemented-operator
(FURB118
) (#11270) - [
refurb
] Implementfstring-number-format
(FURB116
) (#10921) - [
ruff
] Implementredirected-noqa
(RUF101
) (#11052) - [
pyflakes
] Distinguish between first-party and third-party imports for fix suggestions (#11168)
Rule changes
- [
flake8-bugbear
] Ignore non-abstract class attributes when enforcingB024
(#11210) - [
flake8-logging
] Include inline instantiations when detecting loggers (#11154) - [
pylint
] Also emitPLR0206
for properties with variadic parameters (#11200) - [
ruff
] Detect duplicate codes as part ofunused-noqa
(RUF100
) (#10850)
Formatter
- Avoid multiline expression if format specifier is present (#11123)
LSP
- Write
ruff server
setup guide for Helix (#11183) -
ruff server
no longer hangs after shutdown (#11222) -
ruff server
reads from a configuration TOML file in the user configuration directory if no local configuration exists (#11225) -
ruff server
respectsper-file-ignores
configuration (#11224) -
ruff server
: Support a custom TOML configuration file (#11140) -
ruff server
: Support setting to prioritize project configuration over editor configuration (#11086)
Bug fixes
- Avoid debug assertion around NFKC renames (#11249)
- [
pyflakes
] Prioritizeredefined-while-unused
overunused-import
(#11173) - [
ruff
] Respectasync
expressions in comprehension bodies (#11219) - [
pygrep_hooks
] Fixblanket-noqa
panic when last line has noqa with no newline (PGH004
) (#11108) - [
perflint
] Ignore list-copy recommendations for asyncfor
loops (#11250) - [
pyflakes
] Improveinvalid-print-syntax
documentation (#11171)
Performance
Windows
- Increase the minimum requirement to Windows 10.
v0.4.2
Rule changes
- [
flake8-pyi
] Allow for overloaded__exit__
and__aexit__
definitions (PYI036
) (#11057) - [
pyupgrade
] Catch usages of"%s" % var
and provide an unsafe fix (UP031
) (#11019) - [
refurb
] Implement new rule that suggests min/max oversorted()
(FURB192
) (#10868)
Server
- Fix an issue with missing diagnostics for Neovim and Helix (#11092)
- Implement hover documentation for
noqa
codes (#11096) - Introduce common Ruff configuration options with new server settings (#11062)
Bug fixes
- Use
macos-12
for building release wheels to enable macOS 11 compatibility (#11146) - [
flake8-blind-expect
] Allow raise from inBLE001
(#11131) - [
flake8-pyi
] Allow simple assignments toNone
in enum class scopes (PYI026
) (#11128) - [
flake8-simplify
] Avoid raisingSIM911
for non-zip
attribute calls (#11126) - [
refurb
] Avoidoperator.itemgetter
suggestion for single-item tuple (#11095) - [
ruff
] Respect per-file-ignores forRUF100
with no other diagnostics (#11058) - [
ruff
] Fix async comprehension false positive (RUF029
) (#11070)
Documentation
- [
flake8-bugbear
] Document explicitly disabling strict zip (B905
) (#11040) - [
flake8-type-checking
] Mentionlint.typing-modules
inTCH001
,TCH002
, andTCH003
(#11144) - [
isort
] Improve documentation around customisort
sections (#11050) - [
pylint
] Fix documentation oversight forinvalid-X-returns
(#11094)
Performance
- Use
matchit
to resolve per-file settings (#11111)
v0.4.1
Parser
- Implement re-lexing logic for better error recovery (#11845)
Rule changes
- [
flake8-copyright
] UpdateCPY001
to check the first 4096 bytes instead of 1024 (#11927) - [
pycodestyle
] UpdateE999
to show all syntax errors instead of just the first one (#11900)
Server
- Add tracing setup guide to Helix documentation (#11883)
- Add tracing setup guide to Neovim documentation (#11884)
- Defer notebook cell deletion to avoid an error message (#11864)
Security
- Guard against malicious ecosystem comment artifacts (#11879)
v0.4.0
A new, hand-written parser
Ruff's new parser is >2x faster, which translates to a 20-40% speedup for all linting and formatting invocations. There's a lot to say about this exciting change, so check out the blog post for more details!
See #10036 for implementation details.
A new language server in Rust
With this release, we also want to highlight our new language server. ruff server
is a Rust-powered language
server that comes built-in with Ruff. It can be used with any editor that supports the Language Server Protocol (LSP).
It uses a multi-threaded, lock-free architecture inspired by rust-analyzer
and it will open the door for a lot
of exciting features. It’s also faster than our previous Python-based language server
-- but you probably guessed that already.
ruff server
is only in alpha, but it has a lot of features that you can try out today:
- Lints Python files automatically and shows quick-fixes when available
- Formats Python files, with support for range formatting
- Comes with commands for quickly performing actions:
ruff.applyAutofix
,ruff.applyFormat
, andruff.applyOrganizeImports
- Supports
source.fixAll
andsource.organizeImports
source actions - Automatically reloads your project configuration when you change it
To setup ruff server
with your editor, refer to the README.md.
Preview features
- [
pycodestyle
] Do not triggerE3
rules ondef
s following a function/method with a dummy body (#10704) - [
pylint
] Implementinvalid-bytes-returned
(E0308
) (#10959) - [
pylint
] Implementinvalid-length-returned
(E0303
) (#10963) - [
pylint
] Implementself-cls-assignment
(W0642
) (#9267) - [
pylint
] Omit stubs frominvalid-bool
andinvalid-str-return-type
(#11008) - [
ruff
] New ruleunused-async
(RUF029
) to detect unneededasync
keywords on functions (#9966)
Rule changes
- [
flake8-bandit
] Allowurllib.request.urlopen
calls with staticRequest
argument (S310
) (#10964) - [
flake8-bugbear
] Treatraise NotImplemented
-only bodies as stub functions (B006
) (#10990) - [
flake8-slots
] Respect same-fileEnum
subclasses (SLOT000
) (#11006) - [
pylint
] Support inverted comparisons (PLR1730
) (#10920)
Linter
- Improve handling of builtin symbols in linter rules (#10919)
- Improve display of rules in
--show-settings
(#11003) - Improve inference capabilities of the
BuiltinTypeChecker
(#10976) - Resolve classes and functions relative to script name (#10965)
- Improve performance of
RuleTable::any_enabled
(#10971)
Server
This section is devoted to updates for our new language server, written in Rust.
- Enable ruff-specific source actions (#10916)
- Refreshes diagnostics for open files when file configuration is changed (#10988)
- Important errors are now shown as popups (#10951)
- Introduce settings for directly configuring the linter and formatter (#10984)
- Resolve configuration for each document individually (#10950)
- Write a setup guide for Neovim (#10987)
Configuration
- Add
RUFF_OUTPUT_FILE
environment variable support (#10992)
Bug fixes
- Avoid
non-augmented-assignment
for reversed, non-commutative operators (PLR6104
) (#10909) - Limit commutative non-augmented-assignments to primitive data types (
PLR6104
) (#10912) - Respect
per-file-ignores
forRUF100
on blanket# noqa
(#10908) - Consider
if
expression for parenthesized with items parsing (#11010) - Consider binary expr for parenthesized with items parsing (#11012)
- Reset
FOR_TARGET
context for all kinds of parentheses (#11009)
v0.3.7
Preview features
- [
flake8-bugbear
] Implementloop-iterator-mutation
(B909
) (#9578) - [
pylint
] Implement rule to prefer augmented assignment (PLR6104
) (#9932)
Bug fixes
- Avoid TOCTOU errors in cache initialization (#10884)
- [
pylint
] Recodenan-comparison
rule toW0177
(#10894) - [
pylint
] Reverse min-max logic inif-stmt-min-max
(#10890)
v0.3.6
Preview features
- [
pylint
] Implementbad-staticmethod-argument
(PLW0211
) (#10781) - [
pylint
] Implementif-stmt-min-max
(PLR1730
,PLR1731
) (#10002) - [
pyupgrade
] Replacestr,Enum
multiple inheritance withStrEnum
UP042
(#10713) - [
refurb
] Implementif-expr-instead-of-or-operator
(FURB110
) (#10687) - [
refurb
] Implementint-on-sliced-str
(FURB166
) (#10650) - [
refurb
] Implementwrite-whole-file
(FURB103
) (#10802) - [
refurb
] Supportitemgetter
inreimplemented-operator
(FURB118
) (#10526) - [
flake8_comprehensions
] Addsum
/min
/max
to unnecessary comprehension check (C419
) (#10759)
Rule changes
- [
pydocstyle
] Require capitalizing docstrings where the first sentence is a single word (D403
) (#10776) - [
pycodestyle
] Ignore annotated lambdas in class scopes (E731
) (#10720) - [
flake8-pyi
] Various improvements to PYI034 (#10807) - [
flake8-slots
] Flag subclasses of call-basedtyping.NamedTuple
s as well as subclasses ofcollections.namedtuple()
(SLOT002
) (#10808) - [
pyflakes
] Allow forward references in class bases in stub files (F821
) (#10779) - [
pygrep-hooks
] Improveblanket-noqa
error message (PGH004
) (#10851)
CLI
- Support
FORCE_COLOR
env var (#10839)
Configuration
- Support negated patterns in
[extend-]per-file-ignores
(#10852)
Bug fixes
- [
flake8-import-conventions
] Accept non-aliased (but correct) import inunconventional-import-alias
(ICN001
) (#10729) - [
flake8-quotes
] Add semantic model flag when inside f-string replacement field (#10766) - [
pep8-naming
] Recursively resolveTypeDicts
for N815 violations (#10719) - [
flake8-quotes
] RespectQ00*
ignores inflake8-quotes
rules (#10728) - [
flake8-simplify
] Show negated condition inneedless-bool
diagnostics (SIM103
) (#10854) - [
ruff
] Use within-scope shadowed bindings inasyncio-dangling-task
(RUF006
) (#10793) - [
flake8-pytest-style
] Fix single-tuple conversion inpytest-parametrize-values-wrong-type
(PT007
) (#10862) - [
flake8-return
] Ignore assignments to annotated variables inunnecessary-assign
(RET504
) (#10741) - [
refurb
] Do not allow any keyword arguments forread-whole-file
inrb
mode (FURB101
) (#10803) - [
pylint
] Don't recommend decorating staticmethods with@singledispatch
(PLE1519
,PLE1520
) (#10637) - [
pydocstyle
] Use section name range for all section-related docstring diagnostics (#10740) - Respect
# noqa
directives on__all__
openers (#10798)
v0.3.5
Preview features
- [
pylint
] Implementmodified-iterating-set
(E4703
) (#10473) - [
refurb
] Implementfor-loop-set-mutations
(FURB142
) (#10583) - [
refurb
] Implementunnecessary-from-float
(FURB164
) (#10647) - [
refurb
] Implementverbose-decimal-constructor
(FURB157
) (#10533)
Rule changes
- [
flake8-comprehensions
] Handled special case forC401
which also matchesC416
(#10596) - [
flake8-pyi
] Markunaliased-collections-abc-set-import
fix as "safe" for more cases in stub files (PYI025
) (#10547) - [
numpy
] Addrow_stack
to NumPy 2.0 migration rule (#10646) - [
pycodestyle
] Allow cell magics before an import (E402
) (#10545) - [
pycodestyle
] Avoid blank line rules for the first logical line in cell (#10291)
Configuration
- Respected nested namespace packages (#10541)
- [
flake8-boolean-trap
] Add setting for user defined allowed boolean trap (#10531)
Bug fixes
- Correctly handle references in
__all__
definitions when renaming symbols in autofixes (#10527) - Track ranges of names inside
__all__
definitions (#10525) - [
flake8-bugbear
] Avoid false positive for usage aftercontinue
(B031
) (#10539) - [
flake8-copyright
] Accept commas in default copyright pattern (#9498) - [
flake8-datetimez
] Allow f-strings with%z
forDTZ007
(#10651) - [
flake8-pytest-style
] FixPT014
autofix for last item in list (#10532) - [
flake8-quotes
] IgnoreQ000
,Q001
when string is inside forward ref (#10585) - [
isort
] Always place non-relative imports after relative imports (#10669) - [
isort
] Respect Unicode characters in import sorting (#10529) - [
pyflakes
] Fix F821 false negatives whenfrom __future__ import annotations
is active (attempt 2) (#10524) - [
pyflakes
] Makeunnecessary-lambda
an always-unsafe fix (#10668) - [
pylint
] Fixed false-positive on the rulePLW1641
(eq-without-hash
) (#10566) - [
ruff
] Fix panic in unused# noqa
removal with multi-byte space (RUF100
) (#10682)
Documentation
- Add MR title format to
CONTRIBUTING.md
(#10665) - Fix list markup to include blank lines required (#10591)
- Put
flake8-logging
next to the other flake8 plugins in registry (#10587) - [
flake8-bandit
] Update warning message for ruleS305
to address insecure block cipher mode use (#10602) - [
flake8-bugbear
] Document use of anonymous assignment inuseless-expression
(#10551) - [
flake8-datetimez
] Clarify error messages and docs forDTZ
rules (#10621) - [
pycodestyle
] Use same before vs. after numbers forspace-around-operator
(#10640) - [
ruff
] Changequadratic-list-summation
docs to useiadd
consistently (#10666)
v0.3.4
Preview features
- [
flake8-simplify
] Detect implicitelse
cases inneedless-bool
(SIM103
) (#10414) - [
pylint
] Implementnan-comparison
(PLW0117
) (#10401) - [
pylint
] Implementnonlocal-and-global
(E115
) (#10407) - [
pylint
] Implementsingledispatchmethod-function
(PLE5120
) (#10428) - [
refurb
] Implementlist-reverse-copy
(FURB187
) (#10212)
Rule changes
- [
flake8-pytest-style
] Add automatic fix forpytest-parametrize-values-wrong-type
(PT007
) (#10461) - [
pycodestyle
] Allow SPDX license headers to exceed the line length (E501
) (#10481)
Formatter
- Fix unstable formatting for trailing subscript end-of-line comment (#10492)
Bug fixes
- Avoid code comment detection in PEP 723 script tags (#10464)
- Avoid incorrect tuple transformation in single-element case (
C409
) (#10491) - Bug fix: Prevent fully defined links
name
from being reformatted (#10442) - Consider raw source code for
W605
(#10480) - Docs: Link inline settings when not part of options section (#10499)
- Don't treat annotations as redefinitions in
.pyi
files (#10512) - Fix
E231
bug: Inconsistent catch compared to pycodestyle, such as when dict nested in list (#10469) - Fix pylint upstream categories not showing in docs (#10441)
- Add missing
Options
references to blank line docs (#10498) - 'Revert "F821: Fix false negatives in .py files when
from __future__ import annotations
is active (#10362)"' (#10513) - Apply NFKC normalization to unicode identifiers in the lexer (#10412)
- Avoid failures due to non-deterministic binding ordering (#10478)
- [
flake8-bugbear
] Allow tuples of exceptions (B030
) (#10437) - [
flake8-quotes
] Avoid syntax errors due to invalid quotes (Q000, Q002
) (#10199)
v0.3.3
Preview features
- [
flake8-bandit
]: ImplementS610
rule (#10316) - [
pycodestyle
] Implementblank-line-at-end-of-file
(W391
) (#10243) - [
pycodestyle
] Implementredundant-backslash
(E502
) (#10292) - [
pylint
] - implementredeclared-assigned-name
(W0128
) (#9268)
Rule changes
- [
flake8_comprehensions
] Handled special case forC400
which also matchesC416
(#10419) - [
flake8-bandit
] Implement upstream updates forS311
,S324
andS605
(#10313) - [
pyflakes
] RemoveF401
fix for__init__
imports by default and allow opt-in to unsafe fix (#10365) - [
pylint
] Implementinvalid-bool-return-type
(E304
) (#10377) - [
pylint
] Include builtin warnings in useless-exception-statement (PLW0133
) (#10394)
CLI
- Add message on success to
ruff check
(#8631)
Bug fixes
- [
PIE970
] Allow trailing ellipsis intyping.TYPE_CHECKING
(#10413) - Avoid
TRIO115
if the argument is a variable (#10376) - [
F811
] Avoid removing shadowed imports that point to different symbols (#10387) - Fix
F821
andF822
false positives in.pyi
files (#10341) - Fix
F821
false negatives in.py
files whenfrom __future__ import annotations
is active (#10362) - Fix case where
Indexer
fails to identify continuation preceded by newline #10351 (#10354) - Sort hash maps in
Settings
display (#10370) - Track conditional deletions in the semantic model (#10415)
- [
C413
] Wrap expressions in parentheses when negating (#10346) - [
pycodestyle
] Do not ignore lines before the first logical line in blank lines rules. (#10382) - [
pycodestyle
] Do not triggerE225
andE275
when the next token is a ')' (#10315) - [
pylint
] Avoid false-positive slot non-assignment for__dict__
(PLE0237
) (#10348) - Gate f-string struct size test for Rustc < 1.76 (#10371)
Documentation
- Use
ruff.toml
format in README (#10393) - [
RUF008
] Make it clearer that a mutable default in a dataclass is only valid if it is typed as a ClassVar (#10395) - [
pylint
] Extend docs and test ininvalid-str-return-type
(E307
) (#10400) - Remove
.
fromcheck
andformat
commands (#10217)
v0.3.2
Preview features
- Improve single-
with
item formatting for Python 3.8 or older (#10276)
Rule changes
- [
pyupgrade
] Allow fixes for f-string rule regardless of line length (UP032
) (#10263) - [
pycodestyle
] Include actual conditions in E712 diagnostics (#10254)
Bug fixes
- Fix trailing kwargs end of line comment after slash (#10297)
- Fix unstable
with
items formatting (#10274) - Avoid repeating function calls in f-string conversions (#10265)
- Fix E203 false positive for slices in format strings (#10280)
- Fix incorrect
Parameter
range for*args
and**kwargs
(#10283) - Treat
typing.Annotated
subscripts as type definitions (#10285)
v0.3.1
Preview features
- [
pycodestyle
] Fix E301 not triggering on decorated methods. (#10117) - [
pycodestyle
] Respectisort
settings in blank line rules (E3*
) (#10096) - [
pycodestyle
] Make blank lines in typing stub files optional (E3*
) (#10098) - [
pylint
] Implementsingledispatch-method
(E1519
) (#10140) - [
pylint
] Implementuseless-exception-statement
(W0133
) (#10176)
Rule changes
- [
flake8-debugger
] Check for use ofdebugpy
andptvsd
debug modules (#10177) (#10194) - [
pyupgrade
] Generate diagnostic for all valid f-string conversions regardless of line length (UP032
) (#10238) - [
pep8_naming
] Add fixes forN804
andN805
(#10215)
CLI
- Colorize the output of
ruff format --diff
(#10110) - Make
--config
and--isolated
global flags (#10150) - Correctly expand tildes and environment variables in paths passed to
--config
(#10219)
Configuration
- Accept a PEP 440 version specifier for
required-version
(#10216) - Implement isort's
default-section
setting (#10149)
Bug fixes
- Remove trailing space from
CapWords
message (#10220) - Respect external codes in file-level exemptions (#10203)
- [
flake8-raise
] Avoid false-positives for parens-on-raise withfuture.exception()
(RSE102
) (#10206) - [
pylint
] Add fix for unary expressions inPLC2801
(#9587) - [
ruff
] Fix RUF028 not allowing# fmt: skip
on match cases (#10178)
v0.3.0
This release introduces the new Ruff formatter 2024.2 style and adds a new lint rule to detect invalid formatter suppression comments.
Preview features
- [
flake8-bandit
] Remove suspicious-lxml-import (S410
) (#10154) - [
pycodestyle
] Allowos.environ
modifications between imports (E402
) (#10066) - [
pycodestyle
] Don't warn about a single whitespace character before a comma in a tuple (E203
) (#10094)
Rule changes
- [
eradicate
] Detect commented outcase
statements (ERA001
) (#10055) - [
eradicate
] Detect single-line code fortry:
,except:
, etc. (ERA001
) (#10057) - [
flake8-boolean-trap
] Allow boolean positionals in__post_init__
(#10027) - [
flake8-copyright
] Allow © in copyright notices (#10065) - [
isort
]: Use one blank line after imports in typing stub files (#9971) - [
pylint
] New Ruledict-iter-missing-items
(PLE1141
) (#9845) - [
pylint
] Ignoresys.version
andsys.platform
(PLR1714
) (#10054) - [
pyupgrade
] Detect literals with unary operators (UP018
) (#10060) - [
ruff
] Expand rule forlist(iterable).pop(0)
idiom (RUF015
) (#10148)
Formatter
This release introduces the Ruff 2024.2 style, stabilizing the following changes:
- Prefer splitting the assignment's value over the target or type annotation (#8943)
- Remove blank lines before class docstrings (#9154)
- Wrap multiple context managers in
with
parentheses when targeting Python 3.9 or newer (#9222) - Add a blank line after nested classes with a dummy body (
...
) in typing stub files (#9155) - Reduce vertical spacing for classes and functions with a dummy (
...
) body (#7440, #9240) - Add a blank line after the module docstring (#8283)
- Parenthesize long type hints in assignments (#9210)
- Preserve indent for single multiline-string call-expressions (#9673)
- Normalize hex escape and unicode escape sequences (#9280)
- Format module docstrings (#9725)
CLI
- Explicitly disallow
extend
as part of a--config
flag (#10135) - Remove
build
from the default exclusion list (#10093) - Deprecate
ruff <path>
,ruff --explain
,ruff --clean
, andruff --generate-shell-completion
in favor ofruff check <path>
,ruff rule
,ruff clean
, andruff generate-shell-completion
(#10169) - Remove the deprecated CLI option
--format
fromruff rule
andruff linter
(#10170)
Bug fixes
- [
flake8-bugbear
] Avoid adding default initializers to stubs (B006
) (#10152) - [
flake8-type-checking
] Respect runtime-required decorators for function signatures (#10091) - [
pycodestyle
] Mark fixes overlapping with a multiline string as unsafe (W293
) (#10049) - [
pydocstyle
] Trim whitespace when removing blank lines after section (D413
) (#10162) - [
pylint
] Delete entire statement, including semicolons (PLR0203
) (#10074) - [
ruff
] Avoid f-string false positives ingettext
calls (RUF027
) (#10118) - Fix
ruff
crashing on PowerPC systems because of too small page size (#10080)
Performance
- Add cold attribute to less likely printer queue branches in the formatter (#10121)
- Skip unnecessary string normalization in the formatter (#10116)
Documentation
- Remove "Beta" Label from formatter documentation (#10144)
-
line-length
option: fix link topycodestyle.max-line-length
(#10136)
v0.2.2
Highlights include:
- Initial support formatting f-strings (in
--preview
). - Support for overriding arbitrary configuration options via the CLI through an expanded
--config
argument (e.g.,--config "lint.isort.combine-as-imports=false"
). - Significant performance improvements in Ruff's lexer, parser, and lint rules.
Preview features
- Implement minimal f-string formatting (#9642)
- [
pycodestyle
] Add blank line(s) rules (E301
,E302
,E303
,E304
,E305
,E306
) (#9266) - [
refurb
] Implementreadlines_in_for
(FURB129
) (#9880)
Rule changes
- [
ruff
] Ensure closing parentheses for multiline sequences are always on their own line (RUF022
,RUF023
) (#9793) - [
numpy
] Add missing deprecation violations (NPY002
) (#9862) - [
flake8-bandit
] Detectmark_safe
usages in decorators (#9887) - [
ruff
] Expandasyncio-dangling-task
(RUF006
) to includenew_event_loop
(#9976) - [
flake8-pyi
] Ignore 'unused' private type dicts in class scopes (#9952)
Formatter
- Docstring formatting: Preserve tab indentation when using
indent-style=tabs
(#9915) - Disable top-level docstring formatting for notebooks (#9957)
- Stabilize quote-style's
preserve
mode (#9922)
CLI
- Allow arbitrary configuration options to be overridden via the CLI (#9599)
Bug fixes
- Make
show-settings
filters directory-agnostic (#9866) - Respect duplicates when rewriting type aliases (#9905)
- Respect tuple assignments in typing analyzer (#9969)
- Use atomic write when persisting cache (#9981)
- Use non-parenthesized range for
DebugText
(#9953) - [
flake8-simplify
] Avoid false positive withasync
for loops (SIM113
) (#9996) - [
flake8-trio
] Respectasync with
intimeout-without-await
(#9859) - [
perflint
] Catch a wider range of mutations inPERF101
(#9955) - [
pycodestyle
] FixE30X
panics on blank lines with trailing white spaces (#9907) - [
pydocstyle
] Allow usingparameters
as a subsection header (D405
) (#9894) - [
pydocstyle
] Fix blank-line docstring rules for module-level docstrings (#9878) - [
pylint
] Accept 0.0 and 1.0 as common magic values (PLR2004
) (#9964) - [
pylint
] Avoid suggesting set rewrites for non-hashable types (#9956) - [
ruff
] Avoid false negatives with string literals inside of method calls (RUF027
) (#9865) - [
ruff
] Fix panic on with f-string detection (RUF027
) (#9990) - [
ruff
] Ignore builtins when detecting missing f-strings (#9849)
Performance
- Use
memchr
for string lexing (#9888) - Use
memchr
for tab-indentation detection (#9853) - Reduce
Result<Tok, LexicalError>
size by usingBox<str>
instead ofString
(#9885) - Reduce size of
Expr
from 80 to 64 bytes (#9900) - Improve trailing comma rule performance (#9867)
- Remove unnecessary string cloning from the parser (#9884)
v0.2.1
This release includes support for range formatting (i.e., the ability to format specific lines within a source file).
Preview features
- [
refurb
] Implementmissing-f-string-syntax
(RUF027
) (#9728) - Format module-level docstrings (#9725)
Formatter
Bug fixes
- Skip empty lines when determining base indentation (#9795)
- Drop
__get__
and__set__
fromunnecessary-dunder-call
(#9791) - Respect generic
Protocol
in ellipsis removal (#9841) - Revert "Use publicly available Apple Silicon runners (#9726)" (#9834)
Performance
- Skip LibCST parsing for standard dedent adjustments (#9769)
- Remove CST-based fixer for
C408
(#9822) - Add our own ignored-names abstractions (#9802)
- Remove CST-based fixers for
C400
,C401
,C410
, andC418
(#9819) - Use
AhoCorasick
to speed up quote match (#9773) - Remove CST-based fixers for
C405
andC409
(#9821) - Add fast-path for comment detection (#9808)
- Invert order of checks in
zero-sleep-call
(#9766) - Short-circuit typing matches based on imports (#9800)
- Run dunder method rule on methods directly (#9815)
- Track top-level module imports in the semantic model (#9775)
- Slight speed-up for lowercase and uppercase identifier checks (#9798)
- Remove LibCST-based fixer for
C403
(#9818)
Documentation
- Update
max-pos-args
example tomax-positional-args
(#9797) - Fixed example code in
weak_cryptographic_key.rs
(#9774) - Fix references to deprecated
ANN
rules in changelog (#9771) - Fix default for
max-positional-args
(#9838)
v0.2.0
Breaking changes
- The
NURSERY
selector cannot be used anymore - Legacy selection of nursery rules by exact codes is no longer allowed without preview enabled
See also, the "Remapped rules" section which may result in disabled rules.
Deprecations
The following rules are now deprecated:
-
missing-type-self
(ANN101
) -
missing-type-cls
(ANN102
)
The following command line options are now deprecated:
-
--show-source
; use--output-format full
instead -
--no-show-source
; use--output-format concise
instead -
--output-format text
; usefull
orconcise
instead
The following settings have moved and the previous name is deprecated:
-
ruff.allowed-confusables
→ruff.lint.allowed-confusables
-
ruff.dummy-variable-rgx
→ruff.lint.dummy-variable-rgx
-
ruff.explicit-preview-rules
→ruff.lint.explicit-preview-rules
-
ruff.extend-fixable
→ruff.lint.extend-fixable
-
ruff.extend-ignore
→ruff.lint.extend-ignore
-
ruff.extend-per-file-ignores
→ruff.lint.extend-per-file-ignores
-
ruff.extend-safe-fixes
→ruff.lint.extend-safe-fixes
-
ruff.extend-select
→ruff.lint.extend-select
-
ruff.extend-unfixable
→ruff.lint.extend-unfixable
-
ruff.extend-unsafe-fixes
→ruff.lint.extend-unsafe-fixes
-
ruff.external
→ruff.lint.external
-
ruff.fixable
→ruff.lint.fixable
-
ruff.flake8-annotations
→ruff.lint.flake8-annotations
-
ruff.flake8-bandit
→ruff.lint.flake8-bandit
-
ruff.flake8-bugbear
→ruff.lint.flake8-bugbear
-
ruff.flake8-builtins
→ruff.lint.flake8-builtins
-
ruff.flake8-comprehensions
→ruff.lint.flake8-comprehensions
-
ruff.flake8-copyright
→ruff.lint.flake8-copyright
-
ruff.flake8-errmsg
→ruff.lint.flake8-errmsg
-
ruff.flake8-gettext
→ruff.lint.flake8-gettext
-
ruff.flake8-implicit-str-concat
→ruff.lint.flake8-implicit-str-concat
-
ruff.flake8-import-conventions
→ruff.lint.flake8-import-conventions
-
ruff.flake8-pytest-style
→ruff.lint.flake8-pytest-style
-
ruff.flake8-quotes
→ruff.lint.flake8-quotes
-
ruff.flake8-self
→ruff.lint.flake8-self
-
ruff.flake8-tidy-imports
→ruff.lint.flake8-tidy-imports
-
ruff.flake8-type-checking
→ruff.lint.flake8-type-checking
-
ruff.flake8-unused-arguments
→ruff.lint.flake8-unused-arguments
-
ruff.ignore
→ruff.lint.ignore
-
ruff.ignore-init-module-imports
→ruff.lint.ignore-init-module-imports
-
ruff.isort
→ruff.lint.isort
-
ruff.logger-objects
→ruff.lint.logger-objects
-
ruff.mccabe
→ruff.lint.mccabe
-
ruff.pep8-naming
→ruff.lint.pep8-naming
-
ruff.per-file-ignores
→ruff.lint.per-file-ignores
-
ruff.pycodestyle
→ruff.lint.pycodestyle
-
ruff.pydocstyle
→ruff.lint.pydocstyle
-
ruff.pyflakes
→ruff.lint.pyflakes
-
ruff.pylint
→ruff.lint.pylint
-
ruff.pyupgrade
→ruff.lint.pyupgrade
-
ruff.select
→ruff.lint.select
-
ruff.task-tags
→ruff.lint.task-tags
-
ruff.typing-modules
→ruff.lint.typing-modules
-
ruff.unfixable
→ruff.lint.unfixable
Remapped rules
The following rules have been remapped to new codes:
-
raise-without-from-inside-except
:TRY200
toB904
-
suspicious-eval-usage
:PGH001
toS307
-
logging-warn
:PGH002
toG010
-
static-key-dict-comprehension
:RUF011
toB035
-
runtime-string-union
:TCH006
toTCH010
Stabilizations
The following rules have been stabilized and are no longer in preview:
-
trio-timeout-without-await
(TRIO100
) -
trio-sync-call
(TRIO105
) -
trio-async-function-with-timeout
(TRIO109
) -
trio-unneeded-sleep
(TRIO110
) -
trio-zero-sleep-call
(TRIO115
) -
unnecessary-escaped-quote
(Q004
) -
enumerate-for-loop
(SIM113
) -
zip-dict-keys-and-values
(SIM911
) -
timeout-error-alias
(UP041
) -
flask-debug-true
(S201
) -
tarfile-unsafe-members
(S202
) -
ssl-insecure-version
(S502
) -
ssl-with-bad-defaults
(S503
) -
ssl-with-no-version
(S504
) -
weak-cryptographic-key
(S505
) -
ssh-no-host-key-verification
(S507
) -
django-raw-sql
(S611
) -
mako-templates
(S702
) -
generator-return-from-iter-method
(PYI058
) -
runtime-string-union
(TCH006
) -
numpy2-deprecation
(NPY201
) -
quadratic-list-summation
(RUF017
) -
assignment-in-assert
(RUF018
) -
unnecessary-key-check
(RUF019
) -
never-union
(RUF020
) -
direct-logger-instantiation
(LOG001
) -
invalid-get-logger-argument
(LOG002
) -
exception-without-exc-info
(LOG007
) -
undocumented-warn
(LOG009
)
Fixes for the following rules have been stabilized and are now available without preview:
-
triple-single-quotes
(D300
) -
non-pep604-annotation
(UP007
) -
dict-get-with-none-default
(SIM910
) -
in-dict-keys
(SIM118
) -
collapsible-else-if
(PLR5501
) -
if-with-same-arms
(SIM114
) -
useless-else-on-loop
(PLW0120
) -
unnecessary-literal-union
(PYI030
) -
unnecessary-spread
(PIE800
) -
error-instead-of-exception
(TRY400
) -
redefined-while-unused
(F811
) -
duplicate-value
(B033
) -
multiple-imports-on-one-line
(E401
) -
non-pep585-annotation
(UP006
)
Fixes for the following rules have been promoted from unsafe to safe:
-
unaliased-collections-abc-set-import
(PYI025
)
The following behaviors have been stabilized:
-
module-import-not-at-top-of-file
(E402
) allowssys.path
modifications between imports -
reimplemented-container-builtin
(PIE807
) includes lambdas that can be replaced withdict
-
unnecessary-placeholder
(PIE790
) applies to unnecessary ellipses (...
) -
if-else-block-instead-of-dict-get
(SIM401
) applies toif-else
expressions
Preview features
- [
refurb
] Implementmetaclass_abcmeta
(FURB180
) (#9658) - Implement
blank_line_after_nested_stub_class
preview style (#9155) - The preview rule
and-or-ternary
(PLR1706
) was removed
Bug fixes
- [
flake8-async
] Takepathlib.Path
into account when analyzing async functions (#9703) - [
flake8-return
] - fix indentation syntax error (RET505
) (#9705) - Detect multi-statement lines in else removal (#9748)
-
RUF022
,RUF023
: never add two trailing commas to the end of a sequence (#9698) -
RUF023
: Don't sort__match_args__
, only__slots__
(#9724) - [
flake8-simplify
] - Fix syntax error in autofix (SIM114
) (#9704) - [
pylint
] Show verbatim constant inmagic-value-comparison
(PLR2004
) (#9694) - Removing trailing whitespace inside multiline strings is unsafe (#9744)
- Support
IfExp
with dual string arms ininvalid-envvar-default
(#9734) - [
pylint
] Add__mro_entries__
to known dunder methods (PLW3201
) (#9706)
Documentation
Configuration
-
If you want to rebase/retry this MR, check this box
This MR has been generated by Renovate Bot.