gh-118079: Fix ``requires_singlephase_init`` helper (#118081)

Before this PR tests decorated with a `requires_singlephase_init` helper
did not run because of an incorrect call to the `requires_gil_enabled`
helper.

gh-114053: Fix bad interaction of PEP-695, PEP-563 and ``get_type_hints`` (#118009)

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

gh-116931: Add fileobj parameter check for Tarfile.addfile (GH-117988)

Tarfile.addfile now throws an ValueError when the user passes
in a non-zero size tarinfo but does not provide a fileobj,
instead of writing an incomplete entry.

setobject: remove out of date docstring info (GH-118048)

gh-88035: update doc-string of `epoch` in timemodule.c (GH-118076)

Follow #88035, update doc-string of epoch in timemodule.c

The epoch is `January 1st, 1970 on all platforms`, according to
current documentation.

gh-115775: Add whatsnew entry about __static_attributes__ (GH-117909)

Co-authored-by: Kirill Podoprigora <kirill.bast9@mail.ru>
Co-authored-by: Petr Viktorin <encukou@gmail.com>
Co-authored-by: Jelle Zijlstra <jelle.zijlstra@gmail.com>

gh-116935: Document that heap types need to support garbage collection (GH-118021)

gh-117518: Clarify PyTuple_GetItem() borrowed reference in the doc (GH-117920)

GH-116202: Incorporate invalidation check into _START_EXECUTOR. (GH-118044)

GH-115419: Improve list of escaping functions (GH-118054)

gh-64588: Clarify the difference between mu and xbar in statistics docs (#117333)

Thanks Davin Potts for the clarification idea.

build(deps): bump hypothesis from 6.98.15 to 6.100.0 in /Tools (#117416)

Bumps [hypothesis](https://github.com/HypothesisWorks/hypothesis) from 6.98.15 to 6.100.0.
- [Release notes](https://github.com/HypothesisWorks/hypothesis/releases)
- [Commits](https://github.com/HypothesisWorks/hypothesis/compare/hypothesis-python-6.98.15...hypothesis-python-6.100.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>

Docs: Fix CVE link (#118077)

gh-117535: Change unknown filename of warnings from `sys` to `<sys>` (#118018)

Use "Contributed by" in a couple of occurrences of 3.12 whatsnew (#118070)

gh-112069: Make PySet_GET_SIZE to be atomic safe. (gh-118053)

gh-112069: Make PySet_GET_SIZE to be atomic operation

gh-102402: Fix logging test_relativeCreated_has_higher_precision() leak (#117985)

Fix a reference leak in test_relativeCreated_has_higher_precision()
of test_logging: don't reimport the logging the logging module.

gh-117503: Fix test for posixpath.expanduser() when pw_dir ends with / (GH-118056)

gh-112069:  Add _PySet_NextEntryRef to be thread-safe. (gh-117990)

GH-118036: Fix a bug with CALL_STAT_INC (#117933)

We were under-counting calls in `_PyEvalFramePushAndInit`
because the `CALL_STAT_INC` macro was redefined to a no-op
for the Tier 2 interpreter. The fix is not to `#undef` it at all.
This results in ~37% more "Frames pushed" reported
under "Call stats".

gh-87969: Align docs and docstrings with implementation for ctypes' [w]string_at() (#25384)

The implementation uses 'ptr' for the name of the first parameter of
ctypes.string_at() and ctypes.wstring_at(). Align docs and docstrings
with the naming used in the implementation.

Co-authored-by: Irit Katriel <1055913+iritkatriel@users.noreply.github.com>
Co-authored-by: Erlend E. Aasland <erlend.aasland@protonmail.com>

gh-117987: Restore several functions removed in Python 3.13 alpha 1 (GH-117993)

Restore these functions removed in Python 3.13 alpha 1:

* Py_SetPythonHome()
* Py_SetProgramName()
* PySys_SetArgvEx()
* PySys_SetArgv()

gh-116932: Remove redundant NEWS entry (#118040)

GH-115419: Tidy up tier 2 optimizer. Merge peephole pass into main pass (GH-117997)

gh-90815: Document bundled mimalloc in What’s New In Python 3.13 (GH-117811)

fix formatting of literal in docstring of int.from_bytes and int.to_bytes (#117847)

gh-116932: Add note on how to report python documentation theme bugs (GH-117989)

Fix two typos in `typeobject.c` (#118024)

gh-118023: Fix reference leak (#118025)

gh-117641: Improve the perfornance of posixpath.commonpath() (#117652)

gh-117968: Add tests for the part of the PyRun family of the C API (GH-117982)

Co-authored-by: NGRsoftlab <78017794+NGRsoftlab@users.noreply.github.com>
Co-authored-by: Erlend E. Aasland <erlend.aasland@protonmail.com>

gh-117613: Argument Clinic: disallow defining class parameter at module level (#117950)

gh-114539: Clarify implicit launching of shells by subprocess (GH-117996)

gh-94673: Fix compiler warning in typeobject.c (#117980)

gh-117657: Quiet erroneous TSAN reports of data races in `_PySeqLock` (#117955)

Quiet erroneous TSAN reports of data races in `_PySeqLock`

TSAN reports a couple of data races between the compare/exchange in
`_PySeqLock_LockWrite` and the non-atomic loads in `_PySeqLock_{Abandon,Unlock}Write`.
This is another instance of TSAN incorrectly modeling failed compare/exchange
as a write instead of a load.

gh-117657: Fix data races in the method cache in free-threaded builds (#117954)

Fix data races in the method cache in free-threaded builds

These are technically data races, but I think they're benign (to
the extent that that is actually possible). We update cache entries
non-atomically but read them atomically from another thread, and there's
nothing that establishes a happens-before relationship between the
reads and writes that I can see.

gh-80361: Fix TypeError in email.Message.get_payload() (GH-117994)

It was raised when the charset is rfc2231 encoded, e.g.:

   Content-Type: text/plain; charset*=ansi-x3.4-1968''utf-8

gh-117680: make _PyInstructionSequence a PyObject and use it in tests (#117629)

Doc: Render version/language selector on Read the Docs (#116966)

gh-117977: Amend version changed annotation for os.chmod, os.chown, and os.listdir (#117978)

GH-100242: bring functools.py partial implementation more in line with C code (GH-100244)

in partial.__new__, before checking for the existence of the attribute
'func', first check whether the argument is an instance of partial.

Test: Get the smtp test server using os.getenv() (#117979)

The smtp test server can be set via CPYTHON_TEST_SMTP_SERVER environment variable.
If not set, it uses the default value smtp.gmail.com
This is needed because the network I'm on filters access to
smtp.gmail.com resulting in a failing test.

Co-authored-by: Łukasz Langa <lukasz@langa.pl>

gh-117929: Restore removed PyEval_InitThreads() function (#117931)

gh-117975: Ensure flush level is checked when configuring a logging MemoryHandler. (GH-117976)

gh-115009: Update macOS installer to use SQLite 3.45.3 (#117443)

bpo-40944: Fix IndexError when parse emails with truncated Message-ID, address, routes, etc (GH-20790)

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

GH-117760: Streamline the trashcan mechanism (GH-117763)

gh-65824: Add "Help on ..." to the "less" prompt in pydoc (GH-116183)

gh-73231: Update documentation for PyErr_SetFromWindowsErr() (GH-117226)

gh-117313: Fix re-folding email messages containing non-standard line separators (GH-117369)

Only treat '\n', '\r' and '\r\n' as line separators in re-folding the email
messages.  Preserve control characters '\v', '\f', '\x1c', '\x1d' and '\x1e'
and Unicode line separators '\x85', '\u2028' and '\u2029' as is.

gh-117394: Speed up os.path.ismount() on Posix (GH-117447)

It is now 2-3 times faster if the user has permissions.

gh-117503: Fix support of non-ASCII user names in posixpath.expanduser() (GH-117504)

They are now supported in bytes paths as well as in string paths.

gh-117907: Fix test_inspect for the build with enabled tracing references (GH-117922)

gh-117879: Fix test_httpservers for the build with profiling (GH-117932)

gh-117845: Detect libedit hook function signature in configure (#117870)

Older libedit versions (like Apple's) use a different type signature
for rl_startup_hook and rl_pre_input_hook. Add a configure check to
determine which signature is accepted by introducing the
Py_RL_STARTUP_HOOK_TAKES_ARGS macro in pyconfig.h.

gh-86650: Fix IndexError when parse emails with invalid Message-ID (GH-117934)

In particularly, one-off addresses generated by Microsoft Outlook:
https://learn.microsoft.com/en-us/office/client-developer/outlook/mapi/one-off-addresses

Co-authored-by: fsc-eriker <72394365+fsc-eriker@users.noreply.github.com>

gh-75171: Fix parsing invalid email address headers starting or ending with a dot (GH-15600)

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

gh-117923: Catch ``test_webbrowser.test_parse_args_error`` stderr output (#117924)

gh-71966: Move the module docstring from _pydecimal to decimal (GH-117919)

Now it is set even if the C implementation is used.

Also add a one-line synopsis.

gh-117945: Fix `os.path.ismount()` documentation (#117947)

linecache: Fix docstring location (#117948)

gh-117501 put some code before the docstring, so now it is no longer
recognized as a docstring.

gh-112844: Fix xz CPE identifier (GH-117656)

gh-115009: Update Windows installer to use SQLite 3.45.3 (GH-117445)

gh-117645: Increase WASI stack size from 512 KiB to 8 MiB (#117674)

Increase also the initial memory from 10 MiB to 20 MiB.

Reenable test_dynamic on WASI build.

gh-117755: Fix mimalloc for huge allocation on s390x (#117809)

Fix mimalloc allocator for huge memory allocation (around
8,589,934,592 GiB) on s390x.

Abort allocation early in mimalloc if the number of slices doesn't
fit into uint32_t, to prevent a integer overflow (cast 64-bit
size_t to uint32_t).

gh-117755: Remove tests on huge memory allocations (#117938)

Remove unreliable tests on huge memory allocations:

* Remove test_maxcontext_exact_arith() of test_decimal.
  Stefan Krah, test author, agreed on removing the test:
  https://github.com/python/cpython/issues/114331#issuecomment-1925731273
* Remove test_constructor() tests of test_io.
  Sam Gross suggests remove them:
  https://github.com/python/cpython/pull/117809#pullrequestreview-2003889558

On Linux, depending how overcommit is configured, especially on Linux
s390x, a huge memory allocation (half or more of the full address
space) can succeed, but then the process will eat the full system
swap and make the system slower and slower until the whole system
becomes unusable.

Moreover, these tests had to be skipped when Python is built with
sanitizers.

gh-117376: Make code objects use deferred reference counting (#117823)

We want code objects to use deferred reference counting in the
free-threaded build. This requires them to be tracked by the GC, so we
set `Py_TPFLAGS_HAVE_GC` in the free-threaded build, but not the default
build.

gh-112069: Make setiter_iternext to be thread-safe (gh-117935)

Docs: Add classes to C API return value annotations (#117926)

Co-authored-by: Nikita Sobolev <mail@sobolevn.me>

gh-117683: Fix test_free_different_thread failures with GIL disabled (#117685)

gh-115178: Add Counts of UOp Pairs to pystats (GH-115181)

GH-115776: Static object are immortal, so mark them as such. (GH-117673)

gh-117691: Add an appropriate stacklevel for PEP-706 tarfile deprecation warnings (GH-117872)

gh-117613: Argument Clinic: ensure that 'defining_class' params are positional-only (#117781)

gh-102402: Fix floating point math issue by using `time.time_ns()` in `logging.LogRecord` (GH-102412)

gh-117797: Improve `test_descr.test_not_implemented` (#117798)

gh-117613: Enhance test_clinic @defining_class tests (#117896)

gh-77102: site: try utf-8 and fallback to locale encoding when reading .pth file (#117802)

gh-76785: Fix Windows Refleak in test_interpreters (gh-117913)

gh-117662 introduced some refleaks, or, rather, exposed some existing refleaks.  The leaks are coming when test.support.os_helper is imported in a "legacy" interpreter.  I've updated test.test_interpreters.utils to avoid importing os_helper, which fixes the leaks.  I'll address the root cause separately.

gh-117804: Document how to suppress PGO unprofiled source warnings (#117859)

Docs: add link roles with Sphinx extlinks (#117850)

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

gh-109975: Copyedit "What's New in Python 3.13" (#117902)

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

gh-117688: Fix deadlock in test_no_stale_references with GIL disabled (#117720)

Check `my_object_collected.wait()` in a loop to give the main thread a
chance to merge the reference count fields. Additionally, call
`my_object_collected.set()` in a background thread to avoid deadlocking
when the destructor is called asynchronously via the eval breaker
within the body of of `my_object_collected.wait()`.

Docs: make the `whatsnew-typing-py312` anchor point to things that were new in the typing module (#117904)

gh-117657: Quiet more TSAN warnings due to incorrect modeling of compare/exchange (#117830)

gh-117657: Quiet TSAN warning about a data race between `start_the_world()` and `tstate_try_attach()` (#117828)

TSAN erroneously reports a data race between the `_Py_atomic_compare_exchange_int`
on `tstate->state` in `tstate_try_attach()` and the non-atomic load of
`tstate->state` in `start_the_world`. The `_Py_atomic_compare_exchange_int` fails,
but TSAN erroneously treats it as a store.

gh-117657: Add TSAN suppressions for the free-threaded build (#117736)

Additionally, reduce the iterations for a few weakref tests that would
otherwise take a prohibitively long amount of time (> 1 hour) when TSAN
is enabled and the GIL is disabled.

gh-115532: Minor tweaks to kde() (gh-117897)

gh-115664: Reorganize versionadded directives for -X options (GH-116304)

Add the versionadded directives just under the description of the
corresponding option.

gh-112278: Improve error handling in wmi module and tests (GH-117818)

gh-90329: Add _winapi.GetLongPathName and GetShortPathName and use in venv to reduce warnings (GH-117817)

gh-117889: Fix PGO test in test_peg_generator (#117893)

Reuse support.check_cflags_pgo() in test_peg_generator to check for
PGO build.

Log PGO_PROF_USE_FLAG in test.pythoninfo.

GH-117750: When clearing object's dict, clear inline values but leave dict attached (GH-117808)

Add 'The Python 2.3 Method Resolution Order' (#116435)

gh-117694: Improve tests for PyEval_EvalCodeEx() (GH-117695)

gh-117755: Skip test_io.test_constructor() on s390x (#117801)

The test allocates 9 223 372 036 854 775 807 bytes
(0x7fffffffffffffff) and mimalloc fails with a division by zero on
s390x.

gh-117826: Remove lookdict_index from delitemif_lock_held (gh-117869)

docs: typo in 3.13 release notes (#117866)

gh-117636: Remove redundant type check in `os.path.join()` (#117638)

Doc: mark up classes, attributes, parameters, and methods in dataclasses.rst (#117820)