Release branch 3.2.0

[Pierre-Sassoulas]

What's new in Pylint 3.2.0?

Release date: 2024-05-14

New Features

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

  Closes conditional import against six.PY2 emits error #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 GitHub actions output format #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 used-before-assignment false negative after conditionals #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 Warn about @contextlib.contextmanager without try/finally in generator functions #2832

False Negatives Fixed

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

  Closes Nonsensical returns are not reported as useless-return if they are indented #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 property-with-parameters only cares about non-self parameters if they're positional-or-keyword parameters #9584

False Positives Fixed

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

  Closes methods that return a sequence yield unpacking-non-sequence #4696
  Refs Bump astroid to 3.2.0 #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 Azure import try/except over doubles pylint memory usage #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 E0401 (import-error) checks perform a lot of repeated stat calls #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 R1707 (trailing-comma-tuple) checks perform excessive is_message_enabled calls #9608.

[codecov]

Codecov Report

All modified and coverable lines are covered by tests ✅

Project coverage is 95.83%. Comparing base (743a04d) to head (d57ba03).

Additional details and impacted files

@@           Coverage Diff           @@
##             main    #9619   +/-   ##
=======================================
  Coverage   95.83%   95.83%           
=======================================
  Files         174      174           
  Lines       18889    18889           
=======================================
  Hits        18103    18103           
  Misses        786      786           

Files	Coverage Δ
pylint/__pkginfo__.py	100.00% <100.00%> (ø)

[Pierre-Sassoulas]

@jacobtylerwalls did you see #9609 ? How about we release the performance part (14af968) without the bug fix part and with a warning about known issue ? This is going to make pylint faster and not more buggy than the last available version

[jacobtylerwalls]

Sure, that sounds reasonable.

[Pierre-Sassoulas]

Opened #9620, I'll upgrade the release note once it's merged.

[Pierre-Sassoulas]

Let's release then 😄 ! Do you want to do it @jacobtylerwalls ?

[github-actions]

🤖 According to the primer, this change has no effect on the checked open source code. 🤖🎉

This comment was generated for commit d57ba03

[jacobtylerwalls]

Looks good, I edited the markdown in the PR to use a bullet point for the astroid update. Not worth changing the .rst file.