Search code, repositories, users, issues, pull requests...

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`

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`

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`

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`

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`

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`

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`

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`

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`

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`

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`

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`

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`

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`

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`

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`

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`

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`

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`

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`

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

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.

sonarqubecloud · 2024-03-08T15:13:28Z

Quality Gate passed

See analysis details on SonarCloud

Measures
0 Security Hotspots
No data about Coverage
No data about Duplication

sonarqubecloud · 2024-07-21T23:27:30Z

Quality Gate passed

See analysis details on SonarCloud

Measures
0 Security Hotspots
0.0% Coverage on New Code
0.0% Duplication on New Code

sonarqubecloud · 2024-09-24T12:45:46Z

Quality Gate passed

See analysis details on SonarCloud

Measures
0 Security Hotspots
0.0% Coverage on New Code
0.0% Duplication on New Code

sonarqubecloud · 2025-01-28T13:44:33Z

Quality Gate passed

Measures
0 Security Hotspots
0.0% Coverage on New Code
0.0% Duplication on New Code

sonarqubecloud · 2025-05-04T17:31:11Z

Quality Gate passed

Measures
0 Security Hotspots
0.0% Coverage on New Code
0.0% Duplication on New Code

sonarqubecloud · 2025-08-09T12:38:53Z

Quality Gate passed

Measures
0 Security Hotspots
0.0% Coverage on New Code
0.0% Duplication on New Code

sonarqubecloud · 2025-10-05T21:40:09Z

Quality Gate passed

Measures
0 Security Hotspots
0.0% Coverage on New Code
0.0% Duplication on New Code