Python 3.11.0a7

Include/patchlevel.h

@@ -20,10 +20,10 @@
 #define PY_MINOR_VERSION        11
 #define PY_MICRO_VERSION        0
 #define PY_RELEASE_LEVEL        PY_RELEASE_LEVEL_ALPHA
-#define PY_RELEASE_SERIAL       6
+#define PY_RELEASE_SERIAL       7
 
 /* Version as a string */
-#define PY_VERSION              "3.11.0a6+"
+#define PY_VERSION              "3.11.0a7"
 /*--end constants--*/
 
 /* Version as a single 4-byte hex number, e.g. 0x010502B2 == 1.5.2b2.

Lib/pydoc_data/topics.py

 # -*- coding: utf-8 -*-
-# Autogenerated by Sphinx on Mon Mar  7 12:29:42 2022
+# Autogenerated by Sphinx on Tue Apr  5 20:53:43 2022
 topics = {'assert': 'The "assert" statement\n'
            '**********************\n'
            '\n'
@@ -93,11 +93,7 @@
                '  optionally in parentheses, the object is assigned to that '
                'target.\n'
                '\n'
-               '* Else: The object must be an iterable with the same number of '
-               'items\n'
-               '  as there are targets in the target list, and the items are '
-               'assigned,\n'
-               '  from left to right, to the corresponding targets.\n'
+               '* Else:\n'
                '\n'
                '  * If the target list contains one target prefixed with an '
                'asterisk,\n'
@@ -2328,27 +2324,18 @@
              '   for_stmt ::= "for" target_list "in" starred_list ":" suite\n'
              '                ["else" ":" suite]\n'
              '\n'
-             'The expression list is evaluated once; it should yield an '
-             'iterable\n'
-             'object.  An iterator is created for the result of the '
-             '"starred_list".\n'
-             'The expression list can contain starred elements ("*x, *y") that '
-             'will\n'
-             'be unpacked in the final iterator (as when constructing a '
-             '"tuple" or\n'
-             '"list" literal). The suite is then executed once for each item\n'
-             'provided by the iterator, in the order returned by the '
-             'iterator.  Each\n'
-             'item in turn is assigned to the target list using the standard '
-             'rules\n'
-             'for assignments (see Assignment statements), and then the suite '
-             'is\n'
-             'executed.  When the items are exhausted (which is immediately '
-             'when the\n'
-             'sequence is empty or an iterator raises a "StopIteration" '
-             'exception),\n'
-             'the suite in the "else" clause, if present, is executed, and the '
-             'loop\n'
+             'The "starred_list" expression is evaluated once; it should yield '
+             'an\n'
+             '*iterable* object.  An *iterator* is created for that iterable. '
+             'The\n'
+             'first item provided by the iterator is then assigned to the '
+             'target\n'
+             'list using the standard rules for assignments (see Assignment\n'
+             'statements), and the suite is executed.  This repeats for each '
+             'item\n'
+             'provided by the iterator.  When the iterator is exhausted, the '
+             'suite\n'
+             'in the "else" clause, if present, is executed, and the loop\n'
              'terminates.\n'
              '\n'
              'A "break" statement executed in the first suite terminates the '
@@ -2427,11 +2414,11 @@
              'resulting\n'
              'object is “compatible” with the exception.  An object is '
              'compatible\n'
-             'with an exception if the object is the class or a base class of '
-             'the\n'
-             'exception object, or a tuple containing an item that is the '
-             'class or a\n'
-             'base class of the exception object.\n'
+             'with an exception if the object is the class or a *non-virtual '
+             'base\n'
+             'class* of the exception object, or a tuple containing an item '
+             'that is\n'
+             'the class or a non-virtual base class of the exception object.\n'
              '\n'
              'If no except clause matches the exception, the search for an '
              'exception\n'
@@ -4461,15 +4448,17 @@
                   'on members\n'
                   '   of hashed collections including "set", "frozenset", and '
                   '"dict".\n'
-                  '   "__hash__()" should return an integer. The only required '
-                  'property\n'
-                  '   is that objects which compare equal have the same hash '
-                  'value; it is\n'
-                  '   advised to mix together the hash values of the '
-                  'components of the\n'
-                  '   object that also play a part in comparison of objects by '
-                  'packing\n'
-                  '   them into a tuple and hashing the tuple. Example:\n'
+                  '   The "__hash__()" method should return an integer. The '
+                  'only required\n'
+                  '   property is that objects which compare equal have the '
+                  'same hash\n'
+                  '   value; it is advised to mix together the hash values of '
+                  'the\n'
+                  '   components of the object that also play a part in '
+                  'comparison of\n'
+                  '   objects by packing them into a tuple and hashing the '
+                  'tuple.\n'
+                  '   Example:\n'
                   '\n'
                   '      def __hash__(self):\n'
                   '          return hash((self.name, self.nick, self.color))\n'
@@ -5458,11 +5447,11 @@
                'clause is\n'
                'selected depending on the class of the instance: it must '
                'reference the\n'
-               'class of the instance or a base class thereof.  The instance '
-               'can be\n'
-               'received by the handler and can carry additional information '
-               'about the\n'
-               'exceptional condition.\n'
+               'class of the instance or a *non-virtual base class* thereof. '
+               'The\n'
+               'instance can be received by the handler and can carry '
+               'additional\n'
+               'information about the exceptional condition.\n'
                '\n'
                'Note:\n'
                '\n'
@@ -5797,11 +5786,11 @@
               'clause is\n'
               'selected depending on the class of the instance: it must '
               'reference the\n'
-              'class of the instance or a base class thereof.  The instance '
-              'can be\n'
-              'received by the handler and can carry additional information '
-              'about the\n'
-              'exceptional condition.\n'
+              'class of the instance or a *non-virtual base class* thereof. '
+              'The\n'
+              'instance can be received by the handler and can carry '
+              'additional\n'
+              'information about the exceptional condition.\n'
               '\n'
               'Note:\n'
               '\n'
@@ -5901,23 +5890,13 @@
         '   for_stmt ::= "for" target_list "in" starred_list ":" suite\n'
         '                ["else" ":" suite]\n'
         '\n'
-        'The expression list is evaluated once; it should yield an iterable\n'
-        'object.  An iterator is created for the result of the '
-        '"starred_list".\n'
-        'The expression list can contain starred elements ("*x, *y") that '
-        'will\n'
-        'be unpacked in the final iterator (as when constructing a "tuple" or\n'
-        '"list" literal). The suite is then executed once for each item\n'
-        'provided by the iterator, in the order returned by the iterator.  '
-        'Each\n'
-        'item in turn is assigned to the target list using the standard rules\n'
-        'for assignments (see Assignment statements), and then the suite is\n'
-        'executed.  When the items are exhausted (which is immediately when '
-        'the\n'
-        'sequence is empty or an iterator raises a "StopIteration" '
-        'exception),\n'
-        'the suite in the "else" clause, if present, is executed, and the '
-        'loop\n'
+        'The "starred_list" expression is evaluated once; it should yield an\n'
+        '*iterable* object.  An *iterator* is created for that iterable. The\n'
+        'first item provided by the iterator is then assigned to the target\n'
+        'list using the standard rules for assignments (see Assignment\n'
+        'statements), and the suite is executed.  This repeats for each item\n'
+        'provided by the iterator.  When the iterator is exhausted, the suite\n'
+        'in the "else" clause, if present, is executed, and the loop\n'
         'terminates.\n'
         '\n'
         'A "break" statement executed in the first suite terminates the loop\n'
@@ -9388,15 +9367,17 @@
                  'on members\n'
                  '   of hashed collections including "set", "frozenset", and '
                  '"dict".\n'
-                 '   "__hash__()" should return an integer. The only required '
-                 'property\n'
-                 '   is that objects which compare equal have the same hash '
-                 'value; it is\n'
-                 '   advised to mix together the hash values of the components '
-                 'of the\n'
-                 '   object that also play a part in comparison of objects by '
-                 'packing\n'
-                 '   them into a tuple and hashing the tuple. Example:\n'
+                 '   The "__hash__()" method should return an integer. The '
+                 'only required\n'
+                 '   property is that objects which compare equal have the '
+                 'same hash\n'
+                 '   value; it is advised to mix together the hash values of '
+                 'the\n'
+                 '   components of the object that also play a part in '
+                 'comparison of\n'
+                 '   objects by packing them into a tuple and hashing the '
+                 'tuple.\n'
+                 '   Example:\n'
                  '\n'
                  '      def __hash__(self):\n'
                  '          return hash((self.name, self.nick, self.color))\n'
@@ -10003,14 +9984,14 @@
                  '\n'
                  'Whenever a class inherits from another class, '
                  '"__init_subclass__()" is\n'
-                 'called on that class. This way, it is possible to write '
-                 'classes which\n'
-                 'change the behavior of subclasses. This is closely related '
-                 'to class\n'
-                 'decorators, but where class decorators only affect the '
-                 'specific class\n'
-                 'they’re applied to, "__init_subclass__" solely applies to '
-                 'future\n'
+                 'called on the parent class. This way, it is possible to '
+                 'write classes\n'
+                 'which change the behavior of subclasses. This is closely '
+                 'related to\n'
+                 'class decorators, but where class decorators only affect the '
+                 'specific\n'
+                 'class they’re applied to, "__init_subclass__" solely applies '
+                 'to future\n'
                  'subclasses of the class defining the method.\n'
                  '\n'
                  'classmethod object.__init_subclass__(cls)\n'
@@ -12381,67 +12362,86 @@
  'subscriptions': 'Subscriptions\n'
                   '*************\n'
                   '\n'
-                  'Subscription of a sequence (string, tuple or list) or '
-                  'mapping\n'
-                  '(dictionary) object usually selects an item from the '
-                  'collection:\n'
+                  'The subscription of an instance of a container class will '
+                  'generally\n'
+                  'select an element from the container. The subscription of a '
+                  '*generic\n'
+                  'class* will generally return a GenericAlias object.\n'
                   '\n'
                   '   subscription ::= primary "[" expression_list "]"\n'
                   '\n'
+                  'When an object is subscripted, the interpreter will '
+                  'evaluate the\n'
+                  'primary and the expression list.\n'
+                  '\n'
                   'The primary must evaluate to an object that supports '
-                  'subscription\n'
-                  '(lists or dictionaries for example).  User-defined objects '
-                  'can support\n'
-                  'subscription by defining a "__getitem__()" method.\n'
+                  'subscription. An\n'
+                  'object may support subscription through defining one or '
+                  'both of\n'
+                  '"__getitem__()" and "__class_getitem__()". When the primary '
+                  'is\n'
+                  'subscripted, the evaluated result of the expression list '
+                  'will be\n'
+                  'passed to one of these methods. For more details on when\n'
+                  '"__class_getitem__" is called instead of "__getitem__", '
+                  'see\n'
+                  '__class_getitem__ versus __getitem__.\n'
+                  '\n'
+                  'If the expression list contains at least one comma, it will '
+                  'evaluate\n'
+                  'to a "tuple" containing the items of the expression list. '
+                  'Otherwise,\n'
+                  'the expression list will evaluate to the value of the '
+                  'list’s sole\n'
+                  'member.\n'
                   '\n'
                   'For built-in objects, there are two types of objects that '
                   'support\n'
-                  'subscription:\n'
+                  'subscription via "__getitem__()":\n'
                   '\n'
-                  'If the primary is a mapping, the expression list must '
-                  'evaluate to an\n'
-                  'object whose value is one of the keys of the mapping, and '
+                  '1. Mappings. If the primary is a *mapping*, the expression '
+                  'list must\n'
+                  '   evaluate to an object whose value is one of the keys of '
                   'the\n'
-                  'subscription selects the value in the mapping that '
-                  'corresponds to that\n'
-                  'key.  (The expression list is a tuple except if it has '
-                  'exactly one\n'
-                  'item.)\n'
+                  '   mapping, and the subscription selects the value in the '
+                  'mapping that\n'
+                  '   corresponds to that key. An example of a builtin mapping '
+                  'class is\n'
+                  '   the "dict" class.\n'
                   '\n'
-                  'If the primary is a sequence, the expression list must '
-                  'evaluate to an\n'
-                  'integer or a slice (as discussed in the following '
-                  'section).\n'
+                  '2. Sequences. If the primary is a *sequence*, the '
+                  'expression list must\n'
+                  '   evaluate to an "int" or a "slice" (as discussed in the '
+                  'following\n'
+                  '   section). Examples of builtin sequence classes include '
+                  'the "str",\n'
+                  '   "list" and "tuple" classes.\n'
                   '\n'
                   'The formal syntax makes no special provision for negative '
                   'indices in\n'
-                  'sequences; however, built-in sequences all provide a '
+                  '*sequences*. However, built-in sequences all provide a '
                   '"__getitem__()"\n'
                   'method that interprets negative indices by adding the '
                   'length of the\n'
-                  'sequence to the index (so that "x[-1]" selects the last '
-                  'item of "x").\n'
-                  'The resulting value must be a nonnegative integer less than '
-                  'the number\n'
-                  'of items in the sequence, and the subscription selects the '
-                  'item whose\n'
-                  'index is that value (counting from zero). Since the support '
-                  'for\n'
-                  'negative indices and slicing occurs in the object’s '
-                  '"__getitem__()"\n'
-                  'method, subclasses overriding this method will need to '
-                  'explicitly add\n'
-                  'that support.\n'
-                  '\n'
-                  'A string’s items are characters.  A character is not a '
-                  'separate data\n'
-                  'type but a string of exactly one character.\n'
+                  'sequence to the index so that, for example, "x[-1]" selects '
+                  'the last\n'
+                  'item of "x". The resulting value must be a nonnegative '
+                  'integer less\n'
+                  'than the number of items in the sequence, and the '
+                  'subscription selects\n'
+                  'the item whose index is that value (counting from zero). '
+                  'Since the\n'
+                  'support for negative indices and slicing occurs in the '
+                  'object’s\n'
+                  '"__getitem__()" method, subclasses overriding this method '
+                  'will need to\n'
+                  'explicitly add that support.\n'
                   '\n'
-                  'Subscription of certain *classes* or *types* creates a '
-                  'generic alias.\n'
-                  'In this case, user-defined classes can support subscription '
-                  'by\n'
-                  'providing a "__class_getitem__()" classmethod.\n',
+                  'A "string" is a special kind of sequence whose items are '
+                  '*characters*.\n'
+                  'A character is not a separate data type but a string of '
+                  'exactly one\n'
+                  'character.\n',
  'truth': 'Truth Value Testing\n'
           '*******************\n'
           '\n'
@@ -12502,10 +12502,10 @@
         'exception.  For an except clause with an expression, that expression\n'
         'is evaluated, and the clause matches the exception if the resulting\n'
         'object is “compatible” with the exception.  An object is compatible\n'
-        'with an exception if the object is the class or a base class of the\n'
-        'exception object, or a tuple containing an item that is the class or '
-        'a\n'
-        'base class of the exception object.\n'
+        'with an exception if the object is the class or a *non-virtual base\n'
+        'class* of the exception object, or a tuple containing an item that '
+        'is\n'
+        'the class or a non-virtual base class of the exception object.\n'
         '\n'
         'If no except clause matches the exception, the search for an '
         'exception\n'

Misc/NEWS.d/next/Build/2022-03-04-21-24-02.bpo-45774.9AhC0r.rst

-``configure`` now verifies that all SQLite C APIs needed for the
-:mod:`sqlite3` extension module are found.

Misc/NEWS.d/next/Build/2022-03-10-09-37-05.bpo-46917.fry4aK.rst

-Building Python now requires support of IEEE 754 floating point numbers.
-Patch by Victor Stinner.

Misc/NEWS.d/next/Build/2022-03-10-14-30-39.bpo-46973._LEvnc.rst

-Add ``regen-configure`` make target to regenerate configure script with
-Christian's container image ``quay.io/tiran/cpython_autoconf:269``.

Misc/NEWS.d/next/Build/2022-03-12-18-09-31.bpo-46996.SygzVz.rst

-The :mod:`tkinter` package now requires Tcl/Tk version 8.5.12 or newer.

Misc/NEWS.d/next/Build/2022-03-15-09-28-55.bpo-47024.t7-dcu.rst

-Update OpenSSL to 1.1.1n for macOS installers and all Windows builds.

Misc/NEWS.d/next/Build/2022-03-16-00-37-40.bpo-47032.tsS9KE.rst

-Ensure Windows install builds fail correctly with a non-zero exit code when
-part of the build fails.

Misc/NEWS.d/next/Build/2022-03-24-12-12-35.bpo-40280.eAQWrM.rst

-Add SOABI ``wasm32-emscripten`` for Emscripten and ``wasm32-wasi`` for WASI
-on 32bit WASM as well as ``wasm64`` counter parts.

Misc/NEWS.d/next/Build/2022-04-01-16-12-53.bpo-46023.1Z1OcC.rst

-``makesetup`` now detects and skips all duplicated module definitions. The
-first entry wins.

Misc/NEWS.d/next/Build/2022-04-02-17-52-38.bpo-40280.U8Dd0H.rst

-Add configure option :option:`--enable-wasm-dynamic-linking` to enable
-``dlopen`` and MAIN_MODULE / SIDE_MODULE on ``wasm32-emscripten``.

Misc/NEWS.d/next/C API/2022-03-03-11-12-33.bpo-46906.-olyBI.rst

-Add new functions to pack and unpack C double (serialize and deserialize):
-:c:func:`PyFloat_Pack2`, :c:func:`PyFloat_Pack4`, :c:func:`PyFloat_Pack8`,
-:c:func:`PyFloat_Unpack2`, :c:func:`PyFloat_Unpack4` and
-:c:func:`PyFloat_Unpack8`. Patch by Victor Stinner.

Misc/NEWS.d/next/C API/2022-03-12-18-37-06.bpo-46987.LWcwyN.rst

-Remove private functions ``_PySys_GetObjectId()`` and ``_PySys_SetObjectId()``.
-Patch by Dong-hee Na.

Misc/NEWS.d/next/C API/2022-03-21-00-41-29.bpo-46850.rOt771.rst

-Remove the following private undocumented functions from the C API:
-
-* ``_PyEval_GetAsyncGenFirstiter()``
-* ``_PyEval_GetAsyncGenFinalizer()``
-* ``_PyEval_SetAsyncGenFirstiter()``
-* ``_PyEval_SetAsyncGenFinalizer()``
-
-Call the public :func:`sys.get_asyncgen_hooks` and
-:func:`sys.set_asyncgen_hooks` functions instead. Patch by Victor Stinner.

Misc/NEWS.d/next/C API/2022-03-21-01-30-14.bpo-46850.Tfxde5.rst

-Remove the private undocumented function
-``_PyEval_GetCoroutineOriginTrackingDepth()`` from the C API. Call the
-public :func:`sys.get_coroutine_origin_tracking_depth` function instead.
-Patch by Victor Stinner.

Misc/NEWS.d/next/C API/2022-03-21-02-26-27.bpo-46850.hU3c-O.rst

-Remove the private undocumented function ``_PyEval_CallTracing()`` from the
-C API. Call the public :func:`sys.call_tracing` function instead. Patch by
-Victor Stinner.

Misc/NEWS.d/next/C API/2022-03-22-16-48-02.bpo-46850.7M5dO7.rst

-Move the private undocumented ``_PyEval_EvalFrameDefault()`` function to the
-internal C API. The function now uses the ``_PyInterpreterFrame`` type which is
-part of the internal C API. Patch by Victor Stinner.

Misc/NEWS.d/next/C API/2022-03-22-16-59-34.bpo-46850.lmEKLy.rst

-Move the private ``_PyFrameEvalFunction`` type, and private
-``_PyInterpreterState_GetEvalFrameFunc()`` and
-``_PyInterpreterState_SetEvalFrameFunc()`` functions to the internal C API. The
-``_PyFrameEvalFunction`` callback function type now uses the
-``_PyInterpreterFrame`` type which is part of the internal C API. Patch by
-Victor Stinner.

Misc/NEWS.d/next/C API/2022-03-25-13-40-46.bpo-40421.wJREl2.rst

-Add ``PyFrame_GetBuiltins``, ``PyFrame_GetGenerator`` and
-``PyFrame_GetGlobals`` C-API functions to access frame object attributes
-safely from C code.