gh-101100: Fix most Sphinx nitpicks in `inspect.rst` (#112662)

Fix link to 'The Perils of Floating Point', on the tutorial (GH-112499)

Use author link to 'The Perils of Floating Point'.

gh-112645: remove deprecation warning for use of onerror in shutil.rmtree (#112659)

gh-112620: Fix dis error on show_cache with labels (#112621)

Run more `inspect.rst` code snippets in CI (#112654)

gh-111545: Mention PEP 456 in PyHash_GetFuncDef() doc (#112647)

gh-106560: Fix redundant declarations in Python/frozen.c (#112612)

Avoid duplicated declarations of "extern" functions in
Python/frozen.c.

Compiler warnings seen by building Python with gcc -Wredundant-decls.

gh-106560: Fix redundant declarations in Include/ (#112611)

Don't declare PyBool_Type, PyLong_Type and PySys_Audit() twice, but
only once.

Compiler warnings seen by building Python with gcc -Wredundant-decls.

gh-112578: Fix RuntimeWarning when running zipfile (GH-112579)

gh-112316: improve docs for `inspect.signature` and `inspect.Signature` (#112631)

gh-66819: More IDLE htest updates(2) (#112642)

Examine and update spec -- callable pairs.
Revise run method.

gh-112139: Add `inspect.Signature.format` and use it in `pydoc` (#112143)

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

Docs: Use sphinx-notfound-page to show a nicer 404 page (#111084)

gh-112618: Make `Annotated` cache typed (#112619)

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

gh-112316: Improve docs of `inspect.signature` and `Signature.from_callable` (#112317)

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

gh-106922: Support multi-line error locations in traceback (attempt 2) (#112097)

gh-112567: Add _PyTimeFraction C API (#112568)

Use a fraction internally in the _PyTime API to reduce the risk of
integer overflow: simplify the fraction using Greatest Common
Divisor (GCD). The fraction API is used by time functions:
perf_counter(), monotonic() and process_time().

For example, QueryPerformanceFrequency() usually returns 10 MHz on
Windows 10 and newer. The fraction SEC_TO_NS / frequency =
1_000_000_000 / 10_000_000 can be simplified to 100 / 1.

* Add _PyTimeFraction type.
* Add functions:

  * _PyTimeFraction_Set()
  * _PyTimeFraction_Mul()
  * _PyTimeFraction_Resolution()

* No longer check "numer * denom <= _PyTime_MAX" in
  _PyTimeFraction_Set(). _PyTimeFraction_Mul() uses _PyTime_Mul()
  which handles integer overflow.

gh-112567: Add _Py_GetTicksPerSecond() function (#112587)

* Move _PyRuntimeState.time to _posixstate.ticks_per_second and
  time_module_state.ticks_per_second.
* Add time_module_state.clocks_per_second.
* Rename _PyTime_GetClockWithInfo() to py_clock().
* Rename _PyTime_GetProcessTimeWithInfo() to py_process_time().
* Add process_time_times() helper function, called by
  py_process_time().
* os.times() is now always built: no longer rely on HAVE_TIMES.

gh-110481: Fix typo in Py_SET_REFCNT() (#112595)

bpo-37013: Fix the error handling in socket.if_indextoname() (GH-13503)

* Fix a crash when pass UINT_MAX.
* Fix an integer overflow on 64-bit non-Windows platforms.

gh-109413: libregrtest: enable mypy's `--strict-optional` check on most files (#112586)

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

gh-110481: Fix Py_SET_REFCNT() integer overflow (#112174)

If Py_NOGIL is defined and Py_SET_REFCNT() is called with a reference
count larger than UINT32_MAX, make the object immortal.

Set _Py_IMMORTAL_REFCNT constant type to Py_ssize_t to fix the
following compiler warning:

Include/internal/pycore_global_objects_fini_generated.h:14:24:
warning: comparison of integers of different signs: 'Py_ssize_t'
(aka 'long') and 'unsigned int' [-Wsign-compare]

    if (Py_REFCNT(obj) < _Py_IMMORTAL_REFCNT) {
        ~~~~~~~~~~~~~~ ^ ~~~~~~~~~~~~~~~~~~~

gh-112510: Add `readline.backend` for the backend readline uses (GH-112511)

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

gh-109413: regrtest: add WorkerRunTests class (#112588)

gh-82565: Add tests for pickle and unpickle with bad files (GH-16606)

gh-112367: Only free perf trampoline arenas at shutdown (#112368)

Signed-off-by: Pablo Galindo <pablogsal@gmail.com>

gh-111058: Change coro.cr_frame/gen.gi_frame to be None for a closed coroutine/generator. (#112428)

bpo-39912: Raise appropriate exceptions in filterwarnings() and simplefilter() (GH-18878)

build(deps): bump hypothesis from 6.88.1 to 6.91.0 in /Tools (#112580)

Bumps [hypothesis](https://github.com/HypothesisWorks/hypothesis) from 6.88.1 to 6.91.0.
- [Release notes](https://github.com/HypothesisWorks/hypothesis/releases)
- [Commits](https://github.com/HypothesisWorks/hypothesis/compare/hypothesis-python-6.88.1...hypothesis-python-6.91.0)

---
updated-dependencies:
- dependency-name: hypothesis
  dependency-type: direct:production
  update-type: version-update:semver-minor
...

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

build(deps): bump actions/github-script from 6 to 7 (#112584)

Bumps [actions/github-script](https://github.com/actions/github-script) from 6 to 7.
- [Release notes](https://github.com/actions/github-script/releases)
- [Commits](https://github.com/actions/github-script/compare/v6...v7)

---
updated-dependencies:
- dependency-name: actions/github-script
  dependency-type: direct:production
  update-type: version-update:semver-major
...

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

Fix typos in variable names, function names, and comments (GH-101868)

build(deps-dev): bump types-setuptools from 68.2.0.0 to 69.0.0.0 in /Tools (#112582)

build(deps-dev): bump types-setuptools in /Tools

Bumps [types-setuptools](https://github.com/python/typeshed) from 68.2.0.0 to 69.0.0.0.
- [Commits](https://github.com/python/typeshed/commits)

---
updated-dependencies:
- dependency-name: types-setuptools
  dependency-type: direct:development
  update-type: version-update:semver-major
...

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

build(deps-dev): bump mypy from 1.7.0 to 1.7.1 in /Tools (#112581)

Bumps [mypy](https://github.com/python/mypy) from 1.7.0 to 1.7.1.
- [Changelog](https://github.com/python/mypy/blob/master/CHANGELOG.md)
- [Commits](https://github.com/python/mypy/compare/v1.7.0...v1.7.1)

---
updated-dependencies:
- dependency-name: mypy
  dependency-type: direct:development
  update-type: version-update:semver-patch
...

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

Add links under "generator expression" in glossary (#112537)

gh-66819: More IDLE htest updates (#112574)

Revise htest.py docstring and move 2 specs to alphabetical position.

gh-112205: Update stringio module to use AC for the thread-safe (gh-112549)

gh-109413: Run mypy on `libregrtest` in CI (#112558)

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

Clarify a comment for `test.support.Py_C_RECURSION_LIMIT` to point out where a value came from but that it doesn't need to stay in sync (#112224)

gh-112502: Docs: Improve docs for gc.collect method (#112562)

* Docs: Improve docs for gc.collect method

* Update gc.rst

Clarify that WASI tool requirements are included in the devcontainer (GH-112561)

gh-104231: Add more tests for str(), repr(), ascii(), and bytes() (GH-112551)

gh-111699: Move smtpd note to dedicated section in What's New Python 3.12 doc (GH-112544)

Relocate smtpd deprecation notice to it's own section rather than under
'locale' in docs for What's New in Python 3.12 doc

gh-112519: Make it possible to specify instruction flags for pseudo instructions in bytecodes.c (#112520)

gh-112205: Support @getter annotation from AC (gh-112396)

gh-111972: Make Unicode name C APIcapsule initialization thread-safe (#112249)

IDLE: fix config_key htest (#112545)

Change 'Dialog' to 'Window' in two places to match the name of the config_key class being tested.

GH-103065, GH-106704, GH-105253: Provide a `Tools/wasm/wasi.py` script to simplify doing a WASI build (GH-112473)

gh-104003: Implement PEP 702 (#104004)

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

gh-112509: Fix keys being present in both required_keys and optional_keys in TypedDict (#112512)

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

Add more C API tests (GH-112522)

Add tests for PyObject_Str(), PyObject_Repr(), PyObject_ASCII() and
PyObject_Bytes().

[Enum] update class creation for RuntimeError changes (GH-111815)

Rename ...Uop... to ...UOp... (uppercase O) for consistency (#112327)

* Rename _PyUopExecute to _PyUOpExecute (uppercase O) for consistency
* Also rename _PyUopName and _PyUOp_Replacements, and some output strings

gh-112454: Disable TLS-PSK if OpenSSL was built without PSK support (#112491)

If OpenSSL was built without PSK support, the python TLS-PSK
methods will raise "NotImplementedError" if called.

Add a constant "ssl.HAS_PSK" to check if TLS-PSK is supported

GH-112245: Promote free threaded CI (#112246)

gh-110930: Correct book title by Alan D. Moore (#112490)

gh-112431: Unconditionally call `hash -r` (GH-112432)

The `activate` script calls `hash -r` in two places to make sure the shell picks
up the environment changes the script makes. Before that, it checks to
see if the shell running the script is bash or zsh.

`hash -r` is specified by POSIX and is not exclusive to bash and zsh.
This guard prevents the script from calling `hash -r` in other
`#!/bin/sh`-compatible shells like dash.

gh-109802: Increase test coverage for complexobject.c (GH-112452)

gh-112332: Deprecate TracebackException.exc_type, add exc_type_str. (#112333)

gh-112105: Make completer delims work on libedit (gh-112106)

gh-112071: Make `_random.Random` methods thread-safe in `--disable-gil` builds (gh-112128)

Co-authored-by: Donghee Na <donghee.na@python.org>

gh-112292 : Catch import error conditions with readline hooks (gh-112313)

Prevents a segmentation fault in registered hooks for the readline library, but only when the readline module is loaded inside an isolated sub interpreter.  The module is single-phase init so loading it fails, but not until the module init function has already run, where the readline hooks get registered.

The readlinestate_global macro was error-prone to PyImport_FindModule returning NULL and crashing in about 18 places.  I could reproduce 1 easily, but this PR replaces the macro with a function and adds error conditions to the other functions.

Docs: fix markup for `importlib.machinery.NamespaceLoader` (#112479)

gh-112414: Add additional unit tests for calling `repr()` on a namespace package (#112475)

Co-authored-by: Eric Snow <ericsnowcurrently@gmail.com>

Correct documentation for AF_PACKET (#112339)

Protocol in the address tuple should *not* be in the network-byte-order, because it is converted internally[1].

[1] https://github.com/python/cpython/blob/89ddea4886942b0c27a778a0ad3f0d5ac5f518f0/Modules/socketmodule.c#L2144

network byte order doesn't make sense for a python level int anyways. It's a fixed size C serialization concept.

gh-99367: Do not mangle sys.path[0] in pdb if safe_path is set (#111762)

Co-authored-by: Christian Walther <cwalther@users.noreply.github.com>

gh-112217: Add check to call result for `do_raise()` where cause is a type. (#112216)

gh-68166: Add support of "vsapi" in ttk.Style.element_create() (GH-111393)

gh-112387: Fix error positions for decoded strings with backwards tokenize errors (#112409)

Signed-off-by: Pablo Galindo <pablogsal@gmail.com>

gh-112388: Fix an error that was causing the parser to try to overwrite tokenizer errors (#112410)

Signed-off-by: Pablo Galindo <pablogsal@gmail.com>

bpo-41422: Visit the Pickler's and Unpickler's memo in tp_traverse (GH-21664)

Co-authored-by: Serhiy Storchaka <storchaka@gmail.com>

gh-76912: Raise OSError from any failure in getpass.getuser() (#29739)

* bpo-32731: Raise OSError from any failure in getpass.getuser()
Previously, if the username was not set in certain environment variables, ImportError escaped on Windows systems, and it was possible for KeyError to escape on other systems if getpwuid() failed.

gh-111789: Use PyDict_GetItemRef() in Python/_warnings.c (gh-112080)

gh-111789: Use PyDict_GetItemRef() in Python/symtable.c (gh-112084)

gh-111789: Use PyDict_GetItemRef() in Python/codecs.c (gh-112082)

gh-111789: Use PyDict_GetItemRef() in Python/bltinmodule.c (gh-112081)

gh-111789: Use PyDict_GetItemRef() in Modules/pyexpat.c (gh-112079)

gh-111789: Use PyDict_GetItemRef() in Modules/_threadmodule.c (gh-112077)

gh-111789: Use PyDict_GetItemRef() in Modules/_struct.c (gh-112076)

gh-111789: Use PyDict_GetItemRef() in Modules/_csv.c (gh-112073)

gh-112438: Fix support of format units with the "e" prefix in nested tuples in PyArg_Parse (gh-112439)

gh-84443: SSLSocket.recv_into() now support buffer protocol with itemsize != 1 (GH-20310)

It is also no longer use __len__().

Co-authored-by: Serhiy Storchaka <storchaka@gmail.com>

gh-111874: Call `__set_name__` on objects that define the method inside a `typing.NamedTuple` class dictionary as part of the creation of that class (#111876)

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

GH-101100: Fix reference warnings for ``socket`` methods (#110114)

Co-authored-by: Serhiy Storchaka <storchaka@gmail.com>

Move What's New In Python 3.12 entries to the right section (#112447)

Jython and ctypes removals are unrelated to C API Removals.

gh-111147: Fix `test_set_of_sets_reprs` in `test_pprint` (GH-111148)

Make it stable and not depending on implementation details.

Docs: fix typo in doc for sqlite3.Cursor.execute (#112442)

gh-112414: Fix `AttributeError` when calling `repr()` on a namespace package imported with a custom loader (#112425)

gh-63284: Add support for TLS-PSK (pre-shared key) to the ssl module (#103181)

Add support for TLS-PSK (pre-shared key) to the ssl module.

---------

Co-authored-by: Oleg Iarygin <oleg@arhadthedev.net>
Co-authored-by: Gregory P. Smith <greg@krypto.org>

gh-99606: Make code generated for an empty f-string identical to that of a normal empty string (#112407)

gh-112405: Optimise `pathlib.Path.relative_to` (#112406)

gh-112358: Fix Python 3.12 regression with subclassing struct.Struct. (#112424)

Revert commit c8c0afc7137ab9f22bf59d591084948ca967c97c (PR #94532),
which moved `struct.Struct` initialisation from `Struct.__init__` to `Struct.__new__`.
This caused issues with code in the wild that subclasses `struct.Struct`.

gh-101100: Fix Sphinx reference warnings (GH-112416)

* Fix Sphinx warning in library/xml.rst

Direct use of the pyexpat module is deprecated, but this is how to check the version for security purposes

* Fix Sphinx warning in library/importlib.resources.rst

* Use italics for parameters

* Link to the exception

* Fix Sphinx warning in library/gzip.rst

* Document message and header defect base classes to fix Sphinx warning in library/email.headerregistry.rst

* Restore feed_eof() doc to fix Sphinx warning in library/asyncio-stream.rst

* Fix Sphinx warning in extending/newtypes.rst

* Fix Sphinx warning in c-api/set.rst

On stdtypes.rst, set and frozenset are documented together and the frozenset has the working refs

gh-112331: Fix reference manual description of attribute lookup mechanics (gh-112375)

Descriptor HowTo:  Sync the error-messages with the C code. Add tests. (gh-112403)

gh-101100 : Fix Sphinx warnings in `library/doctest.rst` (#112399)

* Fix Sphinx warnings in library/doctest.rst

* Don't link to self, and wrap a line

Co-authored-by: Alex Waygood <Alex.Waygood@Gmail.com>
* Link to load_tests protocol

* Link to option flags

* Wrap line

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

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

GH-77621: Delay some imports from pathlib (#112244)

Import `contextlib`, `glob` and `re` only as required.

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

gh-94722: fix DocTest.__eq__ for case of no line number on one side (#112385)

GH-112361: Speed up pathlib by removing some temporary objects. (#112362)

Construct only one new list object (using `list.copy()`) when creating a
new path object with a modified tail. This slightly speeds up
`with_name()` and `with_suffix()`

gh-101100: Define `_tkinter` module to fix references (#112382)

Define _tkinter module to fix references

gh-101100: Define `test.regrtest` module to fix references (#112381)

Define test.regrtest module to fix references