gh-141784: Fix _remote_debugging_module.c compilation on 32-bit Linux (#141796)

Include Python.h before system headers to make sure that
_remote_debugging_module.c uses the same types (ABI) than Python.

gh-140042: Removing unsafe call to sqlite3_shutdown (GH-141690)

gh-141004: Document missing `PyDateTime*` APIs (GH-141543)

Co-authored-by: Stan Ulbrych <89152624+StanFromIreland@users.noreply.github.com>
Co-authored-by: Victor Stinner <vstinner@python.org>

gh-141004: Document missing generator APIs (GH-141409)

Co-authored-by: Victor Stinner <vstinner@python.org>

gh-141004: Document `Py_MakePendingCalls` (GH-141137)

Co-authored-by: Victor Stinner <vstinner@python.org>

gh-141757: Comply with pickle protocol in test_reduce_5tuple (GH-141759)

The 5th element of the __reduce__ tuple should be an iterator.

gh-139871: Optimize small takes in bytearray.take_bytes (GH-141741)

When less than half the buffer is taken just copy that small part out
rather than doing a big alloc + memmove + big shrink.

gh-141489: Simplify closure/freevar iteration in `annotationlib._build_closure()` (#141490)

gh-141615: Check stdin instead of stdout for use_rawinput in pdb (#141616)

[Docs] Fix typo in bdb: `is_skipped_line` to `is_skipped_module` (#141771)

Simplify setting CLI options for WASI builds (GH-141769)

This introduces a Wasmtime configuration file to get some CLI options out of the code for easier manipulation. It also allows for easier tweaking after the Makefile is generated.

As well, cut back on the flexibility of specifying HOSTRUNNER for simpler code. The flexibility was never used and so it didn't make sense to keep it around.

Remove GvR from '_stdauthor' in Doc/conf.py (#141765)

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

Move the NEWS entry for gh-141659 to the correct section (GH-141744)

gh-141004: Document `Py_LOCAL` and `Py_LOCAL_INLINE` (GH-141725)

gh-141721: Improve docstring for LastUpdatedOrderedDict example (gh141724)

gh-141172: Update to wasi-sdk-29 (GH-141684)

This commit updates CI and configuration from wasi-sdk-25 to wasi-sdk-29
which was released recently. This notably includes stubs for pthreads
which all return errors, so some adjustment in logic is necessary to
retain knowledge that WASI cannot yet spawn threads for example.

This additionally increases the wasm stack allowance to 32MiB from 16MiB
to accomodate the `test_recursive_pickle` test in the
`test_functools.py` file. It looks like the Clang/LLVM update that
happened in wasi-sdk-29 relative to wasi-sdk-25 is likely the cause of
this where presumably functions have more locals than before and/or a
slightly adjusted stack space requirement which overflows the stack.

gh-41779: Allow defining the __dict__ and __weakref__ __slots__ for any class (GH-141755)

GH-140638: Add a GC "duration" stat (GH-141720)

gh-138072: Small clarifications and phrasing improvements to asyncio HOWTO (#138073)

* - Small clarifications and phrasing improvements

* nit

* Apply suggestions from code review

Co-authored-by: Peter Bierma <zintensitydev@gmail.com>
* clarify event loops when multi threading.

* nit

* Update Doc/howto/a-conceptual-overview-of-asyncio.rst

Co-authored-by: Peter Bierma <zintensitydev@gmail.com>
* nit

* nit

* phrasing for threads & event loops.

* revert changes to event-loop/thread discussion.

* sentence case consistencty.

* slight re-arrange.

* Sentence case consistency.

* tweak language. non-negligible

---------

Co-authored-by: Peter Bierma <zintensitydev@gmail.com>

gh-141570: can_colorize: Expect fileno() to raise OSError, as documented (#141716)

In Fedora, we've been given a slightly incomplete reproducer for a problematic
Python 3.14 color-related change in argparse that leads to an exception when
Python is used from mod_wsgi: https://bugzilla.redhat.com/2414940

mod_wsgi replaces sys.stdout with a custom object that raises OSError on .fileno():

https://github.com/GrahamDumpleton/mod_wsgi/blob/8460dbfcd5c7108892b3cde9fab7cbc1caa27886/src/server/wsgi_logger.c#L434-L440

This should be supported, as the documentation of fileno explicitly says:

> An OSError is raised if the IO object does not use a file descriptor.

https://docs.python.org/3.14/library/io.html#io.IOBase.fileno

The previously expected exception inherits from OSError,
so it is still expected.

Fixes https://github.com/python/cpython/issues/141570

Co-authored-by: Cody Maloney <cmaloney@users.noreply.github.com>
Co-authored-by: Victor Stinner <vstinner@python.org>

gh-135953: Avoid BytesWarning when sampling profiler tests fail (GH-141719)

With `-bb`, this failed on BytesWarning: str() on a bytes instance

gh-140875: Fix handling of unclosed charrefs before EOF in HTMLParser (GH-140904)

gh-141726: Add PyDict_SetDefaultRef() to the Stable ABI (#141727)

Co-authored-by: Stan Ulbrych <89152624+StanFromIreland@users.noreply.github.com>

Correct class name from PullDom to PullDOM (#141207)

GH-139653: Only raise an exception (or fatal error) when the stack pointer is about to overflow the stack. (GH-141711)

Only raises if the stack pointer is both below the limit *and* above the stack base.
This prevents false positives for user-space threads, as the stack pointer will be outside those bounds
if the stack has been swapped.

Merge branch 'main' of https://github.com/python/cpython

Post 3.15.0a2

gh-141659: Fix bad file descriptor error in subprocess on AIX (GH-141660)

/proc/self does not exist on AIX.

gh-141692: Add a slice-specific lib folder to iOS XCframeworks. (#141693)

Modifies the iOS XCframework to include a lib folder for each slice that
contains a symlinked version of the libPython dynamic library.

gh-139103: fix free-threading `dataclass.__init__` perf issue (gh-141596)

The dataclasses `__init__` function is generated dynamically by a call to `exec()` and so doesn't have deferred reference counting enabled. Enable deferred reference counting on functions when assigned as an attribute to type objects to avoid reference count contention when creating dataclass instances.

gh-140381: Increase slow_fibonacci call frequency in test_profiling (#140673)

gh-141691: Apply ruff rules to Apple folder. (#141694)

Add ruff configuration to run over the Apple build tooling and testbed script.

GH-141686: Break cycles created by JSONEncoder.iterencode (GH-141687)

gh-42400: Fix buffer overflow in _Py_wrealpath() for very long paths (#141529)

Co-authored-by: Victor Stinner <vstinner@python.org>

gh-141070: Add PyUnstable_Object_Dump() function (#141072)

* Promote _PyObject_Dump() as a public function.
* Keep _PyObject_Dump() alias to PyUnstable_Object_Dump()
  for backward compatibility.
* Replace _PyObject_Dump() with PyUnstable_Object_Dump().

Co-authored-by: Peter Bierma <zintensitydev@gmail.com>
Co-authored-by: Kumar Aditya <kumaraditya@python.org>
Co-authored-by: Petr Viktorin <encukou@gmail.com>

gh-138189: Link references to type slots (GH-141410)

Link references to type slots

gh-135953: Refactor test_sampling_profiler into multiple files (#141689)

Python 3.15.0a2

gh-133879: Copyedit "What's new in Python 3.15" (#141717)

GH-139109: Support switch/case dispatch with the tracing interpreter. (GH-141703)

Add missing backticks in os and decimal docs (#141699)

gh-141004: Document Py_HUGE_VAL/IS_FINITE/IS_INFINITE/IS_NAN (#141544)

Co-authored-by: Victor Stinner <vstinner@python.org>
Co-authored-by: Stan Ulbrych <89152624+StanFromIreland@users.noreply.github.com>

gh-129005: Remove copies from _pyio using take_bytes (#141539)

Memory usage now matches that of _io for large files.

gh-140729: Fix subprocess handling in test_process_pool_executor_pickle (#141688)

gh-141004: Document `Py_MEMCPY` (GH-141676)

gh-141004: Document `PyODict*` APIs (GH-141136)

gh-140578: Delete unnecessary NEWS entry (#141427)

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

gh-141497: Make ipaddress.IP{v4,v6}Network.hosts() always returning an iterator (GH-141547)

gh-135953: Simplify GC markers in the tachyon profiler (#141666)

gh-130160: Add anchors to CLI Usage section for `cmdline` (#133182)

gh-130693: Support more options for search in tkinter.Text (GH-130848)

* Add parameters nolinestop and strictlimits in the tkinter.Text.search() method.
* Add the tkinter.Text.search_all() method.
* Add more tests for tkinter.Text.search().
* stopindex is now only ignored if it is None.

GH-139914: Handle stack growth direction on HPPA (GH-140028)

Adapted from a patch for Python 3.14 submitted to the Debian BTS by John
https://bugs.debian.org/1105111#20

Co-authored-by: John David Anglin <dave.anglin@bell.net>

GH-140643: Add `<native>` and `<GC>` frames to the sampling profiler (#141108)

- Introduce a new field in the GC state to store the frame that initiated garbage collection.
- Update RemoteUnwinder to include options for including "<native>" and "<GC>" frames in the stack trace.
- Modify the sampling profiler to accept parameters for controlling the inclusion of native and GC frames.
- Enhance the stack collector to properly format and append these frames during profiling.
- Add tests to verify the correct behavior of the profiler with respect to native and GC frames, including options to exclude them.

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

gh-135953: Add GIL contention markers to sampling profiler Gecko format (#139485)

This commit enhances the Gecko format reporter in the sampling profiler
to include markers for GIL acquisition events.

gh-140729: Add __mp_main__ as a duplicate for __main__ for pickle to work (#140735)

Docs: Fix typo in socketserver documentation (#140956)

gh-62480: De-personalize "Coping with mutable arguments" section in `unittest.mock` examples (#141323)

gh-141650: Fix typo in `xml.sax.saxutils.unescape` documentation (#141652)

gh-141018: Update `.exe`, `.dll`, `.rtf` and `.jpg` mime types in `mimetypes` (#141023)

fix memory order of `_Py_atomic_store_uint_release` (#141562)

gh-136057: Allow step and next to step over for loops (#136160)

gh-141004: Document missing `PyCFunction*` and `PyCMethod*` APIs (GH-141253)

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

gh-125115 : Refactor the pdb parsing issue so positional arguments can pass through (#140933)

gh-141004: Document the `PyPickleBuffer_*` C API (GH-141630)

Co-authored-by: Peter Bierma <zintensitydev@gmail.com>

gh-139109: JIT _EXIT_TRACE to ENTER_EXECUTOR rather than _DEOPT (GH-141573)

gh-141553: Fix incorrect function signatures in `_testmultiphase` (#141554)

gh-140458: `xmlrpc.client` raises Fault, does not returns it. (GH-140759)

gh-141579: Fix perf_jit backend in sys.activate_stack_trampoline() (#141580)

gh-136442: Fix unittest to return exit code 5 when setUpClass raises an exception (#136487)

GH-90344: replace single-call `io.IncrementalNewlineDecoder` usage with non-incremental newline decoders (GH-30276)

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

gh-140938: Raise ValueError for infinite inputs to stdev/pstdev (GH-141531)

Raise ValueError for infinite inputs to stdev/pstdev

---

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

gh-141367: Use CALL_LIST_APPEND instruction only for lists, not for list subclasses (GH-141398)

Co-authored-by: Ken Jin <kenjin4096@gmail.com>

gh-114203: skip locking if object is already locked by two-mutex critical section (#141476)

gh-141488: Add `Py_` prefix to Include/datetime.h macros (#141493)

Add PyManager troubleshooting steps for direct launch of script files (GH-141530)

gh-116146: Avoid empty braces in _testembed.c (GH-141556)

gh-139653: Remove assertions in _Py_InitializeRecursionLimits() (#141551)

These checks were invalid and failed randomly on FreeBSD
and Alpine Linux.

GH-141509: Fix warning about remaining subinterpreters (GH-141528)

Co-authored-by: Peter Bierma <zintensitydev@gmail.com>

GH-141312: Allow only integers to longrangeiter_setstate state (GH-141317)

This fixes an assertion error when the new computed start is not an integer.

gh-139344: Remove pending removal notice for undeprecated importlib.resources API (GH-141507)

gh-122255: Synchronize warnings in C and Python implementations of the warnings module (GH-122824)

In the linecache module and in the Python implementation of the
warnings module, a DeprecationWarning is issued when
m.__loader__ differs from m.__spec__.loader (like in the C
implementation of the warnings module).

gh-131229: Temporarily skip `test_basic_multiple_interpreters_deleted_no_reset` (GH-141552)

This is a temporary band-aid to unblock other PRs.

Co-authored-by: Kumar Aditya <kumaraditya@python.org>

gh-141004: Document `PyOS_InterruptOccurred` (GH-141526)

gh-141376: Remove exceptions from `make smelly` (GH-141392)

* Don't ignore initialized data and BSS
* Remove exceptions for _init and _fini

gh-131510: Use PyUnstable_Unicode_GET_CACHED_HASH() (GH-141520)

Replace code that directly accesses PyASCIIObject.hash with
PyUnstable_Unicode_GET_CACHED_HASH().

Remove redundant "assert(PyUnicode_Check(op))" from
PyUnstable_Unicode_GET_CACHED_HASH(), _PyASCIIObject_CAST() already
implements the check.

gh-139596: Cease caching config.cache & ccache in GH Actions (#141451)

gh-116146: Add C-API to create module from spec and initfunc (GH-139196)

Co-authored-by: Kumar Aditya <kumaraditya@python.org>
Co-authored-by: Petr Viktorin <encukou@gmail.com>
Co-authored-by: Victor Stinner <vstinner@python.org>

gh-140550: Use a bool for the Py_mod_gil value (GH-141519)

This needs a single bit, but was stored as a void* in the module
struct. This didn't matter due to packing, but now that there's
another bool in the struct, we can save a bit of memory by
making md_gil a bool.

Variables that changed type are renamed, to detect conflicts.

gh-140790: pdb: Initialize instance variables in Pdb.__init__ (#140791)

Initialize lineno, stack, curindex, curframe, currentbp, and _user_requested_quit attributes in `Pdb.__init__``.

gh-140601: Add ResourceWarning to iterparse when not closed (GH-140603)

When iterparse() opens a file by filename and is not explicitly closed,
emit a ResourceWarning to alert developers of the resource leak.

Signed-off-by: Osama Abdelkader <osama.abdelkader@gmail.com>
Co-authored-by: Serhiy Storchaka <storchaka@gmail.com>

gh-137969: Fix double evaluation of `ForwardRef`s which rely on globals (#140974)

gh-139109: A new tracing JIT compiler frontend for CPython (GH-140310)

This PR changes the current JIT model from trace projection to trace recording. Benchmarking: better pyperformance (about 1.7% overall) geomean versus current https://raw.githubusercontent.com/facebookexperimental/free-threading-benchmarking/refs/heads/main/results/bm-20251108-3.15.0a1%2B-7e2bc1d-JIT/bm-20251108-vultr-x86_64-Fidget%252dSpinner-tracing_jit-3.15.0a1%2B-7e2bc1d-vs-base.svg, 100% faster Richards on the most improved benchmark versus the current JIT. Slowdown of about 10-15% on the worst benchmark versus the current JIT. **Note: the fastest version isn't the one merged, as it relies on fixing bugs in the specializing interpreter, which is left to another PR**. The speedup in the merged version is about 1.1%. https://raw.githubusercontent.com/facebookexperimental/free-threading-benchmarking/refs/heads/main/results/bm-20251112-3.15.0a1%2B-f8a764a-JIT/bm-20251112-vultr-x86_64-Fidget%252dSpinner-tracing_jit-3.15.0a1%2B-f8a764a-vs-base.svg

Stats: 50% more uops executed, 30% more traces entered the last time we ran them. It also suggests our trace lengths for a real trace recording JIT are too short, as a lot of trace too long aborts https://github.com/facebookexperimental/free-threading-benchmarking/blob/main/results/bm-20251023-3.15.0a1%2B-eb73378-CLANG%2CJIT/bm-20251023-vultr-x86_64-Fidget%252dSpinner-tracing_jit-3.15.0a1%2B-eb73378-pystats-vs-base.md .

This new JIT frontend is already able to record/execute significantly more instructions than the previous JIT frontend. In this PR, we are now able to record through custom dunders, simple object creation, generators, etc. None of these were done by the old JIT frontend. Some custom dunders uops were discovered to be broken as part of this work gh-140277

The optimizer stack space check is disabled, as it's no longer valid to deal with underflow.

Pros:
* Ignoring the generated tracer code as it's automatically created, this is only additional 1k lines of code. The maintenance burden is handled by the DSL and code generator.
* `optimizer.c` is now significantly simpler, as we don't have to do strange things to recover the bytecode from a trace.
* The new JIT frontend is able to handle a lot more control-flow than the old one.
* Tracing is very low overhead. We use the tail calling interpreter/computed goto interpreter to switch between tracing mode and non-tracing mode. I call this mechanism dual dispatch, as we have two dispatch tables dispatching to each other. Specialization is still enabled while tracing.
* Better handling of polymorphism. We leverage the specializing interpreter for this.

Cons:
* (For now) requires tail calling interpreter or computed gotos. This means no Windows JIT for now :(. Not to fret, tail calling is coming soon to Windows though https://github.com/python/cpython/pull/139962

Design:
* After each instruction, the `record_previous_inst` function/label is executed. This does as the name suggests.
* The tracing interpreter lowers bytecode to uops directly so that it can obtain "fresh" values at the point of lowering.
* The tracing version behaves nearly identical to the normal interpreter, in fact it even has specialization! This allows it to run without much of a slowdown when tracing. The actual cost of tracing is only a function call and writes to memory.
* The tracing interpreter uses the specializing interpreter's deopt to naturally form the side exit chains. This allows it to side exit chain effectively, without repeating much code. We force a re-specializing when tracing a deopt.
* The tracing interpreter can even handle goto errors/exceptions, but I chose to disable them for now as it's not tested.
* Because we do not share interpreter dispatch, there is should be no significant slowdown to the original specializing interpreter on tailcall and computed got with JIT disabled. With JIT enabled, there might be a slowdown in the form of the JIT trying to trace.
* Things that could have dynamic instruction pointer effects are guarded on. The guard deopts to a new instruction --- `_DYNAMIC_EXIT`.

gh-141004: Document `PyErr_RangedSyntaxLocationObject` (#141521)

PyErr_RangedSyntaxLocationObject

gh-140873: Add support of non-descriptor callables in functools.singledispatchmethod() (GH-140884)

gh-139653: Add PyUnstable_ThreadState_SetStackProtection() (#139668)

Add PyUnstable_ThreadState_SetStackProtection() and
PyUnstable_ThreadState_ResetStackProtection() functions
to set the stack base address and stack size of a Python
thread state.

Co-authored-by: Petr Viktorin <encukou@gmail.com>

gh-141004: Document `PyCode_Optimize` (GH-141378)

gh-141004: Document C APIs for dictionary keys, values, and items (GH-141009)

Co-authored-by: Petr Viktorin <encukou@gmail.com>

gh-137959: Fix `TIER1_TO_TIER2` macro name in JIT InternalDocs (GH-141496)

JIT InternalDocs fix

gh-139871: Add `bytearray.take_bytes([n])` to efficiently extract `bytes` (GH-140128)

Update `bytearray` to contain a `bytes` and provide a zero-copy path to
"extract" the `bytes`. This allows making several code paths more efficient.

This does not move any codepaths to make use of this new API. The documentation
changes include common code patterns which can be made more efficient with
this API.

---

When just changing `bytearray` to contain `bytes` I ran pyperformance on a
`--with-lto --enable-optimizations --with-static-libpython` build and don't see
any major speedups or slowdowns with this; all seems to be in the noise of
my machine (Generally changes under 5% or benchmarks that don't touch
bytes/bytearray).

Co-authored-by: Victor Stinner <vstinner@python.org>
Co-authored-by: Maurycy Pawłowski-Wieroński <5383+maurycy@users.noreply.github.com>

gh-140601: Refactor ElementTree.iterparse() tests (GH-141499)

Split existing tests on smaller methods and move them to separate class.
Rename variable "content" to "it".
Use BytesIO instead of StringIO.
Add few more tests.