v3.0.0a6
Pre-release3.0.0a6 is an alpha release, other breaking changes will be added before the official 3.0.0 release. We're including the new features and false negative fixes that will be in 3.0.0, so it's the latest current version of pylint.
Breaking Changes
-
pyreversenow uses a new default color palette that is more colorblind
friendly.
The color scheme is taken from Paul Tol's Notes.
If you prefer other colors, you can use the--color-paletteoption 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.vcgoutput format (Visualaization 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.Refs #8462
Changes requiring user actions
-
epylint was removed. It now lives at:
https://github.com/emacsorphanage/pylint.Refs #7737
-
The 'overgeneral-exceptions' option now only takes fully qualified name
into account (builtins.ExceptionnotException). 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 #8411
-
Following a deprecation period, it's no longer possible to use
MASTER
ormasteras configuration section insetup.cfgortox.ini. It's
bad practice
to not start sections titles with the tool name. Please usepylint.main
instead.Refs #8465
New Features
-
Add new option (
--show-stdlib,-L) topyreverse.
This is similar to the behavior of--show-builtinin that standard
library
modules are now not included by default, and this option will include them.Closes #8181
False Positives Fixed
-
Adds
asyncSetUpto the defaultdefining-attr-methodslist to silence
attribute-defined-outside-initwarning when using
unittest.IsolatedAsyncioTestCase.Refs #8403
-
invalid-namenow allows for integers intypealiasnames:- now valid:
Good2Name,GoodName2. - still invalid:
_1BadName.
Closes #8485
- now valid:
-
No longer consider
Unionas type annotation as type alias for naming
checks.Closes #8487
-
unnecessary-lambdano 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 #8496
Other Bug Fixes
-
--clear-cache-post-runnow also clears LRU caches for pylint utilities
holding references to AST nodes.Closes #8361
-
Fix a crash when
TYPE_CHECKINGis used without importing it.Closes #8434
-
Fix a
used-before-assignmentfalse positive when imports
are made under theTYPE_CHECKINGelse if branch.Closes #8437
-
Fix a regression of
preferred-moduleswhere a partial match was used
instead of the required full match.Closes #8453
Other Changes
-
Pylint now exposes its type annotations.
-
All code related to the optparse config parsing has been removed.
Refs #8405
Internal Changes
-
get_message_definitionwas removed from the base checker API. You can
access
message definitions through theMessageStore.Refs #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
Interfaceinpylint.interfaceswere
removed.
Checkershould only inheritBaseCheckeror any of the other checker
types
frompylint.checkers.Reportershould only inheritBaseReporter.Refs #8404
-
modnameandmsg_storeare now required to be given inFileState.
collect_block_lineshas also been removed.Pylinter.current_name
cannot be null anymore.Refs #8407
-
'Reporter.set_output' was removed in favor of 'reporter.out = stream'.
Refs #8408
-
A number of old utility functions and classes have been removed:
MapReduceMixin: To make a checker reduce map data simply implement
get_map_dataandreduce_map_data.is_inside_lambda: Useutils.get_node_first_ancestor_of_type(x, nodes.Lambda)check_messages: Useutils.only_required_for_messagesis_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: Useaugmented_sys_pathand pass additional
sys.path
entries as an argument obtained fromdiscover_package_path.get_global_option: Usechecker.linter.configto get all global
options.Related private objects have been removed as well.
Refs #8409
-
colorize_ansinow only accept aMessageStyleobject.Refs #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_blockis_node_in_typing_guarded_import_blockis_typing_guard
is_sys_guardis still available, which was part of
is_node_in_guarded_import_block.Refs #8433
-
Following a deprecation period,
Pylinter.checknow only work with
sequences of strings, not strings.Refs #8463
-
Following a deprecation period,
ColorizedTextReporteronly accepts
ColorMappingDict.Refs #8464
-
Following a deprecation period,
MessageTest'send_lineand
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 #8466
-
Following a deprecation period, the
do_exitargument of theRunclass
(and of the_Run
class in testutils) were removed.Refs #8472
-
Following a deprecation period, the
py_versionargument of the
MessageDefinition.may_be_emittedfunction 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 #8473
-
Following a deprecation period, the
OutputLineclass now requires
the right number of argument all the time. The functional output can be
regenerated automatically to achieve that easily.Refs #8474
-
Following a deprecation period,
is_typing_guard,
is_node_in_typing_guarded_import_blockand
is_node_in_guarded_import_block: frompylint.utilswere removed: use
a combination of
is_sys_guardandin_type_checking_blockinstead.Refs #8475
-
Following a deprecation period, the
locationargument of the
Messageclass must now be aMessageLocationTuple.Refs #8477
-
Following a deprecation period, the
check_single_filefunction of the
Pylinteris replaced byPylinter.check_single_file_item.Refs #8478