• Include PEP 695 (Python 3.12) generic type syntax nodes in get_children(), allowing checkers to visit them. Refs pylint-dev/pylint#9193
• Add __main__ as a possible inferred value for __name__ to improve control flow inference around if __name__ == "__main__": guards. Closes #2071
• Following a deprecation period, the names arg to the Import constructor and the op arg to the BoolOp constructor are now required, and the doc args to the PartialFunction and Property constructors have been removed (call postinit(doc_node=...) instead.)
• Following a deprecation announced in astroid 1.5.0, the alias AstroidBuildingException is removed in favor of AstroidBuildingError.
• Include modname in AST warnings. Useful for invalid escape sequence warnings with Python 3.12.
• RecursionError is now trapped and logged out as UserWarning during astroid node transformations with instructions about raising the system recursion limit. Closes pylint-dev/pylint#8842
• Suppress SyntaxWarning for invalid escape sequences on Python 3.12 when parsing modules. Closes pylint-dev/pylint#9322

• Fix type of UnicodeDecodeError.object inferred as str instead of bytes.

  Closes pylint-dev/pylint#9342

• Fix no-member false positives for args and kwargs on ParamSpec under Python 3.12.

  Closes pylint-dev/pylint#9401

What's New in astroid 3.0.2?

Release date: 2023-12-12

• Avoid duplicate inference results for some uses of typing.X constructs like Tuple[Optional[int], ...]. This was causing pylint to occasionally omit messages like deprecated-typing-alias. Closes pylint-dev/pylint#9220

• Fix crashes linting code using PEP 695 (Python 3.12) generic type syntax.

  Closes pylint-dev/pylint#9098

• Add support for Python 3.12, including PEP 695 type parameter syntax.

  Closes #2201

• Remove support for Python 3.7.

  Refs #2137

• Use the global inference cache when inferring, even without an explicit InferenceContext. This is a significant performance improvement given how often methods default to None for the context argument. (Linting astroid itself now takes ~5% less time on Python 3.12; other projects requiring more complex inference calculations will see greater speedups.)

  Refs #529

• Following a deprecation period starting in astroid 2.7.0, the astroid.node_classes and astroid.scoped_nodes modules have been removed in favor of astroid.nodes.node_classes and astroid.nodes.scoped_nodes.

  Closes #1072

• Following a deprecation period starting in astroid 2.12.0, the astroid.mixins module has been removed in favor of astroid.nodes._base_nodes (private).

  Refs #1633

• Return all existing arguments when calling Arguments.arguments(). This also means find_argname will now use the whole list of arguments for its search.

  Closes #2213

• Exclude class attributes from the __members__ container of an Enum class when they are nodes.AnnAssign nodes with no assigned value.

  Refs pylint-dev/pylint#7402

• Remove @cached and @cachedproperty decorator (just use @cached_property from the stdlib).

  Closes #1780 Refs #2140

• Remove the inference module. Node inference methods are now in the module defining the node, rather than being associated to the node afterward.

  Closes #679

• Move LookupMixIn to astroid.nodes._base_nodes and make it private.

• Remove the shims for OperationError, BinaryOperationError, and UnaryOperationError in exceptions. They were moved to util in astroid 1.5.0.

• Move safe_infer() from helpers to util. This avoids some circular imports.

• Reduce file system access in ast_from_file().

• Reduce time to import astroid by delaying astroid_bootstrapping() until the first instantiation of AstroidBuilder.

  Closes #2161

• Make igetattr() idempotent. This addresses some reports of varying results when running pylint with --jobs.

  Closes pylint-dev/pylint#4356 Refs #7

• Fix incorrect cache keys for inference results, thereby correctly inferring types for calls instantiating types dynamically.

  Closes #1828 Closes pylint-dev/pylint#7464 Closes pylint-dev/pylint#8074

• Fix interrupted InferenceContext call chains, thereby addressing performance problems when linting sqlalchemy.

  Closes pylint-dev/pylint#8150

• nodes.FunctionDef no longer inherits from nodes.Lambda. This is a breaking change but considered a bug fix as the nodes did not share the same API and were not interchangeable.

  We have tried to minimize the amount of breaking changes caused by this change but some are unavoidable.

• infer_call_result now shares the same interface across all implementations. Namely:

  def infer_call_result(
                self,
                caller: SuccessfulInferenceResult | None,
                context: InferenceContext | None = None,
            ) -> Iterator[InferenceResult]:
  

  This is a breaking change for nodes.FunctionDef where previously caller had a default of None. Passing None again will not create a behaviour change. The breaking change allows us to better type and re-use the method within astroid.

