gh-111178: fix UBSan failures for `gdbmobject` (GH-128178)

* fix UBSan failures for `gdbmobject`
* suppress unused return values

gh-111178: fix UBSan failures in `Python/bltinmodule.c` (GH-128235)

* fix UBSan failures for `filterobject`
* fix UBSan failures for `mapobject`
* fix UBSan failures for `zipobject`

gh-111178: fix UBSan failures in `Objects/bytearrayobject.c` (GH-128236)

* fix UBSan failures for `bytesiterobject`
* fix UBSan failures for `PyByteArrayObject`

gh-111178: fix UBSan failures in `Objects/bytesobject.c` (GH-128237)

* remove redundant casts for `bytesobject`
* fix UBSan failures for `striterobject`

gh-111178: fix UBSan failures in `Modules/_bz2module.c` (GH-128238)

gh-111178: fix UBSan failures in `Objects/complexobject.c` (GH-128241)

fix UBSan failures for `PyComplexObject`

gh-128694: Fix `(env changed)` error in `test_inspect` (#128702)

gh-126862: Use `Py_ssize_t` instead of `int` when processing the number of super-classes  (#127523)

gh-128691: Use deferred reference counting on `_thread._local` (#128693)

This change, along with the LOAD_ATTR specializations, makes the
"thread_local_read" micro benchmark in Tools/ftscalingbench/ftscalingbench.py
scale well to multiple threads.

gh-127196: Fix crash in `_interpreters`, when `shared` had invalid encodings (#127220)

gh-128650: Fix incorrect statement in partial documentation (gh-128651)

gh-128002: fix `asyncio.all_tasks` against concurrent deallocations of tasks (#128541)

gh-128661: Fix `typing.evaluate_forward_ref` not showing deprecation (#128663)

gh-128661: Fix `typing.evaluate_forward_ref` not showing deprecataion

gh-128673: Increase coverage of `typing.get_type_hints` (#128674)

gh-118915: Document `PyUnstable_InterpreterState_GetMainModule` (GH-128483)

gh-124433: fix docs for `asyncio.Queue.task_done` (#128669)

gh-126137: improve docs for `loop.add_reader` and `loop.add_writer` (#128666)

gh-128629: Add Py_PACK_VERSION and Py_PACK_FULL_VERSION (GH-128630)

gh-79149: document reentrant safety of `loop.call_soon_threadsafe` (#128662)

Co-authored-by: Thomas Grainger <tagrain@gmail.com>

gh-97850: Remove the mention of removal from `ResourceReader` docs (#128602)

Remove the mention of removal from ResourceReader docs

acks: add myself (#128652)

GH-66409: check if exec_prefix is the same as prefix before searching executable_dir (#127974)

Remove unnecessary LIST_TO_TUPLE conversions (GH-126558)

gh-111178: fix UBSan failures in `Objects/capsule.c` (GH-128239)

fix UBSan failures for `PyCapsule`

gh-111178: fix UBSan failures in `Python/context.c` (GH-128242)

* fix UBSan failures for `PyContext`
* fix UBSan failures for `PyContextVar`
* fix UBSan failures for `PyContextToken`
* fix UBSan failures for `_PyContextTokenMissing`

gh-111178: fix UBSan failures in `Python/hamt.c` (GH-128247)

* fix UBSan failures for `PyHamtObject`
* fix UBSan failures for `PyHamtNode_Array`
* fix UBSan failures for `PyHamtNode_Collision`
* fix UBSan failures for `PyHamtNode_Bitmap`

gh-128615: Cover pickling of `ParamSpecArgs` and `ParamSpecKwargs` (#128616)

GH-127970: find the runtime library when dladdr is available (#127972)

gh-128613: Increase `typing.Concatenate` coverage (#128614)

gh-128617: Fix `test_typing.test_readonly_inheritance` (#128618)

gh-41872: Fix quick extraction of module docstrings from a file in pydoc (GH-127520)

It now supports docstrings with single quotes, escape sequences,
raw string literals, and other Python syntax.

Co-authored-by: Éric <merwok@netwok.org>
Co-authored-by: Serhiy Storchaka <storchaka@gmail.com>

gh-87506: Amend json.loads() post PR #127355 (#128609)

gh-87506: Document that json.load*() can raise UnicodeDecodeError (#127355)

Co-authored-by: Erlend Aasland <erlend@python.org>

GH-127809: Fix the JIT's understanding of ** (GH-127844)

gh-127614: Correctly check for ttyname_r() in configure (#128503)

PR #14868 replaced the ttyname() call with ttyname_r(), but the old
check remained.

gh-127350: Add more tests for Py_fopen() (GH-128587)

Docs: mark up json.load() using parameter list (#128488)

gh-115999: Add free-threaded specialization for COMPARE_OP (#126410)

Add free-threaded specialization for COMPARE_OP, and tests for COMPARE_OP specialization in general.

Co-authored-by: Donghee Na <donghee.na92@gmail.com>

gh-111178: fix UBSan failures in `Modules/_sre/sre.c` (GH-128250)

fix UBSan failures for `PatternObject`, `MatchObject`, `TemplateObject`, `ScannerObject`

gh-111178: fix UBSan failures in `Modules/_abc.c` (GH-128253)

* fix UBSan failures in `_abc.c`
* suppress unused return values

gh-128552: fix refcycles in eager task creation (#128553)

gh-128302: Fix bugs in xml.dom.xmlbuilder (GH-128284)

* Allow DOMParser.parse() to correctly handle DOMInputSource instances
  that only have a systemId attribute set.
* Fix DOMEntityResolver.resolveEntity(), which was broken by the
  Python 3.0 transition.
* Add Lib/test/test_xml_dom_xmlbuilder.py with few tests.

Add `.. availability:: Windows` directive to COM-related function prototype (GH-127436)

Add a directive to prototype that "returns a foreign function that will call a COM method"

gh-108202: Document calendar.Calendar.firstweekday (#128566)

gh-128146: Exclude os/log.h import on older macOS versions. (#128165)

Reworks the handling of Apple system log handling to account for older macOS
versions that don't provide os-log.

gh-128472: Add `-skip-funcs` to BOLT options to fix computed goto errors (gh-128511)

* Add `-skip-funcs` to BOLT options to fix computed goto errors

Co-authored-by: Gregory Szorc <gregory.szorc@gmail.com>
* NEWS

---------

Co-authored-by: Gregory Szorc <gregory.szorc@gmail.com>

gh-108202: Document `calendar.Calendar` methods `getfirstweekday` and `setfirstweekday` (#127579)

gh-128559: Remove typing import from asyncio.timeouts (#128560)

gh-127146: Strip dash from Emscripten compiler version (#128557)

`emcc -dumpversion` will sometimes say e.g., `4.0.0-git` but in this case
uname does not include `-git` in the version string. Use cut to delete
everything after the dash.

gh-127146: Skip Emscripten tests with pending fixes (#128549)

Marks some additional tests as skipped on Emscripten. Many of these skips can be
reverted when the next Emscripten release is available.

GH-128533: Add `NOT_TAKEN` instruction after bytecode optimization. (GH-128554)

gh-127146: Fix test_sysconfigdata_json for Emscripten (#128556)

GH-128375: Better instrument for `FOR_ITER` (GH-128445)

GH-128073: Include `EXIT_IF` when checking for escaping calls (GH-128537)

gh-127350: Add Py_fopen() and Py_fclose() functions (#127821)

gh-128340: add thread safe handle for `loop.call_soon_threadsafe` (#128369)

Adds `_ThreadSafeHandle` to be used for callbacks scheduled with `loop.call_soon_threadsafe`.

gh-90241: Clarify documentation for PyUnicode_FSConverter and PyUnicode_FSDecoder (GH-128451)

Co-authored-by: Stan Ulbrych <89152624+StanFromIreland@users.noreply.github.com>
Co-authored-by: Erlend E. Aasland <erlend.aasland@protonmail.com>

gh-111178: fix UBSan failures in `Objects/descrobject.c` (GH-128245)

fix UBSan failures for `propertyobject`

gh-77214: Update outdated documentation for numeric PyArg_Parse formats (GH-128454)

gh-128089: Add PYC magic number for VALUE_WITH_FAKE_GLOBALS (#128097)

Assign 3610 PYC magic number to VALUE_WITH_FAKE_GLOBALS
format of annotationlib.

gh-102471: convert decimal module to use PyLong_Export API (PEP 757) (#128267)

gh-128519: Align the docstring of untokenize() to match the docs (#128521)

gh-98188: Fix EmailMessage.get_payload to decode data when CTE value has extra text (#127547)

Up to this point message handling has been very strict with regards to content encoding values: mixed case was accepted, but trailing blanks or other text would cause decoding failure, even if the first token was a valid encoding.  By Postel's Rule we should go ahead and decode as long as we can recognize that first token.  We have not thought of any security or backward compatibility concerns with this fix.

This fix does introduce a new technique/pattern to the Message code: we look to see if the header has a 'cte' attribute, and if so we use that.  This effectively promotes the header API exposed by HeaderRegistry to an API that any header parser "should" support.  This seems like a reasonable thing to do.  It is not, however, a requirement, as the string value of the header is still used if there is no cte attribute.

The full fix (ignore any trailing blanks or blank-separated trailing text) applies only to the non-compat32 API.  compat32 is only fixed to the extent that it now ignores trailing spaces.  Note that the HeaderRegistry parsing still records a HeaderDefect if there is extra text.

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

Docs: fix `MessageDefect` references in email.policy docs (#128468)

gh-128504: Upgrade doctest to ubuntu-24.04 (#128506)

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

gh-128137: Update PyASCIIObject to handle interned field with the atomic operation (gh-128196)

gh-128437: Add `BOLT_COMMON_FLAGS` with `-update-debug-sections` (gh-128455)

Add `BOLT_COMMON_FLAGS` with `-update-debug-sections`

Co-authored-by: Gregory Szorc <gregory.szorc@gmail.com>

gh-115765: Document and enforce Autoconf 2.72 requirement (#128502)

gh-127553: Remove outdated TODO comment in _pydatetime (#127564)

gh-127954: Document PyObject_DelItemString (#127986)

Docs: amend json.dump() post gh-128482 (#128489)

gh-126719: Clarify math.fmod docs (#127741)

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

pathlib tests: create `walk()` test hierarchy without using class under test (#128338)

In the tests for `pathlib.Path.walk()`, avoid using the path class under
test (`self.cls`) in test setup. Instead we use `os` functions in
`test_pathlib`, and direct manipulation of `DummyPath` internal data in
`test_pathlib_abc`.

Docs: mark up json.dump() using parameter list (#128482)

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

GH-127381: pathlib ABCs: remove `PathBase.move()` and `move_into()` (#128337)

These methods combine `_delete()` and `copy()`, but `_delete()` isn't part
of the public interface, and it's unlikely to be added until the pathlib
ABCs are made official, or perhaps even later.

gh-128152: Argument Clinic: ignore pre-processor directives inside C comments (#128464)

Add `check-readthedocs` pre-commit hook (#128453)

gh-128002: fix many thread safety issues in asyncio (#128147)

* Makes `_asyncio.Task` and `_asyncio.Future` thread-safe by adding critical sections
* Add assertions to check for thread safety checking locking of object by critical sections in internal functions
* Make `_asyncio.all_tasks` thread safe when eager tasks are used
* Add a thread safety test

gh-125985: Fix `cmodule_function()` scaling benchmark (#128460)

Add a separate benchmark that measures the effect of
`_PyObject_LookupSpecial()` on scaling.

In the process of cleaning up the scaling benchmarks for inclusion, I
unintentionally changed the "cmodule_function" benchmark to pass an
`int` to `math.floor()` instead of a `float`, which causes it to use the
`_PyObject_LookupSpecial()` code path. `_PyObject_LookupSpecial()` has
its own scaling issues that we want to measure separately from calling a
function on a C module.

gh-128354: Consistently use LIBS over LDFLAGS in library build checks (#128359)

gh-128456: Use '-reorder-functions=cdsort' for BOLT builds (#128457)

'hfsort+' is deprecated in favor of 'cdsort'.

gh-128400: Only show the current thread in `faulthandler` if the GIL is disabled (GH-128425)

gh-127903: Fix a crash on debug builds when calling `Objects/unicodeobject::_copy_characters`` (#127876)

gh-89083: improve UUIDv8 uniqueness tests (GH-128149)

improve UUIDv8 uniqueness tests

gh-111178: fix UBSan failures in `Modules/zlibmodule.c` (GH-128252)

gh-111178: fix UBSan failures in `Objects/tupleobject.c` (GH-128251)

fix UBSan failures for `_PyTupleIterObject`

gh-111178: fix UBSan failures in `Objects/enumobject.c` (GH-128246)

* fix UBSan failures for `enumobject`
* fix UBSan failures for `reversedobject`

gh-111178: fix UBSan failures in `Modules/curses*.c` (GH-128244)

* fix UBSan failures in `_cursesmodule.c`
* fix UBSan failures in `_curses_panel.c`
* suppress an unused return value

gh-111178: fix UBSan failures in `Modules/_csv.c` (GH-128243)

Also: suppress unused return values

gh-112015: Implement `ctypes.memoryview_at()` (GH-112018)

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

gh-128317: Highlight today in colour in calendar CLI output (#128318)

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

gh-127787: refactor helpers for `PyUnicodeErrorObject` internal interface (GH-127789)

- Unify `get_unicode` and `get_string` in a single function.

- Allow to retrieve the underlying `object` attribute, its
  size, and the adjusted 'start' and 'end', all at once.
  Add a new `_PyUnicodeError_GetParams` internal function for this.
  (In `exceptions.c`, it's somewhat common to not need all the attributes,
  but the compiler has opportunity to inline the function and optimize
  unneeded work away. Outside that file, we'll usually need all or
  most of them at once.)

- Use a common implementation for the following functions:

  - `PyUnicode{Decode,Encode}Error_GetEncoding`
  - `PyUnicode{Decode,Encode,Translate}Error_GetObject`
  - `PyUnicode{Decode,Encode,Translate}Error_{Get,Set}Reason`
  - `PyUnicode{Decode,Encode,Translate}Error_{Get,Set}{Start,End}`

gh-115765: Upgrade to GNU Autoconf 2.72 (#128411)

gh-128404: Remove `asyncio` from `Lib/test/test_sys_settrace` (#128435)

gh-127529: Correct asyncio's `accept_connection` behaviour for handling `ConnectionAbortedError` (#127532)

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

gh-128104: Remove `Py_STRFTIME_C99_SUPPORT`; require C99-compliant strftime (#128106)

gh-108202: Document calendar.TextCalendar formatting helpers (#127608)

Document the following TextCalendar methods:
- formatday()
- formatmonthname()
- formatweekday()
- formatweekheader()

gh-128133: use relaxed atomics for hash of bytes (#128412)

gh-128404: remove asyncio from test_type_params (#128436)

gh-128426: Mention PySequence_Fast in free-threading C API HOWTO (#128428)