chore(deps): update dependency pylint to v4

[renovate]

This PR contains the following updates:

Package	Change	Age	Confidence
pylint (changelog)	>=2.6.0,<3.0.0 -> >=4.0.0,<4.1.0

---

Release Notes

pylint-dev/pylint (pylint)

v4.0.0

Compare Source

• Pylint now supports Python 3.14.

• Pylint's inference engine (astroid) is now much more precise,
  understanding implicit booleanness and ternary expressions. (Thanks @​zenlyj!)

Consider this example:

class Result:
    errors: dict | None = None

result = Result()
if result.errors:
    result.errors[field_key]

##### inference engine understands result.errors cannot be None
##### pylint no longer raises unsubscriptable-object

The required astroid version is now 4.0.0. See the astroid changelog for additional fixes, features, and performance improvements applicable to pylint.

• Handling of invalid-name at the module level was patchy. Now,
  module-level constants that are reassigned are treated as variables and checked
  against --variable-rgx rather than --const-rgx. Module-level lists,
  sets, and objects can pass against either regex.

Here, LIMIT is reassigned, so pylint only uses --variable-rgx:

LIMIT = 500  # [invalid-name]
if sometimes:
    LIMIT = 1  # [invalid-name]

If this is undesired, refactor using exclusive assignment so that it is
evident that this assignment happens only once:

if sometimes:
    LIMIT = 1
else:
    LIMIT = 500  # exclusive assignment: uses const regex, no warning

Lists, sets, and objects still pass against either const-rgx or variable-rgx
even if reassigned, but are no longer completely skipped:

MY_LIST = []
my_list = []
My_List = []  # [invalid-name]

Remember to adjust the regexes and allow lists to your liking.

Breaking Changes

• invalid-name now distinguishes module-level constants that are assigned only once
  from those that are reassigned and now applies --variable-rgx to the latter. Values
  other than literals (lists, sets, objects) can pass against either the constant or
  variable regexes (e.g. "LOGGER" or "logger" but not "LoGgEr").

  Remember that --good-names or --good-names-rgxs can be provided to explicitly
  allow good names.

  Closes #​3585

• The unused pylintrc argument to PyLinter.__init__() is deprecated
  and will be removed.

  Refs #​6052

• Commented out code blocks such as # bar() # TODO: remove dead code will no longer emit fixme.

  Refs #​9255

• pyreverse Run was changed to no longer call sys.exit() in its __init__.
  You should now call Run(args).run() which will return the exit code instead.
  Having a class that always raised a SystemExit exception was considered a bug.

  Normal usage of pyreverse through the CLI will not be affected by this change.

  Refs #​9689

• The suggestion-mode option was removed, as pylint now always emits user-friendly hints instead
  of false-positive error messages. You should remove it from your conf if it's defined.

  Refs #​9962

• The async.py checker module has been renamed to async_checker.py since async is a Python keyword
  and cannot be imported directly. This allows for better testing and extensibility of the async checker functionality.

  Refs #​10071

• The message-id of continue-in-finally was changed from E0116 to W0136. The warning is
  now emitted for every Python version since it will raise a syntax warning in Python 3.14.
  See PEP 765 - Disallow return/break/continue that exit a finally block.

  Refs #​10480

• Removed support for nmp.NaN alias for numpy.NaN being recognized in ':ref:nan-comparison'. Use np or numpy instead.

  Refs #​10583

• Version requirement for isort has been bumped to >=5.0.0.
  The internal compatibility for older isort versions exposed via pylint.utils.IsortDriver has
  been removed.

  Refs #​10637

New Features

• comparison-of-constants now uses the unicode from the ast instead of reformatting from
  the node's values preventing some bad formatting due to utf-8 limitation. The message now uses
  " instead of ' to better work with what the python ast returns.

  Refs #​8736

• Enhanced pyreverse to properly distinguish between UML relationship types (association, aggregation, composition) based on object ownership semantics. Type annotations without assignment are now treated as associations, parameter assignments as aggregations, and object instantiation as compositions.

  Closes #​9045
  Closes #​9267