• Improved signature of the __init__ and __postinit__ methods of most nodes. This includes making lineno, col_offset, end_lineno, end_col_offset and parent required arguments for nodes.NodeNG and its subclasses. For most other nodes, arguments of their __postinit__ methods have been made required to better represent how they would normally be constructed by the standard library ast module. The following nodes were changed or updated:

  • nodes.AnnAssign
  • nodes.Arguments
  • nodes.Assign
  • nodes.AssignAttr
  • nodes.AssignName
  • nodes.Attribute
  • nodes.AugAssign
  • nodes.Await
  • nodes.BaseContainer
  • nodes.BinOp
  • nodes.Call
  • nodes.ClassDef
  • nodes.Compare
  • nodes.Comprehension
  • nodes.Decorators
  • nodes.Delete
  • nodes.DelAttr
  • nodes.DelName
  • nodes.Dict
  • nodes.DictComp
  • nodes.ExceptHandler
  • nodes.Expr
  • nodes.For
  • nodes.FunctionDef
  • nodes.GeneratorExp
  • nodes.If
  • nodes.IfExp
  • nodes.Keyword
  • nodes.Lambda
  • nodes.ListComp
  • nodes.Module
  • nodes.Name
  • nodes.NodeNG
  • nodes.Raise
  • nodes.Return
  • nodes.SetComp
  • nodes.Slice
  • nodes.Starred
  • objects.Super, we also added the call parameter to its __init__ method.
  • nodes.Subscript
  • nodes.UnaryOp
  • nodes.While
  • nodes.Yield

  These changes involve breaking changes to their API but should be considered bug fixes. We now make arguments required when they are instead of always providing defaults.

• nodes.If.self.is_orelse has been removed as it was never set correctly and therefore provided a false value.

• Remove dependency on wrapt.

• Remove dependency on lazy_object_proxy. This includes the removal of the associated lazy_import, lazy_descriptor and proxy_alias utility functions.

• CallSite._unpack_args and CallSite._unpack_keywords now use safe_infer() for better inference and fewer false positives.

  Closes pylint-dev/pylint#8544

• Add attr.Factory to the recognized class attributes for classes decorated with attrs.

  Closes pylint-dev/pylint#4341

• infer_property() now observes the same property-specific workaround as infer_functiondef.

  Refs #1490

• Remove unused and / or deprecated constants:

  • astroid.bases.BOOL_SPECIAL_METHOD
  • astroid.bases.BUILTINS
  • astroid.const.BUILTINS
  • astroid.const.PY38_PLUS
  • astroid.const.Load
  • astroid.const.Store
  • astroid.const.Del

  Refs #2141

• frame() raises ParentMissingError and statement() raises StatementMissing for missing parents regardless of the value of the future argument (which gave this behavior already).

  The future argument to each method is deprecated and will be removed in astroid 4.0.

  Refs #1217

• Remove deprecated Ellipsis, ExtSlice, Index nodes.

  Refs #2152

• Remove deprecated is_sys_guard and is_typing_guard methods.

  Refs #2153

• Remove deprecated doc attribute for Module, ClassDef, and FunctionDef. Use the doc_node attribute instead.

  Refs #2154

• Add new nodes.Try to better match Python AST. Replaces the TryExcept and TryFinally nodes which have been removed.

• Publicize NodeNG.repr_name() to facilitate finding a node's nice name.

  Refs pylint-dev/pylint#8598

• Fix false positives for no-member and invalid-name when using the _name_, _value_ and _ignore_ sunders in Enums.

  Closes pylint-dev/pylint#9015

• Fix a regression in 2.15.7 for unsubscriptable-object.

  Closes #2305 Closes pylint-dev/pylint#9069

Pre-release for astroid 3.0.0, with API deprecation applied.

• Fix a crash when inferring a typing.TypeVar call.

  Closes pylint-dev/pylint#8802

• Infer user-defined enum classes by checking if the class is a subtype of enum.Enum.

  Closes pylint-dev/pylint#8897

• Fix inference of functions with @functools.lru_cache decorators without parentheses.

  Closes pylint-dev/pylint#8868

• Make sys.argv uninferable because it never is. (It's impossible to infer the value it will have outside of static analysis where it's our own value.)

  Refs pylint-dev/pylint#7710

Pre-release for astroid 3.0.0, with performance improvements, fixes for Python 3.12 compatibility, and an improvement to Arguments.arguments(), among other changes.

See the full list of changes.

Pre-release for astroid 3.0.0, for https://github.com/pylint-dev/astroid/pull/2250 and python 3.12 in pylint. For a full list of changes see https://github.com/pylint-dev/astroid/blob/v3.0.0a8/ChangeLog