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)

bpo-40280: Update what's new (GH-29893)

bpo-45535: Improve output of Enum ``dir()`` (GH-29316)

Modify the ``EnumType.__dir__()`` and ``Enum.__dir__()`` to ensure
that user-defined methods and methods inherited from mixin classes always
show up in the output of `help()`. This change also makes it easier for
IDEs to provide auto-completion.

bpo-40280: Optimize ints and and startup on wasm (GH-29887)

bpo-45954: Rename PyConfig.no_debug_ranges to code_debug_ranges (GH-29886)

Rename PyConfig.no_debug_ranges to PyConfig.code_debug_ranges and
invert the value.

Document -X no_debug_ranges and PYTHONNODEBUGRANGES env var in
PyConfig.code_debug_ranges documentation.

bpo-40280: Emscripten has no support for subprocesses (GH-29872)

Fixes ``platform`` and ``help()`` on emscripten.

Signed-off-by: Christian Heimes <christian@python.org>
Automerge-Triggered-By: GH:tiran

docs: Improve example for urlparse() (GH-29816)

bpo-40280: Emscripten with_ensurepip=no, second attempt (GH-29884)

bpo-40280: Emscripten defaults to --with-ensurepip=no (GH-29873)

bpo-30533: Add docs for `inspect.getmembers_static` (#29874)

* Add docs for `inspect.getmembers_static`

* update

bpo-45952: Get the C analyzer tool working again. (gh-29882)

There wasn't much that needed to be done. Mostly it was just a few new files that got added.

https://bugs.python.org/issue45952

bpo-45896: Fix docs default asyncio event loop on Windows (GH-29857)

bpo-45753: Interpreter internal tweaks (GH-29575)

* Split exit paths into exceptional and non-exceptional.

* Move exit tracing code to individual bytecodes.

* Wrap all trace entry and exit events in macros to make them clearer and easier to enhance.

* Move return sequence into RETURN_VALUE, YIELD_VALUE and YIELD_FROM. Distinguish between normal trace events and dtrace events.

bpo-45876:  Have stdev() also use decimal specific square root. (GH-29869)

bpo-45876:  Correctly rounded stdev() and pstdev() for the Decimal case (GH-29828)

bpo-45711: Change exc_info related APIs to derive type and traceback from the exception instance (GH-29780)

bpo-30533:Add function inspect.getmembers_static that does not call properties or dynamic properties. (#20911)

* Add function inspect.getmembers_static that does not call properties or dynamic
properties.

* update _getmembers args

* Update Misc/NEWS.d/next/Library/2020-06-16-18-00-56.bpo-30533.StL57t.rst

Co-authored-by: Itamar Ostricher <itamarost@gmail.com>
* Update Lib/inspect.py

Co-authored-by: Itamar Ostricher <itamarost@gmail.com>
* Removes the copy pasted doc string

Co-authored-by: Itamar Ostricher <itamarost@gmail.com>
Co-authored-by: Dino Viehland <dinoviehland@gmail.com>

bpo-45476: Disallow using asdl_seq_GET() as l-value (GH-29866)

The following internal macros can not longer be used as l-value:

* asdl_seq_GET()
* asdl_seq_GET_UNTYPED()
* asdl_seq_LEN()

They are modified to use the _Py_RVALUE() macro.

bpo-45476: Add _Py_RVALUE() macro (GH-29860)

Add a new _Py_RVALUE() macro to prevent using an expression as an
l-value.

Replace a "(void)" cast with the _Py_RVALUE() macro in the following
macros:

* PyCell_SET()
* PyList_SET_ITEM()
* PyTuple_SET_ITEM()
* _PyGCHead_SET_FINALIZED()
* _PyGCHead_SET_NEXT()
* asdl_seq_SET()
* asdl_seq_SET_UNTYPED()

Add also parentheses around macro arguments in PyCell_SET() and
PyTuple_SET_ITEM() macros.

bpo-33381: [doc] strftime's %f option may pad zeros on the left or the right (GH-29801)

Fix EncodingWarning in Tools/freeze/test/freeze.py (GH-29742)

no-issue: remove unused import from test_graphlib.py (GH-29853)

bpo-45931: Prevent Directory.Build.props/targets from leaking from directories above the repo when building on Windows (GH-29854)

bpo-45653: fix test_embed on windows (GH-29814)

bpo-45917: Add math.exp2() method - return 2 raised to the power of x (GH-29829)

Co-authored-by: Mark Dickinson <dickinsm@gmail.com>

bpo-43905: Expand dataclasses.astuple() and asdict() docs (GH-26154)

Expanded ``astuple()`` docs, warning about deepcopy being applied
and providing a workaround.

Automerge-Triggered-By: GH:ericvsmith

bpo-44391: Remove unused argument from a varargs call. (GH-29843)

bpo-45881: configure --with-freeze-module --with-build-python (GH-29835)

Co-authored-by: Erlend Egeberg Aasland <erlend.aasland@innova.no>
Co-authored-by: Ethan Smith <ethan@ethanhs.me>

bpo-45847: PY_STDLIB_MOD_SIMPLE now checks py_stdlib_not_available (GH-29844)

bpo-45828: Use unraisable exceptions within sqlite3 callbacks (FH-29591)

bpo-40280: Emscripten systems use .wasm suffix by default (GH-29842)

bpo-45723: Sort the grand AC_CHECK_HEADERS check (GH-29846)

Automerge-Triggered-By: GH:tiran

bpo-45847: Make socket module conditional (GH-29769)

[Doc] Add info to logging cookbook about running logging socket listeners i… (GH-29838)

bpo-45786: Allocate space for frame in frame object. (GH-29729)

bpo-43498: Fix dictionary iteration error in _ExecutorManagerThread (GH-24868)

bpo-40280: Disable unusable core extension modules on emscripten (GH-29834)

Co-authored-by: Christian Heimes <christian@python.org>

bpo-45847: Fix _multiprocessing on platforms without sem_open (GH-29833)

Remove misleading comment in the AST optimizer (#29825)

bpo-37658: Actually return result in race condition (GH-29202)

bpo-45915: use fcntl(fd, F_GETFD) in is_valid_fd() (GH-29821)

bpo-45847: Port _multiprocessing to PY_STDLIB_MOD (GH-29768)

bpo-19460: Add test for MIMENonMultipart (GH-29817)

bpo-45614: Fix traceback display for exceptions with invalid module name (GH-29726)

bpo-42268: Fail the configure step if the selected compiler doesn't support memory sanitizer (GH-29806)

bpo-45876: Improve accuracy for stdev() and pstdev() in statistics (GH-29736)

* Inlined code from variance functions

* Added helper functions for the float square root of a fraction

* Call helper functions

* Add blurb

* Fix over-specified test

* Add a test for the _sqrt_frac() helper function

* Increase the tested range

* Add type hints to the internal function.

* Fix test for correct rounding

* Simplify ⌊√(n/m)⌋ calculation

Co-authored-by: Mark Dickinson <dickinsm@gmail.com>
* Add comment and beef-up tests

* Test for zero denominator

* Add algorithmic references

* Add test for the _isqrt_frac_rto() helper function.

* Compute the 109 instead of hard-wiring it

* Stronger test for _isqrt_frac_rto()

* Bigger range

* Bigger range

* Replace float() call with int/int division to be parallel with the other code path.

* Factor out division. Update proof link. Remove internal type declaration

Co-authored-by: Mark Dickinson <dickinsm@gmail.com>

bpo-44530: Reverts a change to the 'code.__new__' audit event (GH-29809)

bpo-41735: Fix thread lock in zlib.Decompress.flush() may go wrong (GH-29587)

* Fix thread lock in zlib.Decompress.flush() may go wrong

Getting `.unconsumed_tail` before acquiring the thread lock may mix up decompress state.

bpo-45901: Fixes argument passing when invoking .py files directly through the Store package (GH-29799)

Fix markup buglet in Doc/howto/annotations.rst (#29802)

bpo-45866: Fix typo in the NEWS entry (GH-29798)

bpo-40280: Move hard-coded feature checks to configure (GH-29789)

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

bpo-45019: Cleanup module freezing and deepfreeze (#29772)

bpo-45886: Fix OOT build when srcdir has frozen module headers (GH-29793)

The presence of frozen module headers in srcdir interfers with OOT
build. Make considers headers in srcdir up to date, but later builds do
not use VPATH to locate files. make clean now removes the headers, too.

Also remove stale ``_bootstrap_python`` from .gitignore.

bpo-40280: Add configure check for socket shutdown (GH-29795)

bpo-45760: Remove PyNumber_InMatrixMultiply (GH-29751)

bpo-40280: clean and ignore .wasm files (GH-29794)

bpo-45866: pegen strips directory of "generated from" header (GH-29777)

"make regen-all" now produces the same output when run from a
directory other than the source tree: when building Python out of the
source tree.

bpo-40280: Use Setup.stdlib static for wasm builds (GH-29784)

``Modules/Setup.stdlib`` contains ``Setup`` lines for all stdlib extension modules for which ``configure`` has detected their dependencies. The file is not used yet and still under development. To use the file, do ``ln -sfr Modules/Setup.stdlib Modules/Setup.local``.

bpo-45619: documentation of execution model: clarify and update binding summary (#29232)

This does two changes that are quite related.

0. it add that variable binding can occur in pattern matching, an update of 3.10
which seems to have been omitted from the list of bindings
1. Given how long the sentence already was, with even subcases in the middle of
the sentence, the commit breaks the sentence into an actual list.

bpo-44353: Correct docstring for `NewType` (#29785)

The docstring for `typing.NewType` is no longer strictly accurate, now that `NewType` is a class, rather than a function

bpo-43137: webbrowser: Replace gvfs-open and gnome-open with "gio open" (GH-29154)

* [bpo-43137](): webbrowser: Prefer gio open over gvfs-open

    gvfs-open(1) was superseded by gio(1) in 2015, and removed from GNOME
    releases in 2018. Debian and its derivatives like Ubuntu currently still
    have a compatibility shim for gvfs-open, but we plan to remove it.

    webbrowser prefers xdg-settings and xdg-open over gvfs-open, so this
    will only have any practical effect on systems where the xdg-utils
    package is not installed.

    Note that we don't check for GNOME_DESKTOP_SESSION_ID before using gio.
    gio does the right thing on any desktop environment that follows
    freedesktop.org specifications, similar to xdg-settings, so it's
    unnecessary to guard in this way. GNOME_DESKTOP_SESSION_ID was deprecated
    in 2008 and removed from upstream gnome-session in 2018 (it's still
    present in Debian/Ubuntu for backward compatibility, but probably
    shouldn't be). The replacement way to detect a desktop environment is
    the XDG_CURRENT_DESKTOP environment variable, which is a colon-separated
    sequence where the first item is the current desktop environment and the
    second and subsequent items (if present) are other desktop environments
    that it resembles or is based on.

    Resolves:

* [bpo-43137](): webbrowser: Never invoke gnome-open

    gnome-open was part of GNOME 2, which was superseded in around 2010 and
    is unmaintained. The replacement was gvfs-open, which was subsequently
    replaced by gio(1) (as used in the previous commit).

* [bpo-43137](): webbrowser: Don't run gvfs-open on GNOME

    gvfs-open was deprecated in 2015 and removed in 2018. The replacement
    is gio(1) (as used in a previous commit).

    GNOME_DESKTOP_SESSION_ID was deprecated in 2008 and removed in 2018.
    The replacement is XDG_CURRENT_DESKTOP (as mentioned in a previous
    commit).

---

To test this on a typical modern Linux system, it is necessary to disable the `xdg-settings` and `xdg-open` code paths, for example with this hack:

<details><summary>Hack to disable use of xdg-settings and xdg-open</summary>

```diff
diff --git a/Lib/webbrowser.py b/Lib/webbrowser.py
index 3244f206aa..8f6c09d1d2 100755
--- a/Lib/webbrowser.py
+++ b/Lib/webbrowser.py
@@ -459,7 +459,7 @@ def open(self, url, new=0, autoraise=True):
 def register_X_browsers():

     # use xdg-open if around
-    if shutil.which("xdg-open"):
+    if 0 and shutil.which("xdg-open"):
         register("xdg-open", None, BackgroundBrowser("xdg-open"))

     # Opens an appropriate browser for the URL scheme according to
@@ -549,7 +549,7 @@ def register_standard_browsers():
         # Prefer X browsers if present
         if os.environ.get("DISPLAY") or os.environ.get("WAYLAND_DISPLAY"):
             try:
-                cmd = "xdg-settings get default-web-browser".split()
+                cmd = "false xdg-settings get default-web-browser".split()
                 raw_result = subprocess.check_output(cmd, stderr=subprocess.DEVNULL)
                 result = raw_result.decode().strip()
             except (FileNotFoundError, subprocess.CalledProcessError, PermissionError, NotADirectoryError) :
```

</details>

I haven't attempted to assess which of the specific web browsers such as Galeon are still extant, and which ones disappeared years ago. They could almost certainly be cleaned up, but that's beyond the scope of this PR.

bpo-40280: Add wasm cross build targets (GH-29771)

bpo-33393: Update config.guess and config.sub (GH-29781)

Add missing 'await writer.drain()' call to example (GH-29162)

Automerge-Triggered-By: GH:asvetlov

bpo-45568: Actually use @asynccontextmanager in usage example (GH-29151)

Automerge-Triggered-By: GH:asvetlov

bpo-41498: Fix build on platforms without sigset_t (GH-29770)

bpo-45711: use exc_value instead of exc_type to determine if exc_info is valid. Add more assertions. (GH-29627)

bpo-45727: Only trigger the 'did you forgot a comma' error suggestion if inside parentheses (GH-29757)

bpo-45893: Add missing extern C to initconfig.h (GH-29761)

Co-authored-by: Steve Dower <steve.dower@python.org>

bpo-45693: Document `port` parameter to `loop.create_server` (GH-29760)

Document the `port` parameter to `loop.create_server` in `asyncio`. In
particular, note that if `host` resolves to multiple network interfaces,
passing in `port=0` will result in a different random unused port being
used for each interface.

Automerge-Triggered-By: GH:ericvsmith

Fix typo in freeze_modules (#29744)

bpo-45020: Fix strict-prototypes warning (GH-29755)

bpo-45822: Minor cleanups to the test_Py_CompileString test (GH-29750)

bpo-45881: Use CC from env first for cross building (GH-29752)

bpo-45847: Fix _crypt detection on Ubuntu (GH-29743)

bpo-45847: Port _uuid to PY_STDLIB_MOD (GH-29741)

bpo-45514: Deprecate importlib resources legacy functions. (GH-29036)

* bpo-45514: Apply changes from importlib_resources@a3ef4128c6

* Mark legacy functions as deprecated in the docs and link to the migration docs in importlib_resources docs.

* Apply changes from importlib_resources@329ae9d5f2c.

* Indicate importlib.resources as a module.

Co-authored-by: Filipe Laíns <lains@riseup.net>

bpo-45847: Port _posixshmem to PY_STDLIB_MOD (GH-29738)

bpo-45886: Allow overriding freeze command for cross compiling (GH-29735)

bpo-45616: Let py.exe distinguish between v3.1 and v3.10 (GH-29731)

bpo-45847: Port _gdbm to PY_STDLIB_MOD (GH-29720)

bpo-45847: Port _ssl and _hashlib to PY_STDLIB_MOD (GH-29727)

bpo-45847: Port _crypt to PY_STDLIB_MOD (GH-29725)

bpo-45873: Restore Python 3.6 compatibility (GH-29730)

Co-authored-by: Guido van Rossum <gvanrossum@gmail.com>

bpo-39026: Fix Python.h when building with Xcode (GH-29488)

Fix Python.h to build C extensions with Xcode: remove a relative
include from Include/cpython/pystate.h.

bpo-45873: Get rid of bootstrap_python (#29717)

Instead we use $(PYTHON_FOR_REGEN) .../deepfreeze.py with the
frozen .h file as input, as we did for Windows in bpo-45850.

We also get rid of the code that generates the .h files
when make regen-frozen is run (i.e., .../make_frozen.py),
and the MANIFEST file.

Restore Python 3.8 and 3.9 as Windows host Python again

Co-authored-by: Kumar Aditya <59607654+kumaraditya303@users.noreply.github.com>

bpo-45703: Invalidate _NamespacePath cache on importlib.invalidate_ca… (GH-29384)

Consider the following directory structure:

    .
    └── PATH1
        └── namespace
            └── sub1
                └── __init__.py

And both PATH1 and PATH2 in sys path:

    $ PYTHONPATH=PATH1:PATH2 python3.11
    >>> import namespace
    >>> import namespace.sub1
    >>> namespace.__path__
    _NamespacePath(['.../PATH1/namespace'])
    >>> ...

While this interpreter still runs, PATH2/namespace/sub2 is created:

    .
    ├── PATH1
    │   └── namespace
    │       └── sub1
    │           └── __init__.py
    └── PATH2
        └── namespace
            └── sub2
                └── __init__.py

The newly created module cannot be imported:

    >>> ...
    >>> namespace.__path__
    _NamespacePath(['.../PATH1/namespace'])
    >>> import namespace.sub2
    Traceback (most recent call last):
      File "<stdin>", line 1, in <module>
    ModuleNotFoundError: No module named 'namespace.sub2'

Calling importlib.invalidate_caches() now newly allows to import it:

    >>> import importlib
    >>> importlib.invalidate_caches()
    >>> namespace.__path__
    _NamespacePath(['.../PATH1/namespace'])
    >>> import namespace.sub2
    >>> namespace.__path__
    _NamespacePath(['.../PATH1/namespace', '.../PATH2/namespace'])

This was not previously possible.

bpo-45783: Preserve file moves and deletions in the tests for the freeze tool. (GH-29527)

Use shutil.copytree rather than Git, which might be missing (or configured
differently) when testing Python built from a source release.