What's New in Pylint 2.15

Release:

2.15

Date:

2022-08-26

Summary -- Release highlights

In pylint 2.15.0, we added a new check missing-timeout to warn of default timeout values that could cause a program to be hanging indefinitely.

We improved pylint's handling of namespace packages. More packages should be linted without resorting to using the --recursive=y option.

We still welcome any community effort to help review, integrate, and add good/bad examples to the doc for <https://github.com/PyCQA/pylint/issues/5953>`_. This should be doable without any pylint or astroid knowledge, so this is the perfect entrypoint if you want to contribute to pylint or open source without any experience with our code!

Internally, we changed the way we generate the release notes, thanks to DudeNr33. There will be no more conflict resolution to do in the changelog, and every contributor rejoice.

Marc Byrne became a maintainer, welcome to the team !

What's new in Pylint 2.15.2?

Release date: 2022-09-07

  • Fixed a case where custom plugins specified by command line could silently fail.

    Specifically, if a plugin relies on the init-hook option changing sys.path before it can be imported, this will now emit a bad-plugin-value message. Before this change, it would silently fail to register the plugin for use, but would load any configuration, which could have unintended effects.

    Fixes part of #7264. (#7264)

  • Fix used-before-assignment for functions/classes defined in type checking guard.

    Closes #7368 (#7368)

  • Update modified_iterating checker to fix a crash with for loops on empty list.

    Closes #7380 (#7380)

  • The docparams extension now considers typing in Numpy style docstrings as "documentation" for the missing-param-doc message.

    Refs #7398 (#7398)

  • Fix false positive for unused-variable and unused-import when a name is only used in a string literal type annotation.

    Closes #3299 (#3299)

  • Fix false positive for too-many-function-args when a function call is assigned to a class attribute inside the class where the function is defined.

    Closes #6592 (#6592)

  • Fix used-before-assignment for functions/classes defined in type checking guard.

    Closes #7368 (#7368)

  • Fix ignored files being linted when passed on stdin.

    Closes #4354 (#4354)

  • missing-return-doc, missing-raises-doc and missing-yields-doc now respect the no-docstring-rgx option.

    Closes #4743 (#4743)

  • Don't crash on OSError in config file discovery.

    Closes #7169 (#7169)

  • disable-next is now correctly scoped to only the succeeding line.

    Closes #7401 (#7401)

  • Update modified_iterating checker to fix a crash with for loops on empty list.

    Closes #7380 (#7380)

What's new in Pylint 2.15.1?

Release date: 2022-09-06

This is a "github only release", it was mistakenly released as 2.16.0-dev on pypi. Replaced by 2.15.2.

What's new in Pylint 2.15.0?

New Checks

  • Added new checker missing-timeout to warn of default timeout values that could cause a program to be hanging indefinitely.

    Refs #6780 (#6780)

False Positives Fixed

  • Don't report super-init-not-called for abstract __init__ methods.

    Closes #3975 (#3975)

  • Don't report unsupported-binary-operation on Python <= 3.9 when using the | operator with types, if one has a metaclass that overloads __or__ or __ror__ as appropriate.

    Closes #4951 (#4951)

  • Don't report no-value-for-parameter for dataclasses fields annotated with KW_ONLY.

    Closes #5767 (#5767)

  • Fixed inference of Enums when they are imported under an alias.

    Closes #5776 (#5776)

  • Prevent false positives when accessing PurePath.parents by index (not slice) on Python 3.10+.

    Closes #5832 (#5832)

  • unnecessary-list-index-lookup is now more conservative to avoid potential false positives.

    Closes #6896 (#6896)

  • Fix double emitting trailing-whitespace for multi-line docstrings.

    Closes #6936 (#6936)

  • import-error now correctly checks for contextlib.suppress guards on import statements.

    Closes #7270 (#7270)

  • Fix false positive for no-self-argument/no-method-argument when a staticmethod is applied to a function but uses a different name.

    Closes #7300 (#7300)

  • Fix undefined-loop-variable with break and continue statements in else blocks.

    Refs #7311 (#7311)

  • Improve default TypeVar name regex. Disallow names prefixed with T. E.g. use AnyStrT instead of TAnyStr.

    Refs #7322 (#7322 <https://github.com/PyCQA/pylint/issues/7322>`_)

False Negatives Fixed

  • Emit used-before-assignment when relying on a name that is reimported later in a function.

    Closes #4624 (#4624)

  • Emit used-before-assignment for self-referencing named expressions (:=) lacking prior assignments.

    Closes #5653 (#5653)

  • Emit used-before-assignment for self-referencing assignments under if conditions.

    Closes #6643 (#6643)

  • Emit modified-iterating-list and analogous messages for dicts and sets when iterating literals, or when using the del keyword.

    Closes #6648 (#6648)

  • Emit used-before-assignment when calling nested functions before assignment.

    Closes #6812 (#6812)

  • Emit nonlocal-without-binding when a nonlocal name has been assigned at a later point in the same scope.

    Closes #6883 (#6883)

  • Emit using-constant-test when testing the truth value of a variable or call result holding a generator.

    Closes #6909 (#6909)

  • Rename unhashable-dict-key to unhashable-member and emit when creating sets and dicts, not just when accessing dicts.

    Closes #7034, Closes #7055 (#7034)

Other Bug Fixes

  • Fix a failure to lint packages with __init__.py contained in directories lacking __init__.py.

    Closes #1667 (#1667)

  • Fixed a syntax-error crash that was not handled properly when the declared encoding of a file was utf-9.

    Closes #3860 (#3860)

  • Fix a crash in the not-callable check when there is ambiguity whether an instance is being incorrectly provided to __new__().

    Closes #7109 (#7109)

  • Fix crash when regex option raises a re.error exception.

    Closes #7202 (#7202)

  • Fix undefined-loop-variable from walrus in comprehension test.

    Closes #7222 (#7222)

  • Check for <cwd> before removing first item from sys.path in modify_sys_path.

    Closes #7231 (#7231)

  • Fix sys.path pollution in parallel mode.

    Closes #7246 (#7246)

  • Prevent useless-parent-delegation for delegating to a builtin written in C (e.g. Exception.__init__) with non-self arguments.

    Closes #7319 (#7319)

Other Changes

  • bad-exception-context has been renamed to bad-exception-cause as it is about the cause and not the context.

    Closes #3694 (#3694)

  • The message for literal-comparison is now more explicit about the problem and the solution.

    Closes #5237 (#5237)

  • useless-super-delegation has been renamed to useless-parent-delegation in order to be more generic.

    Closes #6953 (#6953)

  • Pylint now uses towncrier for changelog generation.

    Refs #6974 (#6974)

  • Update astroid to 2.12.

    Refs #7153 (#7153)

  • Fix crash when a type-annotated __slots__ with no value is declared.

    Closes #7280 (#7280)

Internal Changes

  • Fixed an issue where it was impossible to update functional tests output when the existing output was impossible to parse. Instead of raising an error we raise a warning message and let the functional test fail with a default value.

    Refs #6891 (#6891)

  • pylint.testutils.primer is now a private API.

    Refs #6905 (#6905)

  • We changed the way we handle the changelog internally by using towncrier. If you're a contributor you won't have to fix merge conflicts in the changelog anymore.

    Closes #6974 (#6974)

  • Pylint is now using Scorecards to implement security recommendations from the OpenSSF. This is done in order to secure our supply chains using a combination of automated tooling and best practices, most of which were already implemented before.

    Refs #7267 (#7267)