gh-106320: Remove _PyOS_ReadlineTState API (#107034)

Remove _PyOS_ReadlineTState variable from the public C API.
The symbol is still exported for the readline shared extension.

gh-105090: Replace incorrect TLSv1.2 with TLSv1.3 (#105404)

gh-106320: Move private _PyGen API to the internal C API (#107032)

Move private _PyGen API to internal C API:

* _PyAsyncGenAThrow_Type
* _PyAsyncGenWrappedValue_Type
* _PyCoroWrapper_Type
* _PyGen_FetchStopIterationValue()
* _PyGen_Finalize()
* _PyGen_SetStopIterationValue()

No longer these symbols, except of the ones by the _asyncio shared
extensions.

gh-106320: Move _PyNone_Type to the internal C API (#107030)

Move private types _PyNone_Type and _PyNotImplemented_Type to
internal C API.

gh-106320: Move private _PyHash API to the internal C API (#107026)

* No longer export most private _PyHash symbols, only export the ones
  which are needed by shared extensions.
* Modules/_xxtestfuzz/fuzzer.c now uses the internal C API.

gh-106320: Document private C API removal in What's New 3.13 (#107027)

gh-69714: Make `calendar` module fully tested (#93655)

There are 3 paths to use `locale` argument in
`calendar.Locale{Text|HTML}Calendar.__init__(..., locale=None)`:
(1) `locale=None` -- denotes the "default locale"[1]
(2) `locale=""` -- denotes the native environment
(3) `locale=other_valid_locale` -- denotes a custom locale

So far case (2) is covered and case (1) is in 78935daf5a (same branch).
This commit adds a remaining case (3).

[1] In the current implementation, this translates into the following
approach:

GET current locale
IF current locale == "C" THEN
  SET current locale TO ""
  GET current locale
ENDIF

* Remove unreachable code (and increase test coverage)

This condition cannot be true. `_locale.setlocale()` from the C module
raises `locale.Error` instead of returning `None` for
`different_locale.__enter__` (where `self.oldlocale` is set).

* Expand the try clause to calls to `LocaleTextCalendar.formatmonthname()`.

This method temporarily changes the current locale to the given locale,
so `_locale.setlocale()` may raise `local.Error`.

Co-authored-by: Rohit Mediratta <rohitm@gmail.com>
Co-authored-by: Jessica McKellar <jesstess@mit.edu>
Co-authored-by: Adam Turner <9087854+AA-Turner@users.noreply.github.com>
Co-authored-by: Irit Katriel <1055913+iritkatriel@users.noreply.github.com>

gh-106320: Remove private _PyUnicode_AsString() alias (#107021)

Remove private _PyUnicode_AsString() alias to PyUnicode_AsUTF8(). It
was kept for backward compatibility with Python 3.0 - 3.2.

The PyUnicode_AsUTF8() is available since Python
3.3. The PyUnicode_AsUTF8String() function can be used to keep
compatibility with Python 3.2 and older.

gh-106989: Remove tok report warnings (#106993)

gh-105699: Add some stress tests for subinterpreter creation (#106966)

Reformat code block to make it easier to read (#106965)

gh-106714: Fix test_capi to not write a coredump (#107007)

test_capi: Fix test_no_FatalError_infinite_loop() to no longer write
a coredump, by using test.support.SuppressCrashReport.

gh-106969: Indicate no modules were added in 3.10 & 3.12 (#106988)

The "New Modules" section was left in place to ensure that the anchor
link for new modules will still exist:

/whatsnew/3.12.html#new-modules
/whatsnew/3.10.html#new-modules

This means that existing links to this section don't break.

gh-104050: Argument Clinic: Annotate the BufferSeries class (#106935)

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

gh-106996: Amend the introduction to the turtle graphics documentation (#106997)

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

gh-106978: Bump sphinx-lint to 0.6.8 (#106990)

gh-106368: Increase coverage for Argument Clinic output directive (#106979)

gh-106976:alphabetise bullets by module name task1 (#106982)

gh-106973: Change non-integral to non-integer in "3.12 What's New" (#106984)

gh-101100: Docs: Check Sphinx warnings and fail if improved (#106460)

gh-106970: Fix Argument Clinic 'destination <name> clear' command (#106972)

Add test for the 'destination <name> clear' command,
and the 'destination' directive in general.

Fix two bugs in 'destination <name> clear' command:

1. The text attribute of the allocator is called 'text', not '_text'
2. Return after processing the 'clear' command,
   instead of proceeding directly to the fail().

gh-96663: Add a better error message for __dict__-less classes setattr (#103232)

gh-106004: Add PyDict_GetItemRef() function (#106005)

* Add PyDict_GetItemRef() and PyDict_GetItemStringRef() functions.
  Add these functions to the stable ABI version 3.13.
* Add unit tests on the PyDict C API in test_capi.

gh-105699: Fix a Crasher Related to a Deprecated Global Variable (gh-106923)

There was a slight race in _Py_ClearFileSystemEncoding() (when called from _Py_SetFileSystemEncoding()), between freeing the value and setting the variable to NULL, which occasionally caused crashes when multiple isolated interpreters were used.  (Notably, I saw at least 10 different, seemingly unrelated spooky-action-at-a-distance, ways this crashed. Yay, free threading!)  We avoid the problem by only setting the global variables with the main interpreter (i.e. runtime init).

gh-105699: Fix an Interned Strings Crasher (gh-106930)

A static (process-global) str object must only have its "interned" state cleared when no longer interned in any interpreters.  They are the only ones that can be shared by interpreters so we don't have to worry about any other str objects.

We trigger clearing the state with the main interpreter, since no other interpreters may exist at that point and _PyUnicode_ClearInterned() is only called during interpreter finalization.

We do not address here the fact that a string will only be interned in the first interpreter that interns it.  In any subsequent interpreters str.state.interned is already set so _PyUnicode_InternInPlace() will skip it.  That needs to be addressed separately from fixing the crasher.

gh-106847: Add -X warn_default_encoding in sys.flags Doc (#106854)

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

gh-106909: Use role :const: for referencing module constants (GH-106910)

gh-106892: Use roles :data: and :const: for referencing module variables (GH-106894)

gh-47146: Fix reference counting in _testcapi.structmember initializer (GH-106862)

gh-106919: Use role :c:macro: for referencing the C "constants" (GH-106920)

Docs: Argument Clinic: Add Background and Tutorial top-level sections (#106904)

Add Background as a toplevel section with the following subsections:

- Background
  - The goals of Argument Clinic
  - Basic concepts and usage

Rename "Converting your first function" to Tutorial.

Add anchors for Background, Tutorial, and How-to Guides:

- :ref:`clinic-background`
- :ref:`clinic-tutorial`
- :ref:`clinic-howtos`

Link to these from within the Abstract.

Break the compatibility paragraph out of Abstract and make it a note.

Co-authored-by: Ezio Melotti <ezio.melotti@gmail.com>

gh-106368: Increase Argument Clinic test coverage for IndentStack (#106933)

gh-106916: Add missing error check _PyCompile_CleanDoc (#106921)

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

gh-106669: Revert "gh-102988: Detect email address parsing errors ... (#105127)" (#106733)

This reverts commit 18dfbd035775c15533d13a98e56b1d2bf5c65f00.
Adds a regression test from the issue.

See https://github.com/python/cpython/issues/106669.

gh-104050: Argument Clinic: Annotate the IndentStack class (#106934)

gh-105540: Show source files relative to root (#106927)

This restores a corner case: when the generator is run with working directory set to Tools/cases_generator, the source filenames listed in the generated provenance header should be relative to the repo root directory.

Fix typo in tkinter docs (#106936)

Signed-off-by: Makonede <61922615+Makonede@users.noreply.github.com>

gh-104050: Argument Clinic: Increase CConverter typing coverage (#106932)

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

gh-104050: Argument Clinic: Annotate CLanguage.render_option_group_parsing() (#106929)

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

GH-106701: Move _PyUopExecute to Python/executor.c (GH-106924)

gh-105481: do not auto-generate pycore_intrinsics.h (#106913)

GH-104584: Miscellaneous fixes for -Xuops (GH-106908)

Fix typo in 3.11.4 changelog: urllib.request.Requst -> Request (#106830)

gh-106078: Prepare to isolate decimal module (#106880)

* move signal_map to global_state

* move cond_map to global_state

gh-102799: use sys.exception() instead of sys.exc_info() in contextlib (#103311)

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

gh-106751: Optimize _PolllikeSelector for many iteration case (gh-106884)

gh-106882: Note that `asyncio.Server` is only publicly exposed on 3.11+ (#106901)

And later versions of 3.10, 3.9

GH-100502: Add `pathlib.PurePath.pathmod` attribute (GH-106533)

This instance attribute stores the implementation of `os.path` used for
low-level path operations: either `posixpath` or `ntpath`.

Export _PyEval_SetProfile() as a function, not data (#106887)

gh-104090: Fix unittest collectedDurations resources leak (#106795)

gh-106751: Optimize SelectSelector.select() for many iteration case (gh-106879)

gh-106751: Optimize KqueueSelector.select() for many iteration case (gh-106864)

gh-106727: Make `inspect.getsource` smarter for class for same name definitions (#106815)

Docs: Argument Clinic: Group guides about default values (#106872)

Previous ToC layout (excerpt):

    - How to use symbolic default values
    ...
    - How to assign default values to parameter
      - How to use the ``NULL`` default value
      - How to use expressions as default values

New layout:

    - How to assign default values to parameter
      - The ``NULL`` default value
      - Symbolic default values
      - Expressions as default values

gh-86493: Use PyModule_Add() instead of PyModule_AddObjectRef() (GH-106860)

gh-105481: Generate the opcode lists in dis from data extracted from bytecodes.c (#106758)

gh-106535: Document soft deprecations in What's New In Python 3.13 (#106859)

gh-106751: selectors: optimize EpollSelector.select() (#106754)

Co-authored-by: Pieter Eendebak <pieter.eendebak@gmail.com>

Docs: Normalise Argument Clinic advanced topics headings (#106842)

Co-authored-by: Ezio Melotti <ezio.melotti@gmail.com>

gh-86493: Fix possible leaks in some modules initialization (GH-106768)

Fix _ssl, _stat, _testinternalcapi, _threadmodule, cmath, math, posix, time.

bpo-42327: C API: Add PyModule_Add() function (GH-23443)

It is a fixed implementation of PyModule_AddObject() which consistently
steals reference both on success and on failure.

gh-86493: Fix possible leaks in modules initialization: _curses_panel, _decimal, posix, xxsubtype (GH-106767)

gh-106719: Fix __annotations__ getter and setter in the type and module types (GH-106720)

No longer suppress arbitrary errors. Simplify the code.

gh-106843: fix memleak in _PyCompile_CleanDoc (#106846)

Small fixes to code generator (#106845)

These repair nits I found in PR gh-106798 (issue gh-106797) and in PR gh-106716 (issue gh-106706).

gh-104683: Argument Clinic: Modernise parse_special_symbol() (#106837)

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

Add Erlend as CODEOWNER for Argument Clinic docs (#106840)

gh-106368: Increase Argument Clinic test coverage for cpp.Monitor (#106833)

gh-106831: Fix NULL check of d2i_SSL_SESSION() result in _ssl.c (#106832)

gh-106603: Make uop struct a triple (opcode, oparg, operand) (#106794)

gh-61215: threadingmock: Improve test suite to avoid race conditions (#106822)

threadingmock: Improve test suite to avoid race conditions

Simplify tests and split them into multiple tests to prevent assertions
from triggering race conditions.
Additionally, we rely on calling the mocks without delay to validate the
functionality of matching calls.

gh-106581: Add 10 new opcodes by allowing `assert(kwnames == NULL)` (#106707)

By turning `assert(kwnames == NULL)` into a macro that is not in the "forbidden" list, many instructions that formerly were skipped because they contained such an assert (but no other mention of `kwnames`) are now supported in Tier 2. This covers 10 instructions in total (all specializations of `CALL` that invoke some C code):
- `CALL_NO_KW_TYPE_1`
- `CALL_NO_KW_STR_1`
- `CALL_NO_KW_TUPLE_1`
- `CALL_NO_KW_BUILTIN_O`
- `CALL_NO_KW_BUILTIN_FAST`
- `CALL_NO_KW_LEN`
- `CALL_NO_KW_ISINSTANCE`
- `CALL_NO_KW_METHOD_DESCRIPTOR_O`
- `CALL_NO_KW_METHOD_DESCRIPTOR_NOARGS`
- `CALL_NO_KW_METHOD_DESCRIPTOR_FAST`

gh-106529: Generate uops for POP_JUMP_IF_[NOT_]NONE (#106796)

These aren't automatically translated because (ironically)
they are macros deferring to POP_JUMP_IF_{TRUE,FALSE},
which are not viable uops (being manually translated).

The hack is that we emit IS_NONE and then set opcode and
jump to the POP_JUMP_IF_{TRUE,FALSE} translation code.

gh-106687: _ssl: use uint64_t for SSL options (#106700)

SSL_CTX_get_options() uses uint64_t for options:
https://www.openssl.org/docs/man3.1/man3/SSL_CTX_get_options.html

Fix this compiler warning on Windows with MSC:

    conversion from 'uint64_t' to 'long', possible loss of data

gh-104050: Improve Argument Clinic type annotation coverage (#106810)

Add various missing annotations in the following classes:
- BlockPrinter
- CConverter
- CLanguage
- FormatCounterFormatter
- Language
- _TextAccumulator

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

gh-106789: avoid importing pprint from sysconfig (#106790)

gh-106780: Add __match_args__ to tutorial example (#106784)

Add Point definition with this attribute before example
that needs it.

Add more recipe tests. Make the factor recipe a bit faster and clearer. (GH-106817)

gh-106797: Remove warning logs from Python/generated_cases.c.h (gh-106798)

gh-104050: Argument Clinic: Annotate Clinic.parse() (#106760)

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

gh-105540: Convert `pytest` tests of `cases_generator` to regular tests (#106713)

Fix the french used in the email documentation (GH-106279)

* Fix the french used in the email documentation

The french used in one of the example was either machine translated a while ago or written by someone who does not speak french. Fixed it by using grammatically correct french.

gh-105726: Add `__slots__` to `AbstractContextManager` and `AbstractAsyncContextManager` (#106771)

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

gh-106706: Streamline family syntax in cases generator DSL (#106716)

From `family(opname, STRUCTSIZE) = OPNAME + SPEC1 + ... +  SPECn;`
to `family(OPNAME, STRUCTSIZE) = SPEC1 + ... + SPECn;`

Doc: fix section levels of devmode doc (#106801)

Doc: devmode: add -Xdev option to example (#106253)

Docs search: Replace jQuery with vanilla JavaScript (#106743)

* Replace jQuery with vanilla JavaScript
* Switch 'var' to 'const' or 'let'

Docs: Normalize Argument Clinic How-To section capitalization (#106788)

faq/library: remove outdated section (#105996)

Add more examples to the recipe docs (GH-106782)

Demonstrate that factor() works for large composites and large primes.

gh-106752: Sync with zipp 3.16.2 (#106757)

* gh-106752: Sync with zipp 3.16.2

* Add blurb

gh-81283: compiler: remove indent from docstring (#106411)

Co-authored-by: Éric <merwok@netwok.org>

gh-104050: Argument Clinic: Annotate BlockParser (#106750)

gh-106368: Increase Argument Clinic BlockParser test coverage (#106759)

gh-106529: Fix subtle Tier 2 edge case with list iterator (#106756)

The Tier 2 opcode _IS_ITER_EXHAUSTED_LIST (and _TUPLE)
didn't set it->it_seq to NULL, causing a subtle bug
that resulted in test_exhausted_iterator in list_tests.py
to fail when running all tests with -Xuops.

The bug was introduced in gh-106696.

Added this as an explicit test.

Also fixed the dependencies for ceval.o -- it depends on executor_cases.c.h.

gh-106752: Move zipfile._path into its own package (#106753)

* gh-106752: Move zipfile._path into its own package so it may have supplementary behavior.

* Add blurb

gh-102799: replace internal sys.exc_info() call by sys.exception() (#106746)

gh-106745: typing docs: Clarify that removal of PEP-585 aliases is not currently planned (#106748)

gh-106554: replace `_BaseSelectorImpl._key_from_fd` with `dict.get` (#106555)

gh-105481: expose opcode metadata via the _opcode module (#106688)