• The fixme check can now search through docstrings as well as comments, by using
  check-fixme-in-docstring = true in the [tool.pylint.miscellaneous] section.

  Closes #​9255

• The use-implicit-booleaness-not-x checks now distinguish between comparisons
  used in boolean contexts and those that are not, enabling them to provide more accurate refactoring suggestions.

  Closes #​9353

• The verbose option now outputs the filenames of the files that have been checked.
  Previously, it only included the number of checked and skipped files.

  Closes #​9357

• colorized reporter now colorizes messages/categories that have been configured as fail-on in red inverse.
  This makes it easier to quickly find the errors that are causing pylint CI job failures.

  Closes #​9898

• Enhanced support for @​property decorator in pyreverse to correctly display return types of annotated properties when generating class diagrams.

  Closes #​10057

• Add --max-depth option to pyreverse to control diagram complexity. A depth of 0 shows only top-level packages, 1 shows one level of subpackages, etc.
  This helps manage visualization of large codebases by limiting the depth of displayed packages and classes.

  Refs #​10077

• Handle deferred evaluation of annotations in Python 3.14.

  Closes #​10149

• Enhanced pyreverse to properly detect aggregations for comprehensions (list, dict, set, generator).

  Closes #​10236

• pyreverse: add support for colorized output when using output format mmd (MermaidJS) and html.

  Closes #​10242

• pypy 3.11 is now officially supported.

  Refs #​10287

• Add support for Python 3.14.

  Refs #​10467

• Add naming styles for ParamSpec and TypeVarTuple that align with the TypeVar style.

  Refs #​10541

New Checks

• Add match-statements checker and the following message:
  bare-name-capture-pattern.
  This will emit an error message when a name capture pattern is used in a match statement which would make the remaining patterns unreachable.
  This code is a SyntaxError at runtime.

  Closes #​7128

• Add new check async-context-manager-with-regular-with to detect async context managers used with regular with statements instead of async with.

  Refs #​10408

• Add break-in-finally warning. Using break inside the finally clause
  will raise a syntax warning in Python 3.14.
  See PEP 765 - Disallow return/break/continue that exit a finally block <https://peps.python.org/pep-0765/>_.

  Refs #​10480

• Add new checks for invalid uses of class patterns in :keyword:match.

  • :ref:invalid-match-args-definition is emitted if :py:data:object.__match_args__ isn't a tuple of strings.
  • :ref:too-many-positional-sub-patterns if there are more positional sub-patterns than specified in :py:data:object.__match_args__.
  • :ref:multiple-class-sub-patterns if there are multiple sub-patterns for the same attribute.

  Refs #​10559

• Add additional checks for suboptimal uses of class patterns in :keyword:match.

  • :ref:match-class-bind-self is emitted if a name is bound to self instead of
    using an as pattern.
  • :ref:match-class-positional-attributes is emitted if a class pattern has positional
    attributes when keywords could be used.

  Refs #​10586

• Add a consider-math-not-float message. float("nan") and float("inf") are slower
  than their counterpart math.inf and math.nan by a factor of 4 (notwithstanding
  the initial import of math) and they are also not well typed when using mypy.
  This check also catches typos in float calls as a side effect.

  The :ref:pylint.extensions.code_style need to be activated for this check to work.

  Refs #​10621

False Positives Fixed

• Fix a false positive for used-before-assignment when a variable defined under
  an if and via a named expression (walrus operator) is used later when guarded
  under the same if test.

  Closes #​10061

• Fix :ref:no-name-in-module for members of concurrent.futures with Python 3.14.

  Closes #​10632

False Negatives Fixed

• Fix false negative for used-before-assignment when a TYPE_CHECKING import is used as a type annotation prior to erroneous usage.

  Refs #​8893

• Match cases are now counted as edges in the McCabe graph and will increase the complexity accordingly.

  Refs #​9667

• Check module-level constants with type annotations for invalid-name.
  Remember to adjust const-naming-style or const-rgx to your liking.

  Closes #​9770

