Release astroid 3.1.0

[cdce8p]

• Include PEP 695 (Python 3.12) generic type syntax nodes in get_children(),
  allowing checkers to visit them.

  Refs Undefined variable when using generic type parameters (PEP695) pylint#9193

• Add __main__ as a possible inferred value for __name__ to improve
  control flow inference around if __name__ == "__main__": guards.

  Closes Should infer more values for == __name__ (possibly other dunders) #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 RecursionError: maximum recursion depth exceeded while linting a large chained method calls pylint#8842

• Suppress SyntaxWarning for invalid escape sequences on Python 3.12 when parsing modules.

  Closes Suppress SyntaxWarning from invalid escape sequence pylint#9322

[codecov]

Codecov Report

All modified and coverable lines are covered by tests ✅

Project coverage is 92.75%. Comparing base (8c7106e) to head (d0ceea8).

Additional details and impacted files

@@           Coverage Diff           @@
##             main    #2390   +/-   ##
=======================================
  Coverage   92.75%   92.75%           
=======================================
  Files          94       94           
  Lines       11080    11080           
=======================================
  Hits        10277    10277           
  Misses        803      803           

Flag	Coverage Δ
linux	92.56% <100.00%> (ø)
pypy	90.75% <100.00%> (ø)
windows	92.34% <100.00%> (ø)

Flags with carried forward coverage won't be shown. Click here to find out more.

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