bpo-45099: Document asyncio internal API (GH-32166)

bpo-47151: Fallback to fork when vfork fails in subprocess. (GH-32186)

bpo-47151: Fallback to fork when vfork fails in subprocess. An OS kernel can specifically decide to disallow vfork() in a process. No need for that to prevent us from launching subprocesses.

bpo-47146: Stop Depending On regen-deepfreeze For regen-global-objects (gh-32218)

This effectively reverts the Makefile change in gh-31637. I've added some notes so it is more clear what is going on.

We also update the "Check if generated files are up to date" job to run "make regen-deepfreeze" to ensure "make regen-global-objects" catches deepfreeze.c.

https://bugs.python.org/issue47146

bpo-40421: Add missing getters for frame object attributes to C-API. (GH-32114)

bpo-47182: Fix crash by named unicode characters after interpreter reinitialization (GH-32212)

Automerge-Triggered-By: GH:tiran

Remove unnecessary registration of weakref.WeakSet to _collections_abc.Set (GH-32211)

bpo-14911: Corrected generator.throw() documentation (GH-32207)

Co-authored-by: Andrew Svetlov <andrew.svetlov@gmail.com>

bpo-47120: Replace the JUMP_ABSOLUTE opcode by the relative JUMP_BACKWARD (GH-32115)

bpo-45847: Port _tkinter to PY_STDLIB_MOD (GH-31698)

- Remove ``--with-tclk-*`` options from `configure`
- Use pkg-config to detect `_tkinter` dependencies (Tcl/Tk, X11)
- Manual override via environment variables `TCLTK_CFLAGS` and `TCLTK_LIBS`

bpo-47164: Add _PyCFunctionObject_CAST() macr (GH-32190)

Add _PyCFunctionObject_CAST() and _PyCMethodObject_CAST() macros to
make macros casting their argument easier to read, but also to check
the type of their input in debug mode: assert(PyCFunction_Check(func)
and assert(PyCMethod_Check(func).

Reformat also PyCFunction_XXX() macros for readability.

bpo-47164: Add _PyCFunction_CAST() macro (GH-32192)

Use the macro in C files of the Python/ directory.

bpo-47164: Add _PyASCIIObject_CAST() macro (GH-32191)

Add macros to cast objects to PyASCIIObject*, PyCompactUnicodeObject*
and PyUnicodeObject*: _PyASCIIObject_CAST(),
_PyCompactUnicodeObject_CAST() and _PyUnicodeObject_CAST(). Using
these new macros make the code more readable and check their argument
with: assert(PyUnicode_Check(op)).

Remove redundant assert(PyUnicode_Check(op)) in macros using directly
or indirectly these new CAST macros.

Replacing existing casts with these macros.

bpo-47146: Avoid Using make Recursively (gh-32206)

https://bugs.python.org/issue47146

bpo-46566: Make test_launcher more robust to a variety of installs (GH-32204)

bpo-47171: Enable installing the py.exe launcher on Windows ARM64 (GH-32203)

bpo-47162: Add call trampoline to mitigate bad fpcasts on Emscripten (GH-32189)

Add CODEOWNERS entry for pathlib (GH-32202)

bpo-46775: OSError should call winerror_to_errno unconditionally on Windows (GH-32179)

Replace with_traceback() with exception chaining and reraising (GH-32074)

bpo-39622: Interrupt the main asyncio task on Ctrl+C (GH-32105)

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

Merge deoptimization blocks in interpreter (GH-32155)

bpo-34861: Make cumtime the default sorting key for cProfile (GH-31929)

bpo-47126: Update to canonical PEP URLs specified by PEP 676 (GH-32124)

bpo-46864: Suppress even more ob_shash deprecation warnings (GH-32176)

bpo-26120: do not exclude __future__ import in pydoc of the __future__ module itself (GH-32180)

asyncio.Task: rename internal nested variable to don't hide another declaration from outer scope (GH-32181)

bpo-33178: Add BigEndianUnion, LittleEndianUnion classes to ctypes (GH-25480)

* bpo-33178: Add BigEndianUnion, LittleEndianUnion classes to ctypes
* GH-25480: remove trailing whitespace in ctypes doc
* GH-25480: add news entry blurb
* GH-25480: corrected formatting error in news blurb
* GH-25480: simplified, corrected formatting in news blurb
* GH-25480: remove trailing whitespace in news blurb
* GH-25480: fixed class markup in news blurb
* GH-25480: fixed unsupported type tests and naming per review comments
* GH-25480: fixed whitepace errors
* condensed base class selection for unsupported byte order tests
* added versionadded tags for new EndianUnion classes

Update glossary.rst (GH-32093)

bpo-42340: Document issues around KeyboardInterrupt (GH-23255)

Update documentation to note that in some circumstances,
KeyboardInterrupt may cause code to enter an inconsistent state. Also
document sample workaround to avoid KeyboardInterrupt, if needed.

bpo-14265: Adds fully qualified test name to unittest output (GH-32138)

Co-authored-by: Andrew Svetlov <andrew.svetlov@gmail.com>

bpo-35859: Fix a few long-standing bugs in re engine (GH-12427)

In rare cases, capturing group could get wrong result.

Regular expression engines in Perl and Java have similar bugs.
The new behavior now matches the behavior of more modern
RE engines: in the regex module and in PHP, Ruby and Node.js.

bpo-47053: Refactor BINARY_OP_INPLACE_ADD_UNICODE (GH-32122)

bpo-46566: Add new py.exe launcher implementation (GH-32062)

bpo-27929: resolve names only for AF_INET/AF_INET6 with asyncio (GH-32131)

Co-authored-by: Andrew Svetlov <andrew.svetlov@gmail.com>

bpo-47129: Add more informative messages to f-string syntax errors (32127)

* Add more informative messages to f-string syntax errors

* 📜🤖 Added by blurb_it.

* Fix whitespaces

* Change error message

* Remove the 'else' statement (as sugested in review)

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

bpo-26120: make pydoc exclude __future__ imports from the data block of the module (GH-30888)

bpo-47146: Eliminate a race between make regen-deepfreeze and make regen-global-objects. (gh-32162)

The race likely originated with gh-32061.

https://bugs.python.org/issue47146

bpo-47138: Ensure Windows docs build uses the same pinned version as other platforms (GH-32161)

Fix typo in the sqlite3 docs (GH-31915)

Co-authored-by: Jonathan <89750679+AHypnotoad@users.noreply.github.com>

bpo-47070: Add _PyBytes_Repeat() (GH-31999)

Use it where appropriate: the repeat functions of `array.array`, `bytes`, `bytearray`, and `str`.

bpo-28516: document contextlib.ExitStack.__enter__ behavior (GH-31636)

The enter_context is updated with following information: 'The :meth:`__enter__` method
      returns the ExitStack instance, and performs no additional operations.'

Co-authored-by: Jelle Zijlstra <jelle.zijlstra@gmail.com>

ctypes docs: Fix array-length reference to "non-negative" from "positive" (GH-32097)

bpo-44493: Add missing terminated NUL in sockaddr_un's length (GH-26866)

Add missing terminated NUL in sockaddr_un's length

- Linux: https://man7.org/linux/man-pages/man7/unix.7.html
- *BSD: SUN_LEN

bpo-47127: Specialize calls for fastcall c methods with keywords (GH-32125)

* add PRECALL_METHOD_DESCRIPTOR_FAST_WITH_KEYWORDS

bpo-46429: tweak deepfreeze output (#32107)

bpo-45171: Remove tests of deprecated logger.warn(). (GH-32139)

bpo-45171: Fix stacklevel handling in logging. (GH-28287)

bpo-47098: Replace Keccak Code Package with tiny_sha3 (GH-32060)

bpo-47095: Use libb2 to provide blake2 implementation (GH-32059)

bpo-47116: use _PyLong_FromUnsignedChar instead of PyLong_FromLong (GH-32110)

bpo-43224: Implement PEP 646 grammar changes (GH-31018)

Co-authored-by: Jelle Zijlstra <jelle.zijlstra@gmail.com>

bpo-47117: Don't crash if we fail to decode characters when the tokenizer buffers are uninitialized (GH-32129)

Automerge-Triggered-By: GH:pablogsal

bpo-47105: Cite grp.h instead of pwd.h in grp docs (GH-32091)

bpo-47062: Rename factory argument to loop_factory (GH-32113)

bpo-43352: Add a Barrier object in asyncio lib (GH-24903)

Co-authored-by: Yury Selivanov <yury@edgedb.com>
Co-authored-by: Andrew Svetlov <andrew.svetlov@gmail.com>

bpo-47118: Fix asyncio.Runner tests error (32117)

Fix some typos in whatsnew (GH-32098)

* Fix some typos and phrasing

* Convert the `hash()` text to a link

* Remove definite article

bpo-47053: Reduce deoptimization in BINARY_OP_INPLACE_ADD_UNICODE (GH-31318)

* Don't deopt if refcounts are too big

* Detect more at specialization time

bpo-42197: Don't create `f_locals` dictionary unless we actually need it. (GH-32055)

* `PyFrame_FastToLocalsWithError` and `PyFrame_LocalsToFast` are no longer called during profile and tracing.
 (Contributed by Fabio Zadrozny)

* Make accesses to a frame's `f_locals` safe from C code, not relying on calls to `PyFrame_FastToLocals` or `PyFrame_LocalsToFast`.

* Document new `PyFrame_GetLocals` C-API function.

Add an issue template config for the migration (GH-32101)

bpo-40280: Add wasm32-emscripten and wasm32-wasi SOABI (GH-32095)

Shared extension on Emscripten now have suffix
``.cpython-311-wasm32-emscripten.so`` (JS loader) and
``.cpython-311-wasm32-emscripten.wasm`` (WebAssembly code).

bpo-47062: Implement asyncio.Runner context manager (GH-31799)

Co-authored-by: Zachary Ware <zach@python.org>

bpo-46841: remove no-longer-used macro UPDATE_PREV_INSTR_OPARG (GH-32100)

bpo-40465: Document random module changes in 3.11 What's new (#31818)

bpo-46480: rephrase typing.assert_type docs (GH-32069)

The goal here is to reduce potential confusion between
`assert_type(val, type)` and `assert isinstance(val, typ)`.

The former is meant to ask a type checker to confirm a fact, the latter
is meant to tell a type checker a fact. The behaviour of the latter more
closely resembles what I'd expect from the prior phrasing of
"assert [something] to the type checker".

Fix GPG signing in Windows release build (GH-32089)

bpo-47104: Rewrite asyncio.to_thread tests to use IsolatedAsyncioTestCase (GH-32086)

bpo-47101: list only activated algorithms in hashlib.algorithms_available (GH-32076)

bpo-31582: Created a new documentation section describing sys.path initialization (GH-31082)

bpo-47086: Remove dead link to old CHM documentation (GH-32075)

bpo-46712: Do not Regen Deep-Frozen Modules before Generating Global Objects (gh-32061)

We have to run "make regen-deepfreeze" before running Tools/scripts/generate-global-objects.py; otherwise we will miss any changes to global objects in deep-frozen modules (which aren't committed in the repo).  However, building $(PYTHON_FOR_FREEZE) fails if one of its source files had a global object (e.g. via _Py_ID(...)) added or removed, without generate-global-objects.py running first.  So "make regen-global-objects" would sometimes fail.

We solve this by running generate-global-objects.py before *and* after "make regen-deepfreeze". To speed things up and cut down on noise, we also avoid updating the global objects files if there are no changes to them.

https://bugs.python.org/issue46712

bpo-46541: Add a Comment About When to Use _Py_DECLARE_STR(). (gh-32063)

In a gh-32003 comment, I realized it wasn't very clear how _Py_DECLARE_STR() should be used.  This changes adds a comment to clarify.

https://bugs.python.org/issue46541

bpo-46829: Deprecate passing a message into Future.cancel() and Task.cancel() (GH-31840)

After a long deliberation we ended up feeling that the message argument for Future.cancel(), added in 3.9, was a bad idea, so we're deprecating it in 3.11 and plan to remove it in 3.13.

Correctly document class instead of function (GH-32016)

bpo-46836: Add Doc/c-api/frame.rst (GH-32051)

Reorganize the documentation of the PyFrameObject C API.

[doc] configparser: avoid inline comments. (GH-31247)

People are testing those blocs with the default
inline_comment_prefixes of None, leading to a:

configparser.InterpolationSyntaxError: '$' must be followed by '$' or '{', found: '$ sign ($ is the only character that needs to be escaped)'

bpo-42238: [doc] Some lines moved in rst, but had hardcoded lineno in susp-ignored.csv. (GH-32070)

bpo-47012: speed up iteration of bytes and bytearray (GH-31867)

bpo-46864: Suppress deprecation warnings for ob_shash. (GH-32042)

Fix typo in Path.iterdir docs (GH-31822)

bpo-43166: Disable ceval.c optimizations for Windows debug builds (GH-32023)

Also increases the stack allocation when run with `python_d.exe` to account for the extra stack checks that are added.

bpo-2604: Make doctest.DocTestCase reset globs in teardown (GH-31932)

Co-authored-by: Piet Delport
Co-authored-by: Hugo Lopes Tavares
Co-authored-by: Jelle Zijlstra <jelle.zijlstra@gmail.com>

bpo-32033: Finalize WASI configure options (GH-32053)

bpo-46315: Use fopencookie() to avoid dup() in _PyTokenizer_FindEncodingFilename (GH-32033)

WASI does not have dup() and Emscripten's emulation is slow.

bpo-45150: Fix testing under FIPS mode (GH-32046)

bpo-42885: Optimize search for regular expressions starting with "\A" or "^" (GH-32021)

Affected functions are re.search(), re.split(), re.findall(), re.finditer()
and re.sub().

bpo-45997: Fix asyncio.Semaphore re-acquiring order (GH-31910)

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

bpo-47076: Make asyncio.Queue stable on slow test boxes (GH-32040)

bpo-47045: Remove `f_state` field (GH-31963)

* Remove the f_state field from _PyInterpreterFrame

*  Make ownership of the frame explicit, replacing the is_generator field with an owner field.

bpo-47084: Clear Unicode cached representations on finalization (GH-32032)

bpo-46838: Syntax error improvements for function definitions (GH-31590)

bpo-40280: Skip socket, fork, subprocess tests on Emscripten (GH-31986)

- Add requires_fork and requires_subprocess to more tests
- Skip extension import tests if dlopen is not available
- Don't assume that _testcapi is a shared extension
- Skip a lot of socket tests that don't work on Emscripten
- Skip mmap tests, mmap emulation is incomplete
- venv does not work yet
- Cannot get libc from executable

The "entire" test suite is now passing on Emscripten with EMSDK from git head (91 suites are skipped).

bpo-28080: Add support for the fallback encoding in ZIP files (GH-32007)

* Add the metadata_encoding parameter in the zipfile.ZipFile constructor.
* Add the --metadata-encoding option in the zipfile CLI.

Co-authored-by: Stephen J. Turnbull <stephen@xemacs.org>

bpo-47081: Replace "qualifiers" with "quantifiers" in the re module documentation (GH-32028)

It is a more commonly used term.

bpo-45150: Add hashlib.file_digest() for efficient file hashing (GH-31930)

bpo-47086: Remove .chm from Windows installer and add HTML docs (GH-32038)

bpo-44336: Prevent tests hanging on child process handles on Windows (GH-26578)

Replace the child process `typeperf.exe` with a daemon thread that reads the performance counters directly.  This prevents the issues that arise from inherited handles in grandchild processes (see issue37531 for discussion).

We only use the load tracker when running tests in multiprocess mode. This prevents inadvertent interactions with tests expecting a single threaded environment.  Displaying load is really only helpful for buildbots running in multiprocess mode anyway.

bpo-47061: document module deprecations due to PEP 594 (GH-31984)

Also removed asynchat, asyncore, and smtpd from their respective toctree entries so they are only  in the superceded subtree.

Fix typo in pycore_bytesobject.h (GH-31914)

bpo-12029: [doc] clarify that except does not match virtual subclasses of the specified exception type (GH-32027)