• Fix false negative where function-redefined (E0102) was not reported for functions with a leading underscore.

  Closes #​9894

• We now raise a logging-too-few-args for format string with no
  interpolation arguments at all (i.e. for something like logging.debug("Awaiting process %s")
  or logging.debug("Awaiting process {pid}")). Previously we did not raise for such case.

  Closes #​9999

• Fix false negative for used-before-assignment when a function is defined inside a TYPE_CHECKING guard block and used later.

  Closes #​10028

• Fix a false negative for possibly-used-before-assignment when a variable is conditionally defined
  and later assigned to a type-annotated variable.

  Closes #​10421

• Fix false negative for deprecated-module when a __import__ method is used instead of import sentence.

  Refs #​10453

• Count match cases for too-many-branches check.

  Refs #​10542

• Fix false-negative where :ref:unused-import was not reported for names referenced in a preceding global statement.

  Refs #​10633

Other Bug Fixes

• When displaying unicode with surrogates (or other potential UnicodeEncodeError),
  pylint will now display a '?' character (using encode(encoding="utf-8", errors="replace"))
  instead of crashing. The functional tests classes are also updated to handle this case.

  Closes #​8736

• Fixed unidiomatic-typecheck only checking left-hand side.

  Closes #​10217

• Fix a crash caused by malformed format strings when using .format with keyword arguments.

  Closes #​10282

• Fix false positive inconsistent-return-statements when using quit() or exit() functions.

  Closes #​10508

• Fix a crash in :ref:nested-min-max when using builtins.min or builtins.max
  instead of min or max directly.

  Closes #​10626

• Fixed a crash in :ref:unnecessary-dict-index-lookup when the index of an enumerated list
  was deleted inside a for loop.

  Closes #​10627

Other Changes

• Remove support for launching pylint with Python 3.9.
  Code that supports Python 3.9 can still be linted with the --py-version=3.9 setting.

  Refs #​10405

Internal Changes

• Modified test framework to allow for different test output for different Python versions.

  Refs #​10382

v3.3.9

Compare Source

What's new in Pylint 3.3.9?

Release date: 2025-10-05

False Positives Fixed

• Fix used-before-assignment for PEP 695 type aliases and parameters.

  Closes #​9815

• No longer flag undeprecated functions in importlib.resources as deprecated.

  Closes #​10593

• Fix false positive inconsistent-return-statements when using quit() or exit() functions.

  Closes #​10508

• Fix false positive undefined-variable (E0602) for for-loop variable shadowing patterns like for item in item: when the variable was previously defined.

  Closes #​10562

Other Bug Fixes

• Fixed crash in 'unnecessary-list-index-lookup' when starting an enumeration using
  minus the length of an iterable inside a dict comprehension when the len call was only
  made in this dict comprehension, and not elsewhere. Also changed the approach,
  to use inference in all cases but the simple ones, so we don't have to fix crashes
  one by one for arbitrarily complex expressions in enumerate.

  Closes #​10510

v3.3.8

Compare Source

What's new in Pylint 3.3.8?

Release date: 2025-08-09

This patch release includes an exceptional fix for a false negative issue. For details, see: #​10482 (comment)

False Positives Fixed

• Fix false positives for possibly-used-before-assignment when variables are exhaustively
  assigned within a match block.

  Closes #​9668

• Fix false positive for missing-raises-doc and missing-yield-doc when the method length is less than docstring-min-length.

  Refs #​10104

• Fix a false positive for unused-variable when multiple except handlers bind the same name under a try block.

  Closes #​10426

False Negatives Fixed

• Fix false-negative for used-before-assignment with from __future__ import annotations in function definitions.

  Refs #​10482

Other Bug Fixes

• Fix a bug in Pyreverse where aggregations and associations were included in diagrams regardless of the selected --filter-mode (such as PUB_ONLY, ALL, etc.).

  Closes #​10373

• Fix double underscores erroneously rendering as bold in pyreverse's Mermaid output.

  Closes #​10402

v3.3.7

Compare Source

What's new in Pylint 3.3.7?

