bpo-46048: Fix parsing of single character lines in getpath readlines() (GH-30048)

bpo-19737: Improved the documentation for globals (GH-29823)

Co-authored-by: Alex Waygood <Alex.Waygood@Gmail.com>
Co-authored-by: Łukasz Langa <lukasz@langa.pl>

build(deps): bump actions/cache from 2.1.6 to 2.1.7 (GH-29875)

Bumps [actions/cache](https://github.com/actions/cache) from 2.1.6 to 2.1.7.
- [Release notes](https://github.com/actions/cache/releases)
- [Commits](https://github.com/actions/cache/compare/v2.1.6...v2.1.7)

---
updated-dependencies:
- dependency-name: actions/cache
  dependency-type: direct:production
  update-type: version-update:semver-patch
...

Signed-off-by: dependabot[bot] <support@github.com>
Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>

bpo-37971: fix the position of decorator application (GH-30027)

The line numbers of actually calling the decorator functions of
functions and classes was wrong (as opposed to loading them, were they
have been correct previously too).

Co-authored-by: Łukasz Langa <lukasz@langa.pl>

bpo-42918: Improve build-in function compile() in mode 'single' (GH-29934)

Co-authored-by: Alex Waygood <Alex.Waygood@Gmail.com>

bpo-43795: Document stable_abi.txt format and contents (GH-29956)

Also mention that removals generally aren't allowed.

bpo-46014: Add ability to use typing.Union with singledispatch (GH-30017)

bpo-27062: add `__all__` to inspect module (GH-30003)

bpo-45635: refactor print_exception_recursive into smaller functions to standardize error handling (GH-30015)

Co-authored-by: Erlend Egeberg Aasland <erlend.aasland@innova.no>

bpo-42114: ctypes documentation: fix winmode parameter default value (GH-29976)

Signed-off-by: Louis Sautier <sautier.louis@gmail.com>

bpo-45654: No need to freeze types (GH-30028)

bpo-45582: Fix test_embed failure during a PGO build on Windows (GH-30014)

This defines VPATH differently in PGO instrumentation builds, to account for a different default output directory. It also adds sys._vpath on Windows to make the value available to sysconfig so that it can be used in tests.

bpo-46023: Fix makesetup handling of disabled rule (GH-30001)

bpo-45723: Normalise configure user communication (GH-30024)

bpo-46000: Improve NetBSD curses compatibility (GH-29947)

bpo-42182: stdtypes doc - update and fix links to several dunder methods  (GH-27384)

Move error test to the function that needs it.  Improve error message. (GH-30008)

bpo-43931: Export Python version as API data (GH-25577)

When Python is embedded in other applications, it is not easy to determine which version of Python is being used. This change exposes the Python version as part of the API data. Tools like Austin (https://github.com/P403n1x87/austin) can benefit from this data when targeting applications like uWSGI, as the Python version can then be inferred systematically by looking at the exported symbols rather than relying on unreliable pattern matching or other hacks (like remote code execution etc...).

Automerge-Triggered-By: GH:pablogsal

bpo-46016: GHA Doc job now also runs "make check" (GH-30009)

The GitHub Action documentation job now also runs "make check" to
check the documentation.

bpo-46008: Make runtime-global object/type lifecycle functions and state consistent. (gh-29998)

This change is strictly renames and moving code around.  It helps in the following ways:

* ensures type-related init functions focus strictly on one of the three aspects (state, objects, types)
* passes in PyInterpreterState * to all those functions, simplifying work on moving types/objects/state to the interpreter
* consistent naming conventions help make what's going on more clear
* keeping API related to a type in the corresponding header file makes it more obvious where to look for it

https://bugs.python.org/issue46008

Remove an outdated comment. (GH-30010)

bpo-46018: Ensure that math.expm1 does not raise on underflow (GH-29997)

bpo-45654: Freeze the runpy module and stuff it imports (GH-29903)

bpo-45635: continue refactor of print_exception() to standardize error handling (GH-29996)

Co-authored-by: Erlend Egeberg Aasland <erlend.aasland@innova.no>

bpo-46016: Fix rest syntax of GH-29993 (GH-30006)

bpo-46025: Fix a crash in the atexit module for auto-unregistering functions (GH-30002)

bpo-25066: Added repr for multiprocessing.Event (GH-29749)

Co-authored-by: Pablo Galindo Salgado <Pablogsal@gmail.com>

bpo-45391: mark UnionType as a class in documentation (GH-28757)

Signed-off-by: Bernát Gábor <bgabor8@bloomberg.net>

bpo-46007: Exclude PyUnicode_CHECK_INTERNED() from limited C API (GH-29987)

Exclude the PyUnicode_CHECK_INTERNED() macro from the limited C API,
because it uses the PyASCIIObject structure which is excluded from
the limited C API.

Automerge-Triggered-By: GH:encukou

bpo-45510: Check both types when specializing subtraction (GH-29995)

Merge remote-tracking branch 'upstream/main'

Post 3.11.0a3

bpo-46016: fcntl module add FreeBSD's F_DUP2FD_CLOEXEC flag support (GH-29993)

Python 3.11.0a3

Fix some false positives of documentation syntax problems

bpo-45711: Remove unnecessary normalization of exc_info (GH-29922)

bpo-46015: Fixes calculation of sys.path in a venv on Windows (GH-29992)

Also ensures that pybuilddir.txt is written early enough in the build to be picked up by later steps.

bpo-45359: Support TopologicalSorter type subscript (GH-28714)

* Support TopologicalSorter type subscript

* 📜🤖 Added by blurb_it.

* Add TopologicalSorter to GenericAlias tests

* Update Misc/NEWS.d/next/Library/2021-10-03-22-27-35.bpo-45359.LX_uxe.rst

Co-authored-by: blurb-it[bot] <43283697+blurb-it[bot]@users.noreply.github.com>
Co-authored-by: Batuhan Taskaya <isidentical@gmail.com>

bpo-45635: refactor print_exception() into smaller functions (GH-29981)

Co-authored-by: Erlend Egeberg Aasland <erlend.aasland@innova.no>

bpo-45813: Drop redundant assertion from frame.clear() (GH-29990)

* bpo-45813: Drop redundant assertion from frame.clear()

* Move assertion to frame_dealloc()

bpo-46009: Do not exhaust generator when send() method raises (GH-29986)

doc: Add link issue 44010 (GH-29454)

bpo-45847: Don't override user overrides for CFLAGS/LIBS (GH-29967)

Fix double-space in exception message (GH-29955)

bpo-40222: update doc entry with respect to the change in WITH_EXCEPT_START (GH-29975)

bpo-20751: Match variable name to the example. (GH-29980)

bpo-45582: Write empty pybuilddir.txt on Windows to allow relocatable build directories (GH-29979)

bpo-46008: Move Py*State init into distinct functions. (gh-29977)

Previously, basic initialization of PyInterprterState happened in PyInterpreterState_New() (along with allocation and adding the new interpreter to the runtime state). This prevented us from initializing interpreter states that were allocated separately (e.g. statically or in a free list). We've addressed that here by factoring out a separate function just for initialization. We've done the same for PyThreadState. _PyRuntimeState was sorted out when we added it since _PyRuntime is statically allocated. However, here we update the existing init code to line up with the functions for PyInterpreterState and PyThreadState.

https://bugs.python.org/issue46008

bpo-46008: Add _PyInterpreterState_Main(). (gh-29978)

PyInterpreterState_Main() is a plain function exposed in the public C-API. For internal usage we can take the more efficient approach in this PR.

https://bugs.python.org/issue46008

bpo-46008: Stop calling _PyThreadState_Init() in new_threadstate(). (gh-29973)

This simplifies new_threadstate().  We also rename _PyThreadState_Init() to _PyThreadState_SetCurrent() to reflect what it actually does.

https://bugs.python.org/issue46008

bpo-46008: Use PyMem_RawCalloc() to allocate PyThreadState. (GH-29972)

Doing so allows us to stop assigning various fields to `NULL` and 0.  It also more closely matches the behavior of a static initializer.

Automerge-Triggered-By: GH:ericsnowcurrently

bpo-46008: Move thread-related interpreter state into a sub-struct. (gh-29971)

This parallels _PyRuntimeState.interpreters.  Doing this helps make it more clear what part of PyInterpreterState relates to its threads.

https://bugs.python.org/issue46008

bpo-46008: Return void from _PyEval_InitState(). (gh-29970)

This falls into the category of keep-allocation-and-initialization separate. It also allows us to use _PyEval_InitState() safely in functions that return void.

https://bugs.python.org/issue46008

bpo-45847: Revert Port _ctypes partly to PY_STDLIB_MOD (GH-29747) (GH-29969)

bpo-45582: Fix framework path and bootstrap build (GH-29954)

* Check NS API return values for NULL to prevent segfault in
  ``_bootstrap_python``.
* Set modPathInitialized to 1 so the ``decode_to_dict`` path is used.

Signed-off-by: Christian Heimes <christian@python.org>

Fix leak when an exception is raised during generator creation. (GH-29960)

bpo-45635: standardize error handling in traceback.c (GH-29905)

Co-authored-by: Erlend Egeberg Aasland <erlend.aasland@innova.no>

bpo-45947: Place dict and values pointer at fixed (negative) offset just before GC header. (GH-29879)

* Place __dict__ immediately before GC header for plain Python objects.

* Fix up lazy dict creation logic to use managed dict pointers.

* Manage values pointer, placing them directly before managed dict pointers.

* Convert hint-based load/store attr specialization target managed dict classes.

* Specialize LOAD_METHOD for managed dict objects.

* Remove unsafe _PyObject_GC_Calloc function.

* Remove unsafe _PyObject_GC_Malloc() function.

* Add comment explaning use of Py_TPFLAGS_MANAGED_DICT.

bpo-35821: Fix restructuredtext code formatting in logging.rst (GH-29963)

bpo-46004: Fix error location for loops with invalid targets (GH-29959)

Revert "bpo-28533: Remove asyncore, asynchat, smtpd modules (GH-29521)" (GH-29951)

This reverts commit 9bf2cbc4c498812e14f20d86acb61c53928a5a57.

bpo-35821: Add an example to Logger.propagate documentation. (GH-29841)

bpo-45890: Add tests for tracing try-except-finally blocks (GH-29746)

bpo-46001: Change OverflowError to RecursionError in JSON library docstrings (GH-29943)

bpo-45798: Let libmpdec decide which archs to build on macOS as done previously. (GH-29949)

bpo-28953: Use `raise from` when raising new IncompleteRead (GH-29861)

Automerge-Triggered-By: GH:asvetlov

bpo-45582: Ensure PYTHONHOME still overrides detected build prefixes (GH-29948)

bpo-23819: asyncio: Replace AssertionError with TypeError where it makes sense (GH-29894)

removal of duplicated text paragraph (#29666)

bpo-45847: Fix uuid detection on macOS (GH-29946)

bpo-45582: framework build: modPath must not be const (GH-29944)

Co-authored-by: Ronald Oussoren <ronaldoussoren@mac.com>

bpo-45582: Fix getpath_isxfile() and test_embed on Windows (GH-29930)

bpo-45950: Fix macOS framework builds of _bootstrap_python (GH-29936)

bpo-44035: Check autoconf files thoroughly (GH-29935)

Check that users don't push changes with outdated or patched autoconf.
The presence of runstatedir option and aclocal 1.16.3 are good markers.

Use my container image to regenerate autoconf files. "Check for changes"
will fail later when any file is regenerated.

Use ccache in check_generated_files to speed up testing.

bpo-45963: Make space for the InterpreterFrame of a generator in that generator. (GH-29891)

* Make generator, coroutine and async gen structs all the same size.

* Store interpreter frame in generator (and coroutine). Reduces the number of allocations neeeded for a generator from two to one.

bpo-45732: Update python.org macOS installer to use Tcl/Tk 8.6.12. (GH-29931)

bpo-45840: Improve cross-references in the data model documentation (GH-29633)

bpo-45664: Fix resolve_bases() and new_class() for GenericAlias instance as a base (GH-29298)

bpo-45663: Fix is_dataclass() for dataclasses which are subclasses of types.GenericAlias (GH-29294)

bpo-45662: Fix the repr of InitVar with a type alias to the built-in class (GH-29291)

For example, InitVar[list[int]].

bpo-37295: Optimize math.comb() and math.perm() (GH-29090)

For very large numbers use divide-and-conquer algorithm for getting
benefit of Karatsuba multiplication of large numbers.

Do calculations completely in C unsigned long long instead of Python
integers if possible.

bpo-45582: Fix signature of _Py_Get_Getpath_CodeObject (GH-29921)

Delete orphaned comment (#29917)

(The function this described was deleted by PR #23743, the comment was accidentally retained.)

bpo-27946: Fix possible crash in ElementTree.Element (GH-29915)

Getting an attribute via attrib.get() simultaneously with replacing
the attrib dict can lead to access to deallocated dict.

bpo-13236: Flush the output stream more often in unittest (GH-29864)

It can prevent some losses when output to buffered stream.

Fixed documentation typo in compileall.py (GH-29912)

bpo-45847: Update whatsnew and add place holder entries for missing extensions (GH-29914)

bpo-45847: Port _ctypes partly to PY_STDLIB_MOD (GH-29747)

Co-authored-by: Erlend Egeberg Aasland <erlend.aasland@innova.no>

bpo-45695: Test out-of-tree builds on GHA (GH-29904)

bpo-20751:  Replace method example with attribute example, matching the descriptor howto (GH-29909)

bpo-45582 Fix prototype of _Py_Get_Getpath_CodeObject. (GH-29907)

Automerge-Triggered-By: GH:tiran

bpo-45582: Add a NOT operator to the condition in getpath_isxfile (GH-29906)

bpo-45607: Make it possible to enrich exception displays via setting their __note__ field (GH-29880)

bpo-45816: Support building with VS 2022 (v143 toolset) on Windows (GH-29577)

bpo-45711: [asyncio] Normalize exceptions immediately after Fetch, before they are stored as StackItem, which should be normalized (GH-29890)

bpo-45950: Introduce Bootstrap Python again (#29859)

The build system now uses a :program:`_bootstrap_python` interpreter for
freezing and deepfreezing again. To speed up build process the build tools
:program:`_bootstrap_python` and :program:`_freeze_module` are no longer
build with LTO.

Cross building depends on a build Python interpreter, which must have same
version and bytecode as target host Python.

bpo-45582: Fix out-of-tree build issues with new getpath (GH-29902)

bpo-45885: Specialize COMPARE_OP (GH-29734)

* Add COMPARE_OP_ADAPTIVE adaptive instruction.

* Add COMPARE_OP_FLOAT_JUMP, COMPARE_OP_INT_JUMP and COMPARE_OP_STR_JUMP specialized instructions.

* Introduce and use _PyUnicode_Equal

bpo-45582: Port getpath[p].c to Python (GH-29041)

The getpath.py file is frozen at build time and executed as code over a namespace. It is never imported, nor is it meant to be importable or reusable. However, it should be easier to read, modify, and patch than the previous code.

This commit attempts to preserve every previously tested quirk, but these may be changed in the future to better align platforms.

bpo-45916: Use HTTPS link for The Perils of Floating Point (GH-29896)