Add this suggestion to a batch that can be applied as a single commit.
This suggestion is invalid because no changes were made to the code.
Suggestions cannot be applied while the pull request is closed.
Suggestions cannot be applied while viewing a subset of changes.
Only one suggestion per line can be applied in a batch.
Add this suggestion to a batch that can be applied as a single commit.
Applying suggestions on deleted lines is not supported.
You must change the existing code in this line in order to create a valid suggestion.
Outdated suggestions cannot be applied.
This suggestion has been applied or marked resolved.
Suggestions cannot be applied from pending reviews.
Suggestions cannot be applied on multi-line comments.
Suggestions cannot be applied while the pull request is queued to merge.
Suggestion cannot be applied right now. Please check back later.
This PR contains the following updates:
2.17.7
->3.0.2
Release Notes
pylint-dev/pylint (pylint)
v3.0.2
Compare Source
False Positives Fixed
Fix
used-before-assignment
false positive for generic type syntax (PEP 695, Python 3.12).Closes #9110
Other Bug Fixes
Escape special symbols and newlines in messages.
Closes #7874
Fixes suggestion for
nested-min-max
for expressions with additive operators, list and dict comprehensions.Closes #8524
Fixes ignoring conditional imports with
ignore-imports=y
.Closes #8914
Emit
inconsistent-quotes
for f-strings with 3.12 interpreter only if targeting pre-3.12 versions.Closes #9113
v3.0.1
False Positives Fixed
Fixed false positive for
inherit-non-class
for generic Protocols.Closes #9106
Other Changes
Fix a crash when an enum class which is also decorated with a
dataclasses.dataclass
decorator is defined.Closes #9100
v3.0.0
Pylint now support python 3.12 officially.
This long anticipated major version also provides some important usability and performance improvements, along with enacting necessary breaking changes and long-announced deprecations. The documentation of each message with an example is very close too.
The required astroid version is now 3.0.0. See the astroid changelog for additional fixes, features, and performance improvements applicable to pylint.
Our code is now fully typed. The invalid-name message no longer checks for a minimum length of 3 characters by default. Dependencies like wrapt or setuptools were removed.
A new json2 reporter has been added. It features an enriched output that is easier to parse and provides more info, here's a sample output.
Breaking Changes
Enabling or disabling individual messages will now take effect even if an
--enable=all
ordisable=all
follows in the same configuration file(or on the command line).
This means for the following example,
fixme
messages will now be emitted:To regain the prior behavior, remove the superfluous earlier option.
Closes #3696
Remove support for launching pylint with Python 3.7.
Code that supports Python 3.7 can still be linted with the
--py-version=3.7
setting.Refs #6306
Disables placed in a
try
block now apply to theexcept
block.Previously, they only happened to do so in the presence of an
else
clause.Refs #7767
pyreverse
now uses a new default color palette that is more colorblind friendly.The color scheme is taken from
Paul Tol's Notes <https://personal.sron.nl/~pault/>
_.If you prefer other colors, you can use the
--color-palette
option to specify custom colors.Closes #8251
Everything related to the
__implements__
construct was removed. It was based on PEP245that was proposed in 2001 and rejected in 2006.
The capability from pyreverse to take
__implements__
into account when generating diagramswas also removed.
Refs #8404
pyreverse
: Support for the.vcg
output format (Visualization of Compiler Graphs) has been dropped.Closes #8416
The warning when the now useless old pylint cache directory (pylint.d) was
found was removed. The cache dir is documented in
the FAQ <https://pylint.readthedocs.io/en/latest/faq.html#where-is-the-persistent-data-stored-to-compare-between-successive-runs>
_.Refs #8462
Following a deprecation period,
pylint.config.PYLINTRC
was removed.Use the
pylint.config.find_default_config_files
generator instead.Closes #8862
Changes requiring user actions
The
invalid-name
message no longer checks for a minimum length of 3 characters by default.(This was an unadvertised commingling of concerns between casing
and name length, and users regularly reported this to be surprising.)
If checking for a minimum length is still desired, it can be regained in two ways:
If you are content with a
disallowed-name
message (instead ofinvalid-name
), then simply add the optionbad-names-rgxs="^..?$"
,which will fail 1-2 character-long names. (Ensure you enable
disallowed-name
.)If you would prefer an
invalid-name
message to be emitted, or wouldprefer finer-grained control over the circumstances in which messages are
emitted (classes vs. methods, etc.), then avail yourself of the regex
options described
here <https://pylint.readthedocs.io/en/stable/user_guide/configuration/all-options.html#main-checker>
.(In particular, take note of the commented out options in the "example
configuration" given at the bottom of the section.) The prior regexes can
be found in the
pull request <https://github.com/pylint-dev/pylint/pull/8813>
that removed the length requirements.
Closes #2018
The compare to empty string checker (
pylint.extensions.emptystring
) and the compare tozero checker (
pylint.extensions.compare-to-zero
) have been removed and their checks arenow part of the implicit booleaness checker:
compare-to-zero
was renameduse-implicit-booleaness-not-comparison-to-zero
andcompare-to-empty-string
was renameduse-implicit-booleaness-not-comparison-to-string
and they now need to be enabled explicitly.
The
pylint.extensions.emptystring
andpylint.extensions.compare-to-zero
extensionsno longer exist and need to be removed from the
load-plugins
option.Messages related to implicit booleaness were made more explicit and actionable.
This permits to make their likeness explicit and will provide better performance as they
share most of their conditions to be raised.
Closes #6871
epylint was removed. It now lives at: https://github.com/emacsorphanage/pylint.
Refs #7737
The
overgeneral-exceptions
option now only takes fully qualified namesinto account (
builtins.Exception
notException
). If you overrodethis option, you need to use the fully qualified name now.
There's still a warning, but it will be removed in 3.1.0.
Refs #8411
Following a deprecation period, it's no longer possible to use
MASTER
or
master
as configuration section insetup.cfg
ortox.ini
. It's bad practiceto not start a section title with the tool name. Please use
pylint.main
instead.Refs #8465
Package stats are now printed when running Pyreverse and a
--verbose
flag was added to get the original output with parsed modules. You might need to activate the verbose option if you want to keep the old output.Closes #8973
New Features
A new
json2
reporter has been added. It features a more enriched output that iseasier to parse and provides more info.
Compared to
json
the only changes are that messages are now under the"messages"
key and that
"message-id"
now follows the camelCase convention and is renamed to"messageId"
.The new reporter also reports the "score" of the modules you linted as defined by the
evaluation
option and provides statistics about the modules you linted.We encourage users to use the new reporter as the
json
reporter will no longerbe maintained.
Closes #4741
In Pyreverse package dependency diagrams, show when a module imports another only for type-checking.
Closes #8112
Add new option (
--show-stdlib
,-L
) topyreverse
.This is similar to the behavior of
--show-builtin
in that standard librarymodules are now not included by default, and this option will include them.
Closes #8181
Add Pyreverse option to exclude standalone nodes from diagrams with
--no-standalone
.Closes #8476
New Checks
Added
DataclassChecker
module andinvalid-field-call
checker to check for invalid dataclasses.field() usage.Refs #5159
Add
return-in-finally
to emit a message if a return statement was found in a finally clause.Closes #8260
Add a new checker
kwarg-superseded-by-positional-arg
to warn when a function is called with a keyword argument which shares a name with a positional-only parameter and the function contains a keyword variadic parameter dictionary. It may be surprising behaviour when the keyword argument is added to the keyword variadic parameter dictionary.Closes #8558
Extensions
Add new
prefer-typing-namedtuple
message to theCodeStyleChecker
to suggestrewriting calls to
collections.namedtuple
as classes inheriting fromtyping.NamedTuple
on Python 3.6+.
Requires
load-plugins=pylint.extensions.code_style
andenable=prefer-typing-namedtuple
to be raised.Closes #8660
False Positives Fixed
Extend concept of "function ambiguity" in
safe_infer()
fromdiffering number of function arguments to differing set of argument names.
Solves false positives in
tensorflow
.Closes #3613
Fix
unused-argument
false positive when__new__
does not use all the arguments of__init__
.Closes #3670
Fix a false positive for
invalid-name
when a type-annotated class variable in anenum.Enum
class has no assigned value.Refs #7402
Fix
unused-import
false positive for usage ofsix.with_metaclass
.Closes #7506
Fix false negatives and false positives for
too-many-try-statements
,too-complex
, andtoo-many-branches
by correctly counting statementsunder a
try
.Refs #7767
When checking for unbalanced dict unpacking in for-loops, Pylint will now test whether the length of each value to be
unpacked matches the number of unpacking targets. Previously, Pylint would test the number of values for the loop
iteration, which would produce a false unbalanced-dict-unpacking warning.
Closes #8156
Fix false positive for
used-before-assignment
when usage and assignmentare guarded by the same test in different statements.
Closes #8167
Adds
asyncSetUp
to the defaultdefining-attr-methods
list to silenceattribute-defined-outside-init
warning when usingunittest.IsolatedAsyncioTestCase
.Refs #8403
logging-not-lazy
is not longer emitted for explicitly concatenated string arguments.Closes #8410
Fix false positive for isinstance-second-argument-not-valid-type when union types contains None.
Closes #8424
invalid-name
now allows for integers intypealias
names:Good2Name
,GoodName2
._1BadName
.Closes #8485
No longer consider
Union
as type annotation as type alias for naming checks.Closes #8487
unnecessary-lambda
no longer warns on lambdas which use its parameters intheir body (other than the final arguments), e.g.
lambda foo: (bar if foo else baz)(foo)
.Closes #8496
Fixed
unused-import
so that it observes thedummy-variables-rgx
option.Closes #8500
Union
typed variables without assignment are no longer treated asTypeAlias
.Closes #8540
Allow parenthesized implicitly concatenated strings when
check-str-concat-over-line-jumps
is enabled.Closes #8552.
Fix false positive for
positional-only-arguments-expected
when a function contains both a positional-only parameter that has a default value, and**kwargs
.Closes #8555
Fix false positive for
keyword-arg-before-vararg
when a positional-only parameter with a default value precedes*args
.Closes #8570
Fix false positive for
arguments-differ
when overriding__init_subclass__
.Closes #8919
Fix a false positive for
no-value-for-parameter
when a staticmethod is called in a class body.Closes #9036
False Negatives Fixed
Emit
used-before-assignment
when calling module-level functions before definition.Closes #1144
Apply
infer_kwarg_from_call()
to more checksThese mostly solve false negatives for various checks,
save for one false positive for
use-maxsplit-arg
.Closes #7761
TypeAlias
variables defined in functions are now checked forinvalid-name
errors.Closes #8536
Fix false negative for
no-value-for-parameter
when a function, whose signature contains both a positional-only parametername
and also*kwargs
, is called with a keyword-argument forname
.Closes #8559
Fix a false negative for
too-many-arguments
by considering positional-only and keyword-only parameters.Closes #8667
Emit
assignment-from-no-return
for calls to builtin methods likedict.update()
.Calls to
list.sort()
now raiseassignment-from-no-return
rather than
assignment-from-none
for consistency.Closes #8714
Closes #8810
consider-using-augmented-assign
is now applied to dicts and lists as well.Closes #8959
Other Bug Fixes
Support
duplicate-code
message when parallelizing with--jobs
.Closes #374
Support
cyclic-import
message when parallelizing with--jobs
.Closes #4171
--jobs
can now be used with--load-plugins
.This had regressed in astroid 2.5.0.
Closes #4874
docparams extension considers type comments as type documentation.
Closes #6287
When parsing comma-separated lists of regular expressions in the config, ignore
commas that are inside braces since those indicate quantifiers, not delineation
between expressions.
Closes #7229
The
ignored-modules
option will now be correctly taken into account forno-name-in-module
.Closes #7578
sys.argv
is now always correctly considered as impossible to infer (instead ofusing the actual values given to pylint).
Closes #7710
Avoid duplicative warnings for unqualified exception names in the
overgeneral-exceptions
setting when running with
--jobs
.Closes #7774
Don't show class fields more than once in Pyreverse diagrams.
Closes #8189
Fix
used-before-assignment
false negative when TYPE_CHECKING importsare used in multiple scopes.
Closes #8198
--clear-cache-post-run
now also clears LRU caches for pylint utilitiesholding references to AST nodes.
Closes #8361
Fix a crash when
TYPE_CHECKING
is used without importing it.Closes #8434
Fix a
used-before-assignment
false positive when importsare made under the
TYPE_CHECKING
else if branch.Closes #8437
Fix a regression of
preferred-modules
where a partial match was used instead of the required full match.Closes #8453
Fix a crash in pyreverse when "/" characters are used in the output filename e.g pyreverse -o png -p name/ path/to/project.
Closes #8504
Don't show arrows more than once in Pyreverse diagrams.
Closes #8522
Improve output of
consider-using-generator
message formin()
calls withdefault
keyword.Closes #8563
Fixed a crash when generating a configuration file:
tomlkit.exceptions.TOMLKitError: Can't add a table to a dotted key
caused by tomlkit
v0.11.8
.Closes #8632
Fix a line break error in Pyreverse dot output.
Closes #8671
Fix a false positive for
method-hidden
when usingcached_property
decorator.Closes #8753
Dunder methods defined in lambda do not trigger
unnecessary-dunder-call
anymore, if they cannot be replaced by the non-dunder call.Closes #8769
Don't show duplicate type annotations in Pyreverse diagrams.
Closes #8888
Fixing inconsistent hashing issue in
BaseChecker
causing some reports not being exported.Closes #9001
Don't add
Optional
to|
annotations withNone
in Pyreverse diagrams.Closes #9014
Pyreverse doesn't show multiple class association arrows anymore, but only the strongest one.
Refs #9045
Prevented data loss in the linter stats for messages relating
to the linter itself (e.g.
unknown-option-value
), fixingproblems with score, fail-on, etc.
Closes #9059
Fix crash in refactoring checker when unary operand used with variable in for loop.
Closes #9074
Other Changes
Pylint now exposes its type annotations.
Closes #5488 and #2079
Search for
pyproject.toml
recursively in parent directories up to a project or file system root.Refs #7163, Closes #3289
All code related to the optparse config parsing has been removed.
Refs #8405
Pylint now supports python 3.12.
Refs #8718
Add a CITATION.cff file to the root of the repository containing the necessary metadata to cite Pylint.
Closes #8760
Renamed the "unneeded-not" error into "unnecessary_negation" to be clearer.
Closes #8789
Internal Changes
get_message_definition
was removed from the base checker API. You can accessmessage definitions through the
MessageStore
.Refs #8401
Everything related to the
__implements__
construct was removed. It was based on PEP245that was proposed in 2001 and rejected in 2006.
All the classes inheriting
Interface
inpylint.interfaces
were removed.Checker
should only inheritBaseChecker
or any of the other checker typesfrom
pylint.checkers
.Reporter
should only inheritBaseReporter
.Refs #8404
modname
andmsg_store
are now required to be given inFileState
.collect_block_lines
has also been removed.Pylinter.current_name
cannot be null anymore.
Refs #8407
Reporter.set_output
was removed in favor ofreporter.out = stream
.Refs #8408
A number of old utility functions and classes have been removed:
MapReduceMixin
: To make a checker reduce map data simply implementget_map_data
andreduce_map_data
.is_inside_lambda
: Useutils.get_node_first_ancestor_of_type(x, nodes.Lambda)
check_messages
: Useutils.only_required_for_messages
is_class_subscriptable_pep585_with_postponed_evaluation_enabled
: Useis_postponed_evaluation_enabled(node)
andis_node_in_type_annotation_context(node)
get_python_path
: assumption that there's always an init.py is not true sincepython 3.3 and is causing problems, particularly with PEP 420. Use
discover_package_path
and pass source root(s).
fix_import_path
: Useaugmented_sys_path
and pass additionalsys.path
entries as an argument obtained from
discover_package_path
.get_global_option
: Usechecker.linter.config
to get all global options.Related private objects have been removed as well.
Refs #8409
colorize_ansi
now only accepts aMessageStyle
object.Refs #8412
Following a deprecation period,
Pylinter.check
now only works with sequences of strings, not strings.Refs #8463
Following a deprecation period,
ColorizedTextReporter
only acceptsColorMappingDict
.Refs #8464
Following a deprecation period,
MessageTest
'send_line
andend_col_offset
must be accurate in functional tests (for python 3.8 or above on cpython, and for
python 3.9 or superior on pypy).
Refs #8466
Following a deprecation period, the
do_exit
argument of theRun
class (and of the_Run
class in testutils) were removed.
Refs #8472
Following a deprecation period, the
py_version
argument of theMessageDefinition.may_be_emitted
function is now required. The most likely solutionis to use 'linter.config.py_version' if you need to keep using this
function, or to use 'MessageDefinition.is_message_enabled' instead.
Refs #8473
Following a deprecation period, the
OutputLine
class now requiresthe right number of argument all the time. The functional output can be
regenerated automatically to achieve that easily.
Refs #8474
Following a deprecation period,
is_typing_guard
,is_node_in_typing_guarded_import_block
andis_node_in_guarded_import_block
frompylint.utils
were removed: use a combination ofis_sys_guard
andin_type_checking_block
instead.Refs #8475
Following a deprecation period, the
location
argument of theMessage
class must now be aMessageLocationTuple
.Refs #8477
Following a deprecation period, the
check_single_file
function of thePylinter
is replaced byPylinter.check_single_file_item
.Refs #8478
Performance Improvements
pylint
runs (at least) ~5% faster after improvements toastroid
that make better use of the inference cache.
Refs pylint-dev/astroid#529
is_trailing_comma()
.class_is_abstract()
.Refs #1954
Exit immediately if all messages are disabled.
Closes #8715
Configuration
📅 Schedule: Branch creation - At any time (no schedule defined), Automerge - At any time (no schedule defined).
🚦 Automerge: Disabled by config. Please merge this manually once you are satisfied.
♻ Rebasing: Whenever PR is behind base branch, or you tick the rebase/retry checkbox.
🔕 Ignore: Close this PR and you won't be reminded about this update again.
This PR has been generated by Mend Renovate. View repository job log here.