Release date: 2025-05-04

False Positives Fixed

• Comparisons between two calls to type() won't raise an unidiomatic-typecheck warning anymore, consistent with the behavior applied only for == previously.

  Closes #​10161

Other Bug Fixes

• Fixed a crash when importing a class decorator that did not exist with the same name as a class attribute after the class definition.

  Closes #​10105

• Fix a crash caused by malformed format strings when using .format with keyword arguments.

  Closes #​10282

• Using a slice as a class decorator now raises a not-callable message instead of crashing. A lot of checks that dealt with decorators (too many to list) are now shortcut if the decorator can't immediately be inferred to a function or class definition.

  Closes #​10334

Other Changes

• The algorithm used for no-member suggestions is now more efficient and cuts the
  calculation when the distance score is already above the threshold.

  Refs #​10277

v3.3.6

Compare Source

What's new in Pylint 3.3.6?

Release date: 2025-03-20

False Positives Fixed

• Fix a false positive for used-before-assignment when an inner function's return type
  annotation is a class defined at module scope.

  Closes #​9391

v3.3.5

Compare Source

What's new in Pylint 3.3.5?

Release date: 2025-03-09

False Positives Fixed

• Fix false positives for use-implicit-booleaness-not-comparison, use-implicit-booleaness-not-comparison-to-string
  and use-implicit-booleaness-not-comparison-to-zero when chained comparisons are checked.

  Closes #​10065

• Fix a false positive for invalid-getnewargs-ex-returned when the tuple or dict has been assigned to a name.

  Closes #​10208

• Remove getopt and optparse from the list of deprecated modules.

  Closes #​10211

Other Bug Fixes

• Fixed conditional import x.y causing false positive possibly-used-before-assignment.

  Closes #​10081

• Fix a crash when something besides a class is found in an except handler.

  Closes #​10106

• Fixed raising invalid-name when using camelCase for private methods with two leading underscores.

  Closes #​10189

Other Changes

• Upload release assets to PyPI via Trusted Publishing.

  Closes #​10256

v3.3.4

Compare Source

Other Bug Fixes

• Fixes "skipped files" count calculation; the previous method was displaying an arbitrary number.

  Closes #​10073

• Fixes a crash that occurred when pylint was run in a container on a host with cgroupsv2 and restrictions on CPU usage.

  Closes #​10103

• Relaxed the requirements for isort so pylint can benefit from isort 6.

  Closes #​10203

v3.3.3

Compare Source

What's new in Pylint 3.3.3?

Release date: 2024-12-23

False Positives Fixed

• Fix false positives for undefined-variable for classes using Python 3.12
  generic type syntax.

  Closes #​9335

• Fix a false positive for use-implicit-booleaness-not-len. No lint should be emitted for
  generators (len is not defined for generators).

  Refs #​10100

Other Bug Fixes

• Fix Unable to import 'collections.abc' (import-error) on Python 3.13.1.

  Closes #​10112

v3.3.2

Compare Source

False Positives Fixed

• Fix a false positive for potential-index-error when an indexed iterable
  contains a starred element that evaluates to more than one item.

  Closes #​10076

Other Bug Fixes

• Fixes the issue with --source-root option not working when the source files are in a subdirectory of the source root (e.g. when using a /src layout).

  Closes #​10026

v3.3.1

Compare Source

What's new in Pylint 3.3.1?

Release date: 2024-09-24

False Positives Fixed

• Fix regression causing some f-strings to not be inferred as strings.

  Closes #​9947

v3.3.0

Compare Source

Release date: 2024-09-20

Changes requiring user actions

• We migrated symilar to argparse, from getopt, so the error and help output changed
  (for the better). We exit with 2 instead of sometime 1, sometime 2. The error output
  is not captured by the runner anymore. It's not possible to use a value for the
  boolean options anymore (--ignore-comments 1 should become --ignore-comments).

  Refs #​9731

New Features

• Add new declare-non-slot error which reports when a class has a __slots__ member and a type hint on the class is not present in __slots__.

  Refs #​9499

