Release branch 3.0.0a6

[Pierre-Sassoulas]

Breaking Changes

• 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 Use better default colors for pyreverse #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 [__implements__] Remove everything related to the rejected PEP245 #8404

• pyreverse: Support for the .vcg output format (Visualaization of
  Compiler Graphs) has been dropped.

  Closes Deprecate / remove support for .vcg files in pyreverse #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.

  Refs [deprecation] Remove the warning about the old pylint home #8462

Changes requiring user actions

• epylint was removed. It now lives at:
  https://github.com/emacsorphanage/pylint.

  Refs Please consider maintaining the Emacs-Lisp files in a separate repository #7737

• The 'overgeneral-exceptions' option now only takes fully qualified name
  into account (builtins.Exception not Exception). If you overrode
  this 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 [overgeneral-exceptions] Only handle qualified names #8411

• Following a deprecation period, it's no longer possible to use MASTER
  or master as configuration section in setup.cfg or tox.ini. It's
  bad practice
  to not start sections titles with the tool name. Please use pylint.main
  instead.

  Refs [deprecation] setup.cfgand tox.ini sections need to start by 'pylint' #8465

New Features

• Add new option (--show-stdlib, -L) to pyreverse.
  This is similar to the behavior of --show-builtin in that standard
  library
  modules are now not included by default, and this option will include them.

  Closes pyreverse: Add option to exclude standard library #8181

False Positives Fixed

• Adds asyncSetUp to the default defining-attr-methods list to silence
  attribute-defined-outside-init warning when using
  unittest.IsolatedAsyncioTestCase.

  Refs Add Python 3.8+ asyncSetUp to "defining-attr-methods" list #8403

• invalid-name now allows for integers in typealias names:

  • now valid: Good2Name, GoodName2.
  • still invalid: _1BadName.

  Closes invalid-name check for TypeAlias should allow for digits in names #8485

• No longer consider Union as type annotation as type alias for naming
  checks.

  Closes invalid-name type alias false-positive for union values #8487

• unnecessary-lambda no longer warns on lambdas which use its parameters in
  their body (other than the final arguments), e.g.
  lambda foo: (bar if foo else baz)(foo).

  Closes unnecessary-lambda false positive if parameter is used in lambda body #8496

Other Bug Fixes

• --clear-cache-post-run now also clears LRU caches for pylint utilities
  holding references to AST nodes.

  Closes Clear pylint's LRU caches when using --clear-cache-post-run #8361

• Fix a crash when TYPE_CHECKING is used without importing it.

  Closes in_type_checking_block can crash if you haven't imported TYPE_CHECKING #8434

• Fix a used-before-assignment false positive when imports
  are made under the TYPE_CHECKING else if branch.

  Closes used-before-assignment false positive for import nodes under elif after TYPE_CHECKING #8437

• Fix a regression of preferred-modules where a partial match was used
  instead of the required full match.

  Closes v2.17.0 regression related to W0407: preferred-modules #8453

Other Changes

• Pylint now exposes its type annotations.

  Closes Expose types #5488 and Annotate pylint code with type annotations #2079

• All code related to the optparse config parsing has been removed.

  Refs Remove all old code related to optparse config parsing. #8405

Internal Changes

• get_message_definition was removed from the base checker API. You can
  access
  message definitions through the MessageStore.

  Refs [deprecation] Remove get_message_definitions from BaseChecker #8401

• Everything related to the __implements__ construct was removed. It was
  based on PEP245
  that was proposed in 2001 and rejected in 2006.

  All the classes inheriting Interface in pylint.interfaces were
  removed.
  Checker should only inherit BaseChecker or any of the other checker
  types
  from pylint.checkers. Reporter should only inherit BaseReporter.

  Refs [__implements__] Remove everything related to the rejected PEP245 #8404

• modname and msg_store are now required to be given in FileState.
  collect_block_lines has also been removed. Pylinter.current_name
  cannot be null anymore.

  Refs [FileState] Deprecation enactment for 3.0.0 #8407

