typing docs: Make the PEPs list an expandable section, hidden by default (#105353)

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

GH-95088: Clarify rules for parsing an item key for format strings (#103779)

Co-authored-by: Łukasz Langa <lukasz@langa.pl>
Co-authored-by: Jelle Zijlstra <jelle.zijlstra@gmail.com>

gh-105286: Further improvements to `typing.py` docstrings (#105363)

`typing.NewType` docs: the future performance improvements are now in the past (#105354)

GH-102613: Fast recursive globbing in `pathlib.Path.glob()` (GH-104512)

This commit introduces a 'walk-and-match' strategy for handling glob patterns that include a non-terminal `**` wildcard, such as `**/*.py`. For this example, the previous implementation recursively walked directories using `os.scandir()` when it expanded the `**` component, and then **scanned those same directories again** when expanded the `*.py` component. This is wasteful.

In the new implementation, any components following a `**` wildcard are used to build a `re.Pattern` object, which is used to filter the results of the recursive walk. A pattern like `**/*.py` uses half the number of `os.scandir()` calls; a pattern like `**/*/*.py` a third, etc.

This new algorithm does not apply if either:

1. The *follow_symlinks* argument is set to `None` (its default), or
2. The pattern contains `..` components.

In these cases we fall back to the old implementation.

This commit also replaces selector classes with selector functions. These generators directly yield results rather calling through to their successors. A new internal `Path._glob()` method takes care to chain these generators together, which simplifies the lazy algorithm and slightly improves performance. It should also be easier to understand and maintain.

gh-105382: Remove urllib.request cafile parameter (#105384)

Remove cafile, capath and cadefault parameters of the
urllib.request.urlopen() function, deprecated in Python 3.6.

gh-105407: Remove unused imports in the stdlib (#105411)

gh-105407: Remove unused imports in Tools/c-analyzer/ (#105410)

gh-105407: Remove unused imports in tools (#105409)

gh-105407: Remove unused imports in tests (#105408)

gh-82180: Update math.factorial(float) doc for Python 3.10 (#105385)

gh-105373: Fix decimal documentation formatting (#105395)

The deprecation is on decimal.HAVE_THREADS, not on the whole module.

sliding_window() recipe:  Raise ValueError for non-positive window sizes.  Add more tests. (GH-105403)

gh-105376: Remove logging.Logger.warn() method (#105377)

gh-104783: locale.getlocale() calls sys.getfilesystemencoding() (#105401)

locale.getlocale() always calls sys.getfilesystemencoding(), instead
of calling it only once.

gh-94172: Update keyfile removal documentation (#105392)

Remove the "deprecated:: 3.6" markup, since the parameters (like
keyfile and certfile) got removed in Python 3.12.

gh-92658: Fix typo in docs and tests for `HV_GUID_PARENT` (GH-105267)

gh-104783: locale.getencoding() fallback uses FS encoding (#105381)

The locale.getencoding() function now uses
sys.getfilesystemencoding() if _locale.getencoding() is missing,
instead of calling locale.getdefaultlocale().

gh-102304: Document Py_INCREF() change in What's New in Python 3.12 (#105389)

Not in Python 3.13.

gh-105156: Update Unicode C API: remove deprecation (#105379)

_PyUnicode_ToLowercase(), _PyUnicode_ToUppercase(),
_PyUnicode_ToTitlecase() are no longer deprecated in the
documentation. It's no longer needed since they now use Py_UCS4 type,
rather than the deprecated Py_UNICODE type.

gh-104783: Remove locale.resetlocale() function (#104784)

gh-105268: Add _Py_FROM_GC() function to pycore_gc.h (#105362)

* gcmodule.c reuses _Py_AS_GC(op) for AS_GC()
* Move gcmodule.c FROM_GC() implementation to a new _Py_FROM_GC()
  static inline function in pycore_gc.h.
* _PyObject_IS_GC(): only get the type once
* gc_is_finalized(à) and PyObject_GC_IsFinalized() use
  _PyGC_FINALIZED(), instead of _PyGCHead_FINALIZED().
* Remove _Py_CAST() in pycore_gc.h: this header file is not built
  with C++.

build(deps): bump requests from 2.29.0 to 2.31.0 in /Doc (#105368)

Bumps [requests](https://github.com/psf/requests) from 2.29.0 to 2.31.0.
- [Release notes](https://github.com/psf/requests/releases)
- [Changelog](https://github.com/psf/requests/blob/main/HISTORY.md)
- [Commits](https://github.com/psf/requests/compare/v2.29.0...v2.31.0)

---
updated-dependencies:
- dependency-name: requests
  dependency-type: direct:production
...

Signed-off-by: dependabot[bot] <support@github.com>
Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>

gh-105259: Ensure we don't show newline characters for trailing NEWLINE tokens (#105364)

gh-102304: Fix up Simple ABI doc (GH-105351)

gh-104411: Update test_getint for Tcl 9.0 (GH-104412)

gh-105268: Remove _PyGC_FINALIZED() macro (#105350)

Remove the old private, undocumented and untested _PyGC_FINALIZED()
macro which was kept for backward compatibility with Python 3.8 and
older.

Add myself as codeowner for Limited API/Stable ABI, remove from *import* (GH-105349)

This should set up more relevant notifications for me.

gh-90005: Don't link with libbsd if not needed (#105236)

The regression was introduced with commit 5b946cada.
Restore pre gh-29696 behaviour.

gh-105292: Add option to make traceback.TracebackException.format_exception_only recurse into exception groups (#105294)

Co-authored-by: Erlend E. Aasland <erlend.aasland@protonmail.com>
Co-authored-by: Łukasz Langa <lukasz@langa.pl>

gh-102304: Fix Py_INCREF() stable ABI in debug mode (#104763)

When Python is built in debug mode (if the Py_REF_DEBUG macro is
defined), the Py_INCREF() and Py_DECREF() function are now always
implemented as opaque functions to avoid leaking implementation
details like the "_Py_RefTotal" variable or the
_Py_DecRefTotal_DO_NOT_USE_THIS() function.

* Remove _Py_IncRefTotal_DO_NOT_USE_THIS() and
  _Py_DecRefTotal_DO_NOT_USE_THIS() from the stable ABI.
* Remove _Py_NegativeRefcount() from limited C API.

gh-102304: doc: Add links to Stable ABI and Limited C API (#105345)

* Add "limited-c-api" and "stable-api" references.
* Rename "stable-abi-list" reference to "limited-api-list".
* Makefile: Document files regenerated by "make regen-limited-abi"
* Remove first empty line in generated files:

  - Lib/test/test_stable_abi_ctypes.py
  - PC/python3dll.c

gh-104399: Use newer libtommath APIs when necessary (GH-104407)

Display the sanitizer config in the regrtest header. (#105301)

Display the sanitizers present in libregrtest.

Having this in the CI output for tests with the relevant environment
variable displayed will help make it easier to do what we need to
create an equivalent local test run.

gh-105324: Fix tokenize module main function for stdin (#105325)

Remove dead code in codeop.py (#105263)

gh-89412: Add missing attributes (added in 3.10) to traceback module docs (#105046)

What's New in 3.12: List 'Improved Modules' alphabetically (#105315)

gh-105286: Improve `typing.py` docstrings (#105287)

Co-authored-by: Shantanu <12621235+hauntsaninja@users.noreply.github.com>
Co-authored-by: Nikita Sobolev <mail@sobolevn.me>

gh-105280: Ensure `isinstance([], collections.abc.Mapping)` always evaluates to `False` (#105281)

gh-103906: Remove immortal refcounting in compile/marshal.c (gh-103922)

gh-105237: Allow calling `issubclass(X, typing.Protocol)` again (#105239)

gh-105164: Detect annotations inside match blocks (#105177)

GH-105229: Replace some superinstructions with single instruction equivalent. (GH-105230)

GH-104584: Allow optimizers to opt out of optimizing. (GH-105244)

gh-103558: Add coverage tests for argparse (#103570)

Co-authored-by: Shantanu <12621235+hauntsaninja@users.noreply.github.com>
Co-authored-by: hauntsaninja <hauntsaninja@gmail.com>

gh-98963: Restore the ability to have a dict-less property. (#105262)

Ignore doc string assignment failures in `property` as has been the
behavior of all past Python releases.

gh-80480: array: Add 'w' typecode. (#105242)

gh-104882: Docs: fix description of relationship between `socket.getblocking()` and `socket.gettimeout()` (#105026)

Fix typo in Python 3.12 What's New (#105278)

gh-104690 Disallow thread creation and fork at interpreter finalization (#104826)

Disallow thread creation and fork at interpreter finalization.

in the following functions, check if interpreter is finalizing and raise `RuntimeError` with appropriate message:
* `_thread.start_new_thread` and thus `threading`
* `posix.fork`
* `posix.fork1`
* `posix.forkpty`
* `_posixsubprocess.fork_exec` when a `preexec_fn=` is supplied.

---------

Co-authored-by: blurb-it[bot] <43283697+blurb-it[bot]@users.noreply.github.com>
Co-authored-by: Gregory P. Smith <greg@krypto.org>

gh-89415: Mention new `IP_*` constants in `socket` module in the docs (#105266)

gh-103277: remove unused macros (#105247)

gh-101524: Only Use Public C-API in the _xxsubinterpreters Module (gh-105258)

The _xxsubinterpreters module was meant to only use public API.  Some internal C-API usage snuck in over the last few years (e.g. gh-28969).  This fixes that.

gh-105080: Fixed inconsistent signature on derived classes (#105217)

GH-102404, GH-100956: Document how to do a WASI build (GH-105251)

Also includes a reference shell script to implements what is documented.

gh-104614: Fix potential ref. leak in _testcapimodule/get_basic_static_type() (#105225)

gh-102778: update documentation of PyErr_PrintEx and traceback.print_last() regarding sys.last_exc (#105190)

gh-87092: avoid gcc warning on uninitialized struct field in assemble… (gh-105243)

gh-87092: avoid gcc warning on uninitialized struct field in assemble.c (part2)

gh-105240: add missing function prototypes (#105241)

gh-105214: Use named constants for MAKE_FUNCTION oparg (#105215)

gh-105194: Fix format specifier escaped characters in f-strings (#105231)

GH-104584: Plugin optimizer API (GH-105100)

GH-105162: Account for `INSTRUMENTED_RESUME` in gen.close/throw. (GH-105187)

gh-105184: document that marshal functions can fail and need to be checked with PyErr_Occurred (#105185)

gh-104799: Default missing lists in AST to the empty list (#104834)

Co-authored-by: Alex Waygood <Alex.Waygood@Gmail.com>

gh-85275: Remove old buffer APIs (#105137)

They are now abi-only.

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

gh-92536: Remove PyUnicode_READY() calls (#105210)

Since Python 3.12, PyUnicode_READY() does nothing and always
returns 0.

gh-92536: Argument Clinic no longer emits PyUnicode_READY() (#105208)

Since Python 3.12, PyUnicode_READY() does nothing and always
returns 0.

Argument Clinic now also checks for .cpp files (PC/_wmimodule.cpp).

gh-104614: Make Sure ob_type is Always Set Correctly by PyType_Ready() (gh-105122)

When I added the relevant condition to type_ready_set_bases() in gh-103912, I had missed that the function also sets tp_base and ob_type (if necessary).  That led to problems for third-party static types.

We fix that here, by making those extra operations distinct and by adjusting the condition to be more specific.

gh-104341: Call _PyEval_ReleaseLock() with NULL When Finalizing the Current Thread (gh-105109)

This avoids the problematic race in drop_gil() by skipping the FORCE_SWITCHING code there for finalizing threads.

(The idea for this approach came out of discussions with @markshannon.)

GH-89886: Bump to GNU Autoconf v2.71 (#104925)

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

gh-105140: remove unused arg of _PyErr_ChainStackItem (#105141)

gh-103142: Upgrade binary builds and CI to OpenSSL 1.1.1u (#105174)

Upgrade builds to OpenSSL 1.1.1u.

This OpenSSL version addresses a pile if less-urgent CVEs since 1.1.1t.

The Mac/BuildScript/build-installer.py was already updated.

Also updates _ssl_data_111.h from OpenSSL 1.1.1u, _ssl_data_300.h from 3.0.9, and adds a new _ssl_data_31.h file from 3.1.1 along with the ssl.c code to use it.

Manual edits to the _ssl_data_300.h file prevent it from removing any existing definitions in case those exist in some peoples builds and were important (avoiding regressions during backporting).

backports of this prior to 3.12 will not include the openssl 3.1 header.

gh-105191: Cleanup peg generator; keep only necessary files (#105197)

gh-105145: Deprecate Py_GetPath() function (#105179)

Deprecate old Python initialization functions:

* PySys_ResetWarnOptions()
* Py_GetExecPrefix()
* Py_GetPath()
* Py_GetPrefix()
* Py_GetProgramFullPath()
* Py_GetProgramName()
* Py_GetPythonHome()

_tkinter.c uses sys.executable instead of Py_GetProgramName()
and uses sys.prefix instead of Py_GetPrefix().

gh-105182: Remove PyEval_AcquireLock() and PyEval_InitThreads() (#105183)

Remove functions in the C API:

* PyEval_AcquireLock()
* PyEval_ReleaseLock()
* PyEval_InitThreads()
* PyEval_ThreadsInitialized()

But keep these functions in the stable ABI.

Mention "make regen-limited-abi" in "make regen-all".

gh-89886: Rely on HAVE_SYS_TIME_H (#105058)

Quoting autoconf (v2.71):

    All current systems provide time.h; it need not be checked for.
    Not all systems provide sys/time.h, but those that do, all allow
    you to include it and time.h simultaneously.

remove unused #includes of pycore_pymem.h (#105166)

gh-103224: Use the realpath of the Python executable in `test_venv` (GH-103243)

Co-authored-by: Oleg Iarygin <oleg@arhadthedev.net>

gh-105107: Remove PyCFunction_Call() function (#105181)

* Keep the function in the stable ABI.
* Add unit tests on PyCFunction_Call() since it remains supported in
  the stable ABI.

gh-105156: Update Lib/test/clinic.test manually (#105180)

Update Lib/test/clinic.test manually for updated Py_UNICODE
converter: it now uses wchar_t type rather than Py_UNICODE.

Fix docstring of `warnings._deprecated` to show correct `remove` value (#105178)

gh-105156: Cleanup usage of old Py_UNICODE type (#105158)

* refcounts.dat:

  * Remove Py_UNICODE functions.
  * Replace Py_UNICODE argument type with wchar_t.

* _PyUnicode_ToLowercase(), _PyUnicode_ToUppercase(),
  _PyUnicode_ToTitlecase() are no longer deprecated in comments.
  It's no longer needed since they now use Py_UCS4 type, rather than
  the deprecated Py_UNICODE type.
* gdb: Remove unused char_width() method.

gh-105145: Remove old functions to config Python init (#105154)

Remove the following old functions to configure the Python
initialization, deprecated in Python 3.11:

* PySys_AddWarnOptionUnicode()
* PySys_AddWarnOption()
* PySys_AddXOption()
* PySys_HasWarnOptions()
* PySys_SetArgvEx()
* PySys_SetArgv()
* PySys_SetPath()
* Py_SetPath()
* Py_SetProgramName()
* Py_SetPythonHome()
* Py_SetStandardStreamEncoding()
* _Py_SetProgramFullPath()

Most of these functions are kept in the stable ABI, except:

* Py_SetStandardStreamEncoding()
* _Py_SetProgramFullPath()

Update Doc/extending/embedding.rst and Doc/extending/extending.rst to
use the new PyConfig API.

_testembed.c:

* check_stdio_details() now sets stdio_encoding and stdio_errors
  of PyConfig.
* Add definitions of functions removed from the API but kept in the
  stable ABI.
* test_init_from_config() and test_init_read_set() now use
  PyConfig_SetString() instead of PyConfig_SetBytesString().

Remove _Py_ClearStandardStreamEncoding() internal function.

gh-105156: Deprecate the old Py_UNICODE type in C API (#105157)

Deprecate the old Py_UNICODE and PY_UNICODE_TYPE types in the C API:
use wchar_t instead.

Replace Py_UNICODE with wchar_t in multiple C files.

Co-authored-by: Inada Naoki <songofacandy@gmail.com>

gh-105172: Fixed functools.lru_cache typed argument docstring. (GH-105173)

gh-102251: Explicitly free state for test modules with state in test_import (#105085)

Co-authored-by: Erlend E. Aasland <erlend.aasland@protonmail.com>

Clarify that error messages are better with PEP 701 (#105150)

Co-authored-by: Marta Gómez Macías <mgmacias@google.com>

gh-103464: Add checks for arguments of pdb commands (GH-103465)

gh-105146: Update links at end of Windows installer (uninstall/repair) (GH-105147)

gh-105148: make _PyASTOptimizeState internal to ast_opt.c (#105149)

gh-105156: Argument Clinic avoids Py_UNICODE type (#105161)

Argument Clinic now uses "const wchar_t*" type instead of
"const Py_UNICODE*" type for the "Py_UNICODE" format.

gh-105144: Runtime-checkable protocols: move all 'sanity checks' to `_ProtocolMeta.__subclasscheck__` (#105152)

gh-104909: Split BINARY_OP into micro-ops (#104910)

Co-authored-by: Brandt Bucher <brandtbucher@gmail.com>

gh-105111: remove deprecated macros Py_TRASHCAN_SAFE_BEGIN and Py_TRASHCAN_SAFE_END (#105112)

gh-104773: cgi: Fix typo in What's New in Python 3.13 (#105139)

gh-105096: Deprecate wave getmarkers() method (#105098)

wave: Deprecate the getmark(), setmark() and getmarkers() methods of
the Wave_read and Wave_write classes. They will be removed in Python
3.15.

gh-62948: IOBase finalizer logs close() errors (#105104)

gh-105096: Reformat wave documentation (#105136)

Add ".. class::" markups in the wave documentation.

* Reformat also wave.py (minor PEP 8 changes).
* Remove redundant "import struct": it's already imported at top
  level.
* Remove wave.rst from .nitignore