New Checks

• Added too-many-positional-arguments to allow distinguishing the configuration for too many
  total arguments (with keyword-only params specified after *) from the configuration
  for too many positional-or-keyword or positional-only arguments.

  As part of evaluating whether this check makes sense for your project, ensure you
  adjust the value of --max-positional-arguments.

  Closes #​9099

• Add using-exception-groups-in-unsupported-version and
  using-generic-type-syntax-in-unsupported-version for uses of Python 3.11+ or
  3.12+ features on lower supported versions provided with --py-version.

  Closes #​9791

• Add using-assignment-expression-in-unsupported-version for uses of := (walrus operator)
  on Python versions below 3.8 provided with --py-version.

  Closes #​9820

• Add using-positional-only-args-in-unsupported-version for uses of positional-only args on
  Python versions below 3.8 provided with --py-version.

  Closes #​9823

• Add unnecessary-default-type-args to the typing extension to detect the use
  of unnecessary default type args for typing.Generator and typing.AsyncGenerator.

  Refs #​9938

False Negatives Fixed

• Fix computation of never-returning function: Never is handled in addition to NoReturn, and priority is given to the explicit --never-returning-functions option.

  Closes #​7565.

• Fix a false negative for await-outside-async when await is inside Lambda.

  Refs #​9653

• Fix a false negative for duplicate-argument-name by including positional-only, *args and **kwargs arguments in the check.

  Closes #​9669

• Fix false negative for multiple-statements when multiple statements are present on else and finally lines of try.

  Refs #​9759

• Fix false negatives when isinstance does not have exactly two arguments.
  pylint now emits a too-many-function-args or no-value-for-parameter
  appropriately for isinstance calls.

  Closes #​9847

Other Bug Fixes

• --enable with --disable=all now produces an error, when an unknown msg code is used. Internal pylint messages are no longer affected by --disable=all.

  Closes #​9403

• Impossible to compile regexes for paths in the configuration or argument given to pylint won't crash anymore but
  raise an argparse error and display the error message from re.compile instead.

  Closes #​9680

• Fix a bug where a tox.ini file with pylint configuration was ignored and it exists in the current directory.

  .cfg and .ini files containing a Pylint configuration may now use a section named [pylint]. This enhancement impacts the scenario where these file types are used as defaults when they are present and have not been explicitly referred to, using the --rcfile option.

  Closes #​9727

• Improve file discovery for directories that are not python packages.

  Closes #​9764

Other Changes

• Remove support for launching pylint with Python 3.8.
  Code that supports Python 3.8 can still be linted with the --py-version=3.8 setting.

  Refs #​9774

• Add support for Python 3.13.

  Refs #​9852

Internal Changes

• All variables, classes, functions and file names containing the word 'similar', when it was,
  in fact, referring to 'symilar' (the standalone program for the duplicate-code check) were renamed
  to 'symilar'.

  Closes #​9734

• Remove old-style classes (Python 2) code and remove check for new-style class since everything is new-style in Python 3. Updated doc for exception checker to remove reference to new style class.

  Refs #​9925

v3.2.7

Compare Source

What's new in Pylint 3.2.7?

Release date: 2024-08-31

False Positives Fixed

• Fixed a false positive unreachable for NoReturn coroutine functions.

  Closes #​9840

Other Bug Fixes

• Fix crash in refactoring checker when calling a lambda bound as a method.

  Closes #​9865

• Fix a crash in undefined-loop-variable when providing the iterable argument to enumerate().

  Closes #​9875

• Fix to address indeterminacy of error message in case a module name is same as another in a separate namespace.

  Refs #​9883

v3.2.6

Compare Source

What's new in Pylint 3.2.6?

Release date: 2024-07-21

False Positives Fixed

• Quiet false positives for unexpected-keyword-arg when pylint cannot
  determine which of two or more dynamically defined classes is being instantiated.

  Closes #​9672

• Fix a false positive for missing-param-doc where a method which is decorated with typing.overload was expected to have a docstring specifying its parameters.

  Closes #​9739

• Fix a regression that raised invalid-name on class attributes merely
  overriding invalid names from an ancestor.

  Closes #​9765

• Treat assert_never() the same way when imported from typing_extensions.

  Closes #​9780

• Fix a false positive for consider-using-min-max-builtin when the assignment target is an attribute.

  Refs #​9800

Other Bug Fixes

• Fix an AssertionError arising from properties that return partial functions.

  Closes #​9214

• Fix a crash when a subclass extends __slots__.

  Closes #​9814

v3.2.5

Compare Source

What's new in Pylint 3.2.5 ?

Release date: 2024-06-28

Other Bug Fixes

• Fixed a false positive unreachable-code when using typing.Any as return type in python
  3.8, the typing.NoReturn are not taken into account anymore for python 3.8 however.

  Closes #​9751

v3.2.4

Compare Source

What's new in Pylint 3.2.4?

Release date: 2024-06-26

False Positives Fixed

• Prevent emitting possibly-used-before-assignment when relying on names
  only potentially not defined in conditional blocks guarded by functions
  annotated with typing.Never or typing.NoReturn.

  Closes #​9674

Other Bug Fixes

• Fixed a crash when the lineno of a variable used as an annotation wasn't available for undefined-variable.

  Closes #​8866

• Fixed a crash when the start value in an enumerate was non-constant and impossible to infer
  (like inenumerate(apples, start=int(random_apple_index)) for unnecessary-list-index-lookup.

  Closes #​9078

• Fixed a crash in symilar when the -d or -i short option were not properly recognized.
  It's still impossible to do -d=1 (you must do -d 1).

  Closes #​9343

v3.2.3

Compare Source

False Positives Fixed

• Classes with only an Ellipsis (...) in their body do not trigger 'multiple-statements'
  anymore if they are inlined (in accordance with black's 2024 style).

  Closes #​9398

• Fix a false positive for redefined-outer-name when there is a name defined in an exception-handling block which shares the same name as a local variable that has been defined in a function body.

  Closes #​9671

• Fix a false positive for use-yield-from when using the return value from the yield atom.

  Closes #​9696

v3.2.2

Compare Source

What's new in Pylint 3.2.2?

Release date: 2024-05-20

False Positives Fixed

• Fix multiple false positives for generic class syntax added in Python 3.12 (PEP 695).

  Closes #​9406

• Exclude context manager without cleanup from
  contextmanager-generator-missing-cleanup checks.

  Closes #​9625

v3.2.1

Compare Source

What's new in Pylint 3.2.1?

Release date: 2024-05-18

False Positives Fixed

• Exclude if/else branches containing terminating functions (e.g. sys.exit())
  from possibly-used-before-assignment checks.

  Closes #​9627

• Don't emit typevar-name-incorrect-variance warnings for PEP 695 style TypeVars.
  The variance is inferred automatically by the type checker.
  Adding _co or _contra suffix can help to reason about TypeVar.

  Refs #​9638

• Fix a false positive for possibly-used-before-assignment when using
  typing.assert_never() (3.11+) to indicate exhaustiveness.

  Closes #​9643

Other Bug Fixes

• Fix a false negative for --ignore-patterns when the directory to be linted is specified using a dot(.) and all files are ignored instead of only the files whose name begin with a dot.

  Closes #​9273

• Restore "errors / warnings by module" section to report output (with -ry).

  Closes #​9145

• trailing-comma-tuple should now be correctly emitted when it was disabled globally
  but enabled via local message control, after removal of an over-optimisation.

  Refs #​9608

• Add --prefer-stubs=yes option to opt-in to the astroid 3.2 feature
  that prefers .pyi stubs over same-named .py files. This has the
  potential to reduce no-member errors but at the cost of more errors
  such as not-an-iterable from function bodies appearing as ....

  Defaults to no.

  Closes #​9626
  Closes #​9623

Internal Changes

• Update astroid version to 3.2.1. This solves some reports of RecursionError
  and also makes the prefer .pyi stubs feature in astroid 3.2.0 opt-in
  with the aforementioned --prefer-stubs=y option.

  Refs #​9139

v3.2.0

Compare Source

What's new in Pylint 3.2.0?

Release date: 2024-05-14

Of note: a github reporter, two new checks (possibly-used-before-assignment and contextmanager-generator-missing-cleanup), performance improvements, and an astroid upgrade providing support for @overload and .pyi stubs.

New Features

• Understand six.PY2 and six.PY3 for conditional imports.

  Closes #​3501

• A new github reporter has been added. This reporter returns the output of pylint in a format that
  Github can use to automatically annotate code. Use it with pylint --output-format=github on your Github Workflows.

  Closes #​9443.

New Checks

• Add check possibly-used-before-assignment when relying on names after an if/else
  switch when one branch failed to define the name, raise, or return.

  Closes #​1727

• Checks for generators that use contextmanagers that don't handle cleanup properly.
  Is meant to raise visibilty on the case that a generator is not fully exhausted and the contextmanager is not cleaned up properly.
  A contextmanager must yield a non-constant value and not handle cleanup for GeneratorExit.
  The using generator must attempt to use the yielded context value with x() as y and not just with x().

  Closes #​2832

False Negatives Fixed

• If and Try nodes are now checked for useless return statements as well.

  Closes #​9449.

• Fix false negative for property-with-parameters in the case of parameters which are positional-only, keyword-only, variadic positional or variadic keyword.

  Closes #​9584

False Positives Fixed

• pylint now understands the @overload decorator return values better.

  Closes #​4696
  Refs #​9606

Performance Improvements

• Ignored modules are now not checked at all, instead of being checked and then
  ignored. This should speed up the analysis of large codebases which have
  ignored modules.

  Closes #​9442

• ImportChecker's logic has been modified to avoid context files when possible. This makes it possible
  to cache module searches on astroid and reduce execution times.

  Refs #​9310.

• An internal check for trailing-comma-tuple being enabled for a file or not is now
  done once per file instead of once for each token.

  Refs #​9608.

v3.1.1

Compare Source

What's new in Pylint 3.1.1?

Release date: 2024-05-13

False Positives Fixed

• Treat attrs.define and attrs.frozen as dataclass decorators in
  too-few-public-methods check.

  Closes #​9345

• Fix a false positive with singledispatchmethod-function when a method is decorated with both functools.singledispatchmethod and staticmethod.

  Closes #​9531

• Fix a false positive for consider-using-dict-items when iterating using keys() and then deleting an item using the key as a lookup.

  Closes #​9554

v3.1.0

Compare Source

Two new checks--use-yield-from, deprecated-attribute-- and a smattering of bug fixes.

New Features

• Skip consider-using-join check for non-empty separators if an suggest-join-with-non-empty-separator option is set to no.

  Closes #​8701

• Discover .pyi files when linting.

  These can be ignored with the ignore-patterns setting.

  Closes #​9097

• Check TypeAlias and TypeVar (PEP 695) nodes for invalid-name.

  Refs #​9196

• Support for resolving external toml files named pylintrc.toml and .pylintrc.toml.

  Closes #​9228

• Check for .clear, .discard, .pop and remove methods being called on a set while it is being iterated over.

  Closes #​9334

New Checks

• New message use-yield-from added to the refactoring checker. This message is emitted when yielding from a loop can be replaced by yield from.

  Closes #​9229.

• Added a deprecated-attribute message to check deprecated attributes in the stdlib.

  Closes #​8855

False Positives Fixed

• Fixed false positive for inherit-non-class for generic Protocols.

  Closes #​9106

• Exempt TypedDict from typing_extensions from too-many-ancestor checks.

  Refs #​9167

False Negatives Fixed

• Extend broad-exception-raised and broad-exception-caught to except*.

  Closes #​8827

• Fix a false-negative for unnecessary if blocks using a different than expected ordering of arguments.

  Closes #​8947.

Other Bug Fixes

• Improve the message provided for wrong-import-order check. Instead of the import statement ("import x"), the message now specifies the import that is out of order and which imports should come after it. As reported in the issue, this is particularly helpful if there are multiple imports on a single line that do not follow the PEP8 convention.

  The message will report imports as follows:
  For "import X", it will report "(standard/third party/first party/local) import X"
  For "import X.Y" and "from X import Y", it will report "(standard/third party/first party/local) import X.Y"
  The import category is specified to provide explanation as to why pylint has issued the message and guidence to the developer on how to fix the problem.

  Closes #​8808

Other Changes

• Print how many files were checked in verbose mode.

  Closes #​8935

• Fix a crash when an enum class which is also decorated with a dataclasses.dataclass decorator is defined.

  Closes #​9100

Internal Changes

• Update astroid version to 3.1.0.

  Refs #​9457

v3.0.4

Compare Source

False Positives Fixed

• used-before-assignment is no longer emitted when using a name in a loop and
  depending on an earlier name assignment in an except block paired with
  else: continue.

  Closes #​6804

• Avoid false positives for no-member involving function
  attributes supplied by decorators.

  Closes #​9246

• Fixed false positive nested-min-max for nested lists.

  Closes #​9307

• Fix false positive for used-before-assignment in a finally block
  when assignments took place in both the try block and each exception handler.

  Closes #​9451

Other Bug Fixes

• Catch incorrect ValueError "generator already executing" for Python 3.12.0 - 3.12.2.
  This is fixed upstream in Python 3.12.3.

  Closes #​9138

v3.0.3

Compare Source

What's new in Pylint 3.0.3?

Release date: 2023-12-11

False Positives Fixed

• Fixed false positive for unnecessary-lambda when the call has keyword arguments but not the lambda.

  Closes #​9148

• Fixed incorrect suggestion for shallow copy in unnecessary-comprehension

  Example of the suggestion:
  #pylint: disable=missing-module-docstring
  a = [1, 2, 3]
  b = [x for x in a]
  b[0] = 0
  print(a) # [1, 2, 3]

  After changing b = [x for x in a] to b = a based on the suggestion, the script now prints [0, 2, 3]. The correct suggestion should be use list(a) to preserve the original behavior.

  Closes #​9172

• Fix false positives for undefined-variable and unused-argument for
  classes and functions using Python 3.12 generic type syntax.

  Closes #​9193

• Fixed pointless-string-statement false positive for docstrings
  on Python 3.12 type aliases.

  Closes #​9268

• Fix false positive for invalid-exception-operation when concatenating tuples
  of exception types.

  Closes #​9288

Other Bug Fixes

• Fix a bug where pylint was unable to walk recursively through a directory if the
  directory has an __init__.py file.

  Closes #​9210

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.

{
    "messages": [
        {
            "type": "convention",
            "symbol": "line-too-long",
            "message": "Line too long (1/2)",
            "messageId": "C0301",
            "confidence": "HIGH",
            "module": "0123",
            "obj": "",
            "line": 1,
            "column": 0,
            "endLine": 1,
            "endColumn": 4,
            "path": "0123",
            "absolutePath": "0123"
        }
    ],
    "statistics": {
        "messageTypeCount": {
            "fatal": 0,
            "error": 0,
            "warning": 0,
            "refactor": 0,
            "convention": 1,
            "info": 0
        },
        "modulesLinted": 1,
        "score": 5.0
    }
}

Breaking Changes

• Enabling or disabling individual messages will now take effect even if an
  --enable=all or disable=all follows in the same configuration file
  (or on the command line).

  This means for the following example, fixme messages will now be emitted:

      pylint my_module --enable=fixme --disable=all

  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 the except 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 PEP245
  that was proposed in 2001 and rejected in 2006.

  The capability from pyreverse to take __implements__ into account when generating diagrams
  was 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 of
    invalid-name), then simply add the option bad-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 would
    prefer 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 comp

---

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 becomes conflicted, or you tick the rebase/retry checkbox.

🔕 Ignore: Close this PR and you won't be reminded about this update again.

---

• If you want to rebase/retry this PR, check this box

---

This PR was generated by Mend Renovate. View the repository job log.