gh-135698: Fix Cross-interpreter Queue.full() With Negative/Default max_size (gh-135724)

We weren't handling non-positive maxsize values (including the default) properly
in Queue.full().  This change fixes that and adjusts an associated assert.

gh-135380: enhance critical section held assertions (#135381)

gh-135721: skip `test_trashcan_python_class` on wasm buildbots with stack overflow (#135766)

gh-131798: JIT: Optimize _CALL_LEN when the length is known (#135260)

* Add news entry

* Optimize _CALL_LEN

* Simplify tests

Docs: Document `PyExceptionClass` functions in the C API (GH-135697)

* Docs: Document `PyExceptionClass_Name`

`PyExceptionClass_Name` is an undocumented function in the limited API.

* Document `PyExceptionClass_Check`

gh-135748: use argument clinic for more socket methods (#135749)

gh-89083: add links to RFC 9562 sections in UUID docs (#135684)

We also sync the docs for UUIDv1 and UUIDv6 concerning the node address and clock sequence.

---------

Co-authored-by: Bénédikt Tran <10796600+picnixz@users.noreply.github.com>

gh-135532: use `_Py_strhex` in HACL-MD5's `hexdigest` (#135742)

gh-135532: update `Modules/_hacl/python_hacl_namespaces.h` (#135741)

gh-135379: fix MSVC warning: conversion from 'stwodigits' to 'digit' (GH-135714)

fix warning C4244: 'initializing': conversion from

'stwodigits' to 'digit', possible loss of data

gh-135532: simplify handling of HACL* errors in `_hmac` (#135740)

gh-135608: Add a null check for attribute promotion to fix a JIT crash (GH-135613)

Co-authored-by: devdanzin <74280297+devdanzin@users.noreply.github.com>

gh-127146: Add skip_emscripten_stack_overflow in a few places (#135722)

More tests that hit stack limits on some platforms.

gh-135543: Emit sys.remote_exec audit event when sys.remote_exec is called (GH-135544)

Add tomasr8 as a codeowner for AST, gettext and the Tier 2 optimizer (#135727)

gh-135561: ensure that the GIL is held when handling an HACL* error in `_hmac` (#135562)

gh-135709: Fix two compile warnings on WASM buildbot (#135712)

Docs: Add missing lines between regex and text (GH-134505)

gh-135273: Unify `ZoneInfo.from_file` signatures (#135274)

Align `ZoneInfo.from_file` pure-Python signature with Argument Clinic signature.

gh-135379: Move PyLong_CheckCompact to private header and rename it (GH-135707)

Docs: Emphasize parameter name in `pkgutil.iter_importers` (GH-135597)

gh-135379: Add back const cast to _PyLong_IsCompact (GH-135706)

gh-133934: Mention special commands in sqlite3 `.help` message (GH-135224)

gh-133439: Fix the error message in the sqlite3 CLI (GH-133807)

Co-authored-by: Bénédikt Tran <10796600+picnixz@users.noreply.github.com>
Co-authored-by: Serhiy Storchaka <storchaka@gmail.com>

GH-135379: Specialize int operations for compact ints only (GH-135668)

gh-126112: Fix test_os.TimerfdTests: use 10 ms resolution (#135681)

Use 10 ms for CLOCK_RES instead of 100 ms to tolerate slow buildbots.

gh-111758: Run UBSan in GitHub Actions (GH-135578)

Co-authored-by: Hugo van Kemenade <1324225+hugovk@users.noreply.github.com>

Document that PyType_GetModuleByDef returns a borrowed reference (GH-135666)

gh-133485: Use interpreters.Interpreter in InterpreterPoolExecutor (gh-133957)

Most importantly, this resolves the issues with functions and types defined in __main__.
It also expands the number of supported objects and simplifies the implementation.

gh-135450: Remove assertion in `_PyCode_CheckNoExternalState` (gh-135466)

The assertion reflected a misunderstanding of situations where "hidden" variables might exist,
namely generator expressions and comprehensions.

gh-134538: Add link to shutil.rmtree example in function docs (GH-135540)

gh-135641: Fix flaky `test_capi.test_lock_two_threads` test case (gh-135642)

The mutex may have the `_Py_HAS_PARKED` bit set.

Docs: Fix markups for emphasis (GH-135598)

The word emphasis character `_` is not supported as sphinx markup, so changed to `*`.

gh-135639: fix `test_cycle` test (#135662)

gh-135376: Fix and improve test_random (GH-135377)

* Remove duplicated code. Tests for Random and SystemRandom now share
  the code.
* Move implementation agnostic tests that was only run for SystemRandom,
  so they are now run for Random too.
* Add tests for __index__() support.
* Add tests for randint().

gh-135676: lexical analysis: Improve section on Numeric literals (GH-134850)

gh-135646: Raise consistent `NameError` exceptions in `ForwardRef.evaluate()` (#135663)

gh-135335: flush stdout/stderr in forkserver after preloading modules (#135338)

If a preloaded module writes to stdout or stderr, and the stream is buffered,
child processes will inherit the buffered data after forking. Attempt to
prevent this by flushing the streams after preload.

Co-authored-by: Mikhail Efimov <efimov.mikhail@gmail.com>
Co-authored-by: Victor Stinner <vstinner@python.org>

gh-133390: Document `SQLITE_KEYWORDS` (GH-135659)

gh-134632: Add iOS/Android test skip for C API check for headers. (#135656)

iOS and Android don't ship headers in the testbed, so we can't test for their existence.

gh-127146: Enable large files on Emscripten (#135635)

Large files have been fully supported by Emscripten for a long time.

gh-119180: Only fetch globals and locals if necessary in `annotationlib.get_annotations()` (#135644)

gh-127146: Emscripten: Fix pathlib glob_dotdot test (#135624)

The Emscripten path resolver uses the same mechanism for resolving `..`
at a file system root as for resolving symlinks. This is because
roots don't store their mountpoints. If the parent of a node is itself,
it is a root but it might be a mountpoint in some other file system.

If a path has enough `..`'s at the root, it will return ELOOP.
Enough turns out to be 49.

gh-127146: Emscripten: Fix test failure due to missing os.link (#135626)

Check for existence of os.link, rather than assuming it exists.

gh-127146: Emscripten: Skip test_url2pathname_resolve_host (#135634)

Emscripten currently `gethostbyname_r()` returns an incorrect
IP address for `localhost`. Will be resolved by upstream PR:
https://github.com/emscripten-core/emscripten/pull/24593

gh-127146: Allow ignored keys to be missing in test_sysconfig (#135622)

Fixes the test on Emscripten where userbase can be missing.

gh-135627: Remove documentation for LOAD_CONST_IMMORTAL opcode (GH-135632)

Remove documentation for LOAD_CONST_IMMORTAL opcode

gh-133931: Introduce _PyObject_XSetRefDelayed to replace Py_XSETREF (gh-134377)

Initial internal asyncio docs (#135469)

Currently focused on `_asynciomodule.c` but could also receive updates about internals of the Python package.

gh-132775: Fix Interpreter.call() __main__ Visibility (gh-135595)

As noted in the new tests, there are a few situations we must carefully accommodate
for functions that get pickled during interp.call().  We do so by running the script
from the main interpreter's __main__ module in a hidden module in the other
interpreter.  That hidden module is used as the function __globals__.

gh-134584: Decref elimination for float ops in the JIT (GH-134588)

This PR adds a PyJitRef API to the JIT's optimizer that mimics the _PyStackRef API. This allows it to track references and their stack lifetimes properly. Thus opening up the doorway to refcount elimination in the JIT.

GH-135379: Support limited scalar replacement for replicated uops in the JIT code generator. (GH-135563)

* Use it to support efficient specializations of COPY and SWAP in the JIT.

gh-132815: Add support for JUMP_BACKWARD in specialization stats (#135606)

gh-134262: Catch both URLError and ConnectionError in retries (#135365)

gh-134632: Fix `build-details.json` to use `INCLUDEPY` path (#134633)

* gh-134632: Fix `build-details.json` to use `INCLUDEPY` path

Fix ``build-details.json`` generation to use ``INCLUDEPY``, in order to
reference the ``pythonX.Y`` subdirectory of the include directory, as
required in :pep:`739`, instead of the top-level include directory.

* test_build_details: Add tests for the c_api section

* test_build_details: Expect pkgconfig for CPython unconditionally

gh-123299: Add PEP 779 to What's New in Python 3.14 (#135555)

gh-135489: Show verbose output for failing tests during PGO profiling step with `--enable-optimizations` (#135512)

gh-119132: Update 'Using Python on macOS' documentation. (#135591)

Remove `experimental` qualification for free-threading in the document text. Note that images included in the document will be updated later in the release cycle.

gh-135443: Sometimes Fall Back to __main__.__dict__ For Globals (gh-135491)

For several builtin functions, we now fall back to __main__.__dict__ for the globals
when there is no current frame and _PyInterpreterState_IsRunningMain() returns
true.  This allows those functions to be run with Interpreter.call().

The affected builtins:

* exec()
* eval()
* globals()
* locals()
* vars()
* dir()

We take a similar approach with "stateless" functions, which don't use any
global variables.

gh-128627: Emscripten: Add missing semicolon in ios detection code (#135590)

Add Peter Bierma as a codeowner for the object and runtime lifecycle (#135588)

Use replacements to update versions in "Using Python on macOS" (#130400)

gh-132617: Fix `dict.update()` mutation check (gh-134815)

Use `ma_used` instead of `ma_keys->dk_nentries` for modification check
so that we only check if the dictionary is modified, not if new keys are
added to a different dictionary that shared the same keys object.

gh-135513: Fix unused variable warning in `crossinterp.c` (#135514)

gh-119132: Remove "experimental" tag from the CPython free-threading. (gh-135550)

* gh-119132: Remove "experimental" tag from the CPython free-threading build

* Address code review

Co-authored-by: Hugo van Kemenade <1324225+hugovk@users.noreply.github.com>
* Add NEWS.d

* Regen configure.ac

* Update doc

* Update

* Update

* Update

* Update Doc/howto/free-threading-python.rst

Co-authored-by: Peter Bierma <zintensitydev@gmail.com>
* Update ctypes.rst

* Update

* Update Doc/howto/free-threading-python.rst

Co-authored-by: T. Wouters <thomas@python.org>
* Apply suggestions from code review

Co-authored-by: T. Wouters <thomas@python.org>
Co-authored-by: Hugo van Kemenade <1324225+hugovk@users.noreply.github.com>
---------

Co-authored-by: Hugo van Kemenade <1324225+hugovk@users.noreply.github.com>
Co-authored-by: Peter Bierma <zintensitydev@gmail.com>
Co-authored-by: T. Wouters <thomas@python.org>

gh-120608: fix NEWS entry typo (#135535)

gh-131798: JIT: replace _CHECK_METHOD_VERSION with _CHECK_FUNCTION_VERSION_INLINE (GH-135022)

Signed-off-by: Manjusaka <me@manjusaka.me>
Co-authored-by: Brandt Bucher <brandtbucher@gmail.com>

gh-67022: Document bytes/str inconsistency in email.header.decode_header() and suggest email.headerregistry.HeaderRegistry as a sane alternative (#92900)

* gh-67022: Document bytes/str inconsistency in email.header.decode_header()

This function's possible return types have been surprising and error-prone
for the entirety of its Python 3.x history. It can return either:

1. `typing.List[typing.Tuple[bytes, typing.Optional[str]]]` of length >1
2. or `typing.List[typing.Tuple[str, None]]`, of length exactly 1

This means that any user of this function must be prepared to accept either
`bytes` or `str` for the first member of the 2-tuples it returns, which is a
very surprising behavior in Python 3.x, particularly given that the second
member of the tuple is supposed to represent the charset/encoding of the
first member.

This patch documents the behavior of this function, and adds test cases
to demonstrate it.

As discussed in bpo-22833, this cannot be changed in a backwards-compatible
way, and some users of this function depend precisely on the existing
behavior.

Add warnings about obsolescence of 'email.header.decode_header' and 'email.header.make_header' functions.

Recommend use of `email.headerregistry.HeaderRegistry` instead, as suggested
in https://github.com/python/cpython/pull/92900#discussion_r1112472177

gh-111178: fix UBSan failures for `RemoteUnwinderObject` (#135539)

gh-135361: update documentation for `remote_debugger_script` audit event (#135362)

gh-135371: Clean tags from pointers in all cases in remote debugging module (#135534)

gh-65697: Improved error msg for configparser key validation (#135527)

* Improved error msg for configparser key validation and added note in 3.14 whatsnew

* Properly added change to configparser

* 📜🤖 Added by blurb_it.

---------

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

gh-127319: Disable port reuse on HTTP, XMLRPC, and logging TCP servers (GH-135405)

Prior to issue #120485 these servers did not allow port reuse, which
makes sense as the behavior of port reuse is surprising if you're not
expecting it. It's unclear to me why these services were switched to
allow port reuse, but I believe the desired behavior (unless subclasses
opt in) is to not allow port reuse.

See also: https://bugzilla.redhat.com/show_bug.cgi?id=2323170

gh-135171: Update documentation for the generator expression (GH-135351)

* gh-135171: Update documentation for the generator expression

Document that the iterator for the leftmost "for" clause is created
immediately.

* Update Doc/reference/expressions.rst

Co-authored-by: Brian Skinn <brian.skinn@gmail.com>
---------

Co-authored-by: Brian Skinn <brian.skinn@gmail.com>

gh-135497: fix `MAXLOGNAME` detection in `configure.ac` (#135508)

gh-135504: Document `LIBZSTD_CFLAGS` and `LIBZSTD_LIBS` config options (#135505)

gh-135371: Fix asyncio introspection output to include internal coroutine chains (#135436)

gh-135474: Specialize arithmetic only on compact ints (GH-135479)

Specialize arithmetic only on compact ints. This also makes int operations non-escaping in the JIT and in tier 1.

gh-135368: Fix mocks on dataclass specs with `instance=True` (#135421)

* gh-135368: Fix mocks on dataclass specs with `instance=True`

* Extend dataclass mock_methods

---------

Co-authored-by: Marc Mueller <30130371+cdce8p@users.noreply.github.com>

gh-135496: Fix f string exclamation mark error typo (#135495)

gh-135437: Account For Duplicate Names in _PyCode_SetUnboundVarCounts() (gh-135438)

gh-132775: Clean Up Cross-Interpreter Error Handling (gh-135369)

In this refactor we:

* move some code around
* make a couple of typedefs opaque
* decouple errors from session state
* improve tracebacks for propagated exceptions

This change helps simplify several upcoming changes.

gh-135462: Fix quadratic complexity in processing special input in HTMLParser (GH-135464)

End-of-file errors are now handled according to the HTML5 specs --
comments and declarations are automatically closed, tags are ignored.

gh-106318: Add example for `str.expandtabs()` (#134525)

gh-135455: Fix version and architecture detection in PC/layout script. (GH-135461)

gh-134160: Split extension module init from PyModule docs; emphasize multi-phase init (GH-135126)

Document behaviour of single-phase init. Call it "legacy".

Reorganize PyModule docs.

Move PyInit_modulename docs from the tutorial to reference documentation.

Move PyMODINIT_FUNC docs from generic macros to the new page.

Add doc stubs for `PYTHON_API_VERSION` & `PYTHON_ABI_VERSION`

Remove incorrect refcounts.dat entry for `PyModuleDef_Init`.
This removes the "Return value: Borrowed reference." note.
Instead, note that the function sometimes returns a borrowed reference,
sometimes as strong one.
(IMO, it's best to not think of `PyModuleDef` as a `PyObject` at all,
and act like it can't be reference-counted.)

Co-authored-by: Adam Turner <9087854+AA-Turner@users.noreply.github.com>
Co-authored-by: Stan Ulbrych <89152624+StanFromIreland@users.noreply.github.com>
Co-authored-by: Hugo van Kemenade <1324225+hugovk@users.noreply.github.com>

gh-135244: improve wording of `uuid8` docs about CSPRNG (#135433)

gh-126703: Add freelist for PyComplexObject's (gh-135233)

gh-106318: Add example for `str.endswith()` (#134523)

Co-authored-by: Hugo van Kemenade <1324225+hugovk@users.noreply.github.com>

gh-106318: Add example for `str.encode()` (#134520)

Co-authored-by: Hugo van Kemenade <1324225+hugovk@users.noreply.github.com>

gh-135308: clarify math.issubnormal() description (GH-135324)

GH-134273: Allow setting JIT compiler flags at build time with CFLAGS_JIT (GH134276)

Revert "gh-135410: use a critical section around `StringIO.__next__` (#135412)" (#135439)

This reverts commit e6c3039cb39e68ae9af9ddcaca341c5af8f9cf23.

gh-135429: Fix the argument mismatch in lsprof throw event (#135442)

doc: Remove what was essentially duplicate wording. (GH-135431)

gh-133390: Support SQL keyword completion for sqlite3 CLI (GH-133393) (GH-135292)

Co-authored-by: Tan Long <tanloong@foxmail.com>

gh-135410: use a critical section around `StringIO.__next__` (#135412)

gh-128627: Fix iPad detection in wasm-gc (#135388)

On some iPad versions, Safari reports as "macOS". Modifies the GC trampoline detection
to add a feature-based check to detect this case.

Fix presentation of dataclasses' `unsafe_hash` default value (#116532)

Co-authored-by: Adam Turner <9087854+AA-Turner@users.noreply.github.com>

gh-134939: Add the concurrent.interpreters Module (gh-133958)

PEP-734 has been accepted (for 3.14).

(FTR, I'm opposed to putting this under the concurrent package, but
doing so is the SC condition under which the module can land in 3.14.)