• 'Reporter.set_output' was removed in favor of 'reporter.out = stream'.

  Refs [Reporter] Remove 'set_output' in favor of reporter.out #8408

• A number of old utility functions and classes have been removed:

  MapReduceMixin: To make a checker reduce map data simply implement
  get_map_data and reduce_map_data.

  is_inside_lambda: Use utils.get_node_first_ancestor_of_type(x, nodes.Lambda)

  check_messages: Use utils.only_required_for_messages

  is_class_subscriptable_pep585_with_postponed_evaluation_enabled: Use
  is_postponed_evaluation_enabled(node) and
  is_node_in_type_annotation_context(node)

  get_python_path: assumption that there's always an init.py is not
  true since
  python 3.3 and is causing problems, particularly with PEP 420. Use
  discover_package_path
  and pass source root(s).

  fix_import_path: Use augmented_sys_path and pass additional
  sys.path
  entries as an argument obtained from discover_package_path.

  get_global_option: Use checker.linter.config to get all global
  options.

  Related private objects have been removed as well.

  Refs Remove deprecated functions and classes #8409

• colorize_ansi now only accept a MessageStyle object.

  Refs [colorize_ansi] Remove the possibility to use anything else than a MessageStyle #8412

• The following utilities are deprecated in favor of the more robust
  in_type_checking_block
  and will be removed in pylint 3.0:

  • is_node_in_guarded_import_block
  • is_node_in_typing_guarded_import_block
  • is_typing_guard

  is_sys_guard is still available, which was part of
  is_node_in_guarded_import_block.

  Refs Deprecate redundant type checking guard utils #8433

• Following a deprecation period, Pylinter.check now only work with
  sequences of strings, not strings.

  Refs [deprecation] 'Pylinter.check' now takes sequence of str only #8463

• Following a deprecation period, ColorizedTextReporter only accepts
  ColorMappingDict.

  Refs [deprecation] 'ColorizedTextReporter' only accepts 'ColorMappingDict' #8464

• Following a deprecation period, MessageTest's end_line and
  end_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 [deprecation] end_line and end_col_offset required in functional tests #8466

• Following a deprecation period, the do_exit argument of the Run class
  (and of the _Run
  class in testutils) were removed.

  Refs [deprecation] Remove 'do_exit' from the 'Run' constructor #8472

• Following a deprecation period, the py_version argument of the
  MessageDefinition.may_be_emitted function is now required. The most
  likely solution
  is to use 'linter.config.py_version' if you need to keep using this
  function, or to use 'MessageDefinition.is_message_enabled' instead.

  Refs [deprecation] Make 'py_version' required for 'MessageDefinition.may_be_emitted' #8473

• Following a deprecation period, the OutputLine class now requires
  the right number of argument all the time. The functional output can be
  regenerated automatically to achieve that easily.

  Refs [deprecation] Make 'OutputLine' require a fixed number of args #8474

• Following a deprecation period, is_typing_guard,
  is_node_in_typing_guarded_import_block and
  is_node_in_guarded_import_block: from pylint.utils were removed: use
  a combination of
  is_sys_guard and in_type_checking_block instead.

  Refs [deprecation] Remove all duplicated typing guard check functions #8475

• Following a deprecation period, the location argument of the
  Message class must now be a MessageLocationTuple.

  Refs [deprecation] Message.location must be a 'MessageLocationTuple' #8477

• Following a deprecation period, the check_single_file function of the
  Pylinter is replaced by Pylinter.check_single_file_item.

  Refs [deprecation] 'check_single_file' replaced by 'check_single_file_item' #8478

[codecov]

Codecov Report

Merging #8521 (f5a3622) into main (e9894d3) will not change coverage.
The diff coverage is 100.00%.

Additional details and impacted files

@@           Coverage Diff           @@
##             main    #8521   +/-   ##
=======================================
  Coverage   95.90%   95.90%           
=======================================
  Files         174      174           
  Lines       18357    18357           
=======================================
  Hits        17605    17605           
  Misses        752      752           

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

[github-actions]

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

This comment was generated for commit f5a3622