bpo-35753: Fix crash in doctest with unwrap-able functions (GH-22981) (#25926)

Ignore objects that inspect.unwrap throws due to
too many wrappers.  This is a very rare case, however
it can easily be surfaced when a module under doctest
imports unitest.mock.call into its namespace.

We simply skip any object that throws this exception.
This should handle the majority of cases.
(cherry picked from commit 565a31804c1139fe7886f38af3b3923653b0c1b3)

Co-authored-by: Alfred Perlstein <alfred@fb.com>

bpo-44040: Update broken link in pathlib source (GH-25905) (GH-25910)

(cherry picked from commit 96d5c7038b06e93d20822d28ed42a2183f876857)

Co-authored-by: Kevin Follstad <kfollstad@gmail.com>

Eliminate duplicated assignment in _randommodule.c (GH-25904) (GH-25909)

bpo-40297: Fix test_socket.CANTest.testSendFrame (GH-19548)

The address tuple for CAN_RAW no longer returns the address family
after the introduction of CAN ISO-TP support in a30f6d45ac3. However,
updating test_socket.CANTest.testSendFrame was missed as part of the
change, so the test incorrectly attempts to index past the last tuple
item to retrieve the address family.

This removes the now-redundant check for equality against socket.AF_CAN,
as the tuple will not contain the address family.
(cherry picked from commit 355bae88822bee4de6092b63d69c5a5dad393a16)

Co-authored-by: karl ding <karlding@users.noreply.github.com>

Clarify rx parameter of compileall functions (GH-25857)

(cherry picked from commit 09490298d4485e9322edc6e1e8e15eb66c586164)

Co-authored-by: Jean-Abou-Samra <37271310+Jean-Abou-Samra@users.noreply.github.com>

Fix inconsistent fsum vs sum and fmean vs mean (GH-25898) (GH-25899)

Fix typo in ast.py (GH-25740)

parantheses -> parentheses
(cherry picked from commit 9ee8448243e776d2a07a9868e9795bbb2c828f9c)

Co-authored-by: Ikko Ashimine <eltociear@gmail.com>

fix enum.property reference in docs (GH-25875) (#25876)

(cherry picked from commit 6fee0835cb00677acd341751f831ca1af128f4c9)

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

bpo-42686: Enable SQLite math functions in Windows build (GH-24053) (#25892)

(cherry picked from commit b451bc8d7e5e5a1df46fbecb6cf50af942cc401e)

Co-authored-by: Erlend Egeberg Aasland <erlend.aasland@innova.no>

bpo-32822: Add finally with return/break/continue to the tutorial (GH-25600) (#25893)

This documents in the tutorial docs the behavior of a finally clause in
case it should re-raise an exception but contains a
return/break/continue statement.
(cherry picked from commit a0b9915a8be98427432e13d8eb2207a8b9824179)

Co-authored-by: Roberto Hueso <robertohueso96@gmail.com>

Fix error in Enum documentation example code that was referring to the wrong enum. (GH-25837) (#25891)

(cherry picked from commit 33d9bf298b7672c5a09f8c0d80af00a4ec383e4a)

Co-authored-by: krisaoe <krisaoe@users.noreply.github.com>

Add C-API tests (GH-25886) (#25887)

(cherry picked from commit 2f5baa17504feb9a7613bac32fdceed4894434de)

Co-authored-by: Ken Jin <28750310+Fidget-Spinner@users.noreply.github.com>

bpo-44025: Clarify when '_' is a keyword. (GH-25873)

In match statements, in case patterns and nowhere else.

Co-authored-by: Jelle Zijlstra <jelle.zijlstra@gmail.com>
(cherry picked from commit 3b200b2aa648fcc8a2673871807c1463afe00195)

Co-authored-by: Terry Jan Reedy <tjreedy@udel.edu>

Copyedits to 3.10 What's New (GH-25787) (#25883)

Co-authored-by: Dominic Davis-Foster <dominic@davis-foster.co.uk>
(cherry picked from commit f6d7abc6e72294c5573709cca78ae252e03ebe3d)

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

bpo-38352: Add to typing.__all__ (GH-25821) (#25884)

This adds IO, TextIO, BinaryIO, Match, and Pattern.

Co-authored-by: Łukasz Langa <lukasz@langa.pl>
Co-authored-by: Ken Jin <28750310+Fidget-Spinner@users.noreply.github.com>
(cherry picked from commit b11557973476963f7c0fd0041eac175bc0d4c514)
Co-authored-by: Jelle Zijlstra <jelle.zijlstra@gmail.com>

bpo-44001: improve Literal documentation (GH-25877) (#25882)

(cherry picked from commit 87109f4d85c93a870ee8aa0d2b394547d4636b17)

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

update docstring for `win_getpass` to reflect code changes (GH-24967)

The code was updated in
https://github.com/python/cpython/commit/0ec88b33d093db00ec68b220247681354a650f0c
but the docstring was left untouched.

=> updated the docstring to reflect the code changes
(cherry picked from commit d4222ea6b0bb3cf7d40f23b370dc9eea5f9b7004)

Co-authored-by: Jürgen Gmach <juergen.gmach@googlemail.com>

bpo-44018: random.seed() no longer mutates its inputs (GH-25856) (GH-25872)

fix enum and backslash warnings (GH-25861) (GH-25871)

- Enum warning in test_faulthandler
- backslash warning in test_ipaddress
(cherry picked from commit 652bcd9f9cd2ed89b5fa958f8456556aa43b48cc)

Co-authored-by: Ethan Furman <ethan@stoneleaf.us>
Co-authored-by: Ethan Furman <ethan@stoneleaf.us>

Add CI step to check changes in the exported ABI (GH-25868)

bpo-43822: Prioritize tokenizer errors over custom syntax errors when raising parser exceptions (GH-25866)

(cherry picked from commit 9142088e7454a392b69a627863b235ecc32aea54)

Co-authored-by: Pablo Galindo <Pablogsal@gmail.com>

bpo-43822: Prioritize tokenizer errors over custom syntax errors when raising parser exceptions (GH-25866)

(cherry picked from commit 9142088e7454a392b69a627863b235ecc32aea54)

Co-authored-by: Pablo Galindo <Pablogsal@gmail.com>

Update CI files to build the 3.10 branch

Post 3.10.0b1

Python 3.10.0b1

Remove Enum warnings from test_httpservers (GH-25844)

bpo-38530: Refactor and improve AttributeError suggestions (GH-25776)

- Make case-swaps half the cost of any other edit
- Refactor Levenshtein code to not use memory allocator, and to bail early on no match.
- Add comments to Levenshtein distance code
- Add test cases for Levenshtein distance behind a debug macro
- Set threshold to `(name_size + item_size + 3) * MOVE_COST / 6`.
  - Reasoning: similar to `difflib.SequenceMatcher.ratio()` >= 2/3:
```
"Multiset Jaccard similarity" >= 2/3
matching letters / total letters >= 2/3
(name_size - distance + item_size - distance) / (name_size + item_size) >= 2/3
1 - (2*distance) / (name_size + item_size) >= 2/3
1/3 >= (2*distance) / (name_size + item_size)
(name_size + item_size) / 6 >= distance
With rounding:
(name_size + item_size + 3) // 6 >= distance
```

Co-authored-by: Pablo Galindo <pablogsal@gmail.com>

bpo-43943: ssl tests: Increase server socket timeout, backlog, debugging (GH-25850)

Signed-off-by: Christian Heimes <christian@python.org>

bpo-44011: Revert "New asyncio ssl implementation (GH-17975)" (GH-25848)

This reverts commit 5fb06edbbb769561e245d0fe13002bab50e2ae60 and all
subsequent dependent commits.

bpo-43754: Fix compiler warning in Python/compile.c (GH-25855)

This fixes the following warning:

'initializing': conversion from 'Py_ssize_t' to 'int', possible loss of data [D:\a\cpython\cpython\PCbuild\pythoncore.vcxproj]

bpo-43916: Move the _PyStructSequence_InitType function to the internal API (GH-25854)

Doc: Fix random.uniform example comment. (GH-25784)

Increase test timeout (GH-25842)

bpo-42725: Render annotations effectless on symbol table with PEP 563 (GH-25583)

bpo-44011: Fix asyncio tests without ssl module (GH-25840)

Signed-off-by: Christian Heimes <christian@python.org>

bpo-44015: dataclasses should allow KW_ONLY to be specified only once per class (GH-25841)

bpo-44015: Raise a TypeError if KW_ONLY is specified more than once.

dataclasses docs: add a missing word. (GH-25839)

More clarification of kw_only args. (GH-25838)

Also, clarify that the dataclass decorator is what raises an error for some mutable defaults.

Update macOS installer welcome and readme for 3.10b1 (GH-25835)

bpo-42362: use clang name on 10.9 builds as well (GH-25834)

Fix invalid markup (#25833)

bpo-42235: [macOS] Use LTO/PGO in build-installer.py with new enough compilers (GH-23079)

With recent enough compilers we can build binaries with
LTO/PGO on macOS. This patch enables this when building on
macOS 10.15 or later (Xcode 11 or later).

bpo-25478: Add total() method to collections.Counter (GH-25829)

bpo-41129: Fix check for macOS SDK paths when building Python (GH-25785)

Narrow search to match contents of SDKs, namely only files in ``/System/Library``,
``/System/IOSSupport``, and ``/usr`` other than ``/usr/local``. Previously,
anything under ``/System`` was assumed to be in an SDK which causes problems
with the new file system layout in 10.15+ where user file systems may appear
to be mounted under ``/System``.  Paths in ``/Library`` were also
incorrectly treated as SDK locations.

Co-authored-by: Ned Deily <nad@python.org>

bpo-37903: IDLE: add shell sidebar mouse interactions (GH-25708)

Left click and drag to select lines.  With selection, right click for context menu with copy and copy-with-prompts.
Also add copy-with-prompts to the text-box context menu.

Co-authored-by: Terry Jan Reedy <tjreedy@udel.edu>

bpo-42362: Switch to clang/clang++ as the default compiler in build-installer.py (GH-23298)

This change is cosmetic only, the "gcc" command in Apple's compiler tools is an alias for "clang" (and using non-system tooling for building the installer is not supported by this script).

Automerge-Triggered-By: GH:ned-deily

More work on documenting dataclass keyword-only fields. (GH-25828)

bpo-43851: Build SQLite with SQLITE_OMIT_AUTOINIT on macOS (GH-25413)

bpo-43568: Drop support for MACOSX_DEPLOYMENT_TARGET < 10.3 (GH-25827)

Only complain if the config target is >= 10.3 and the current target is
< 10.3. The check was originally added to ensure that incompatible
LDSHARED flags are not used, because -undefined dynamic_lookup is
used when building for 10.3 and later, and is not supported on older OS
versions. Apart from that, there should be no problem in general
with using an older target.

Authored-by: Joshua Root <jmr@macports.org>

bpo-43977: Make sure that tp_flags for pattern matching are inherited correctly. (GH-25813)

bpo-43977: Document the new pattern matching type flags (GH-25734)

bpo-43434: Clean up sqlite3.connect() after GH-25818 (GH-25823)

bpo-44011: New asyncio ssl implementation (#17975)

bpo-43434: Move sqlite3.connect audit events to sqlite3.Connection.__init__ (GH-25818)

bpo-43926: Cleaner metadata with PEP 566 JSON support. (GH-25565)

* bpo-43926: Cleaner metadata with PEP 566 JSON support.

* Add blurb

* Add versionchanged and versionadded declarations for changes to metadata.

* Use descriptor for PEP 566

bpo-43754: Eliminate bindings for partial pattern matches (GH-25229)

bpo-43990: Fix the footnote ordering in the operator precedence docs (GH-25805)

Footnotes 5 and 6 were in the wrong order.

bpo-43997: Add versionadded directives for to match_args, kw_only, and slots in dataclasses.dataclasses documentation (GH-25803)

bpo-38820: Add ssl, hashlib, and hmac changes to whatsnew 3.10 (GH-25817)

Signed-off-by: Christian Heimes <christian@python.org>

bpo-36384: Leading zeros in IPv4 addresses are no longer tolerated (GH-25099)

Reverts commit e653d4d8e820a7a004ad399530af0135b45db27a and makes
parsing even more strict. Like socket.inet_pton() any leading zero
is now treated as invalid input.

Signed-off-by: Christian Heimes <christian@python.org>
Co-authored-by: Łukasz Langa <lukasz@langa.pl>

bpo-32745: Fix a regression in the handling of ctypes' c_wchar_p type (#8721)

Embedded nulls would cause a ValueError to be raised. Thanks go to
Eryk Sun for their analysis.

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

bpo-41100: Update Misc/ACKS (GH-25808)

bpo-44009: Provide "python3.x-intel64" for Apple Silicon Macs (GH-25804)

This allows reliably forcing macOS universal2 framework builds
to run under Rosetta 2 Intel-64 emulation on Apple Silicon Macs
if needed for testing or when universal2 wheels are not yet
available.

bpo-43908: Mark ssl, hash, and hmac types as immutable (GH-25792)

Signed-off-by: Christian Heimes <christian@python.org>

bpo-43733: netrc try to use UTF-8 before using locale encoding. (GH-25781)

bpo-43987: Add "Annotations Best Practices" HOWTO doc. (#25746)

Add "Annotations Best Practices" HOWTO doc.

Minor tweaks to dataclasses keyword-only fields documentation. (GH-25801)

Improve the dataclasses kw_only documentation. (GH-25799)

Fix broken name in build.yml (GH-25759)

Fix exceptions mentioned in os.setxattr() docs (GH-25742)

Revert "bpo-43989: Temporarily disable warnings in ssltests (GH-25780)" (GH-25793)

Reverts python/cpython#25780

Automerge-Triggered-By: GH:tiran

bpo-43916: Rewrite new hashlib tests, fix typo (GH-25791)

* bpo-43916: Rewrite new hashlib tests, fix typo
* Flag test as cpython only

bpo-43989: Add signal format specifier for unix_events (GH-25769)

Add format specifier for IntEnum references to avoid 3.12 deprecation warning.

bpo-43998: Fix testing without ssl module (GH-25790)

Signed-off-by: Christian Heimes <christian@python.org>

bpo-43957: Add a missins space to the new format enum warning (#25770)

bpo-43998: Default to TLS 1.2 and increase cipher suite security (GH-25778)

The ssl module now has more secure default settings. Ciphers without forward
secrecy or SHA-1 MAC are disabled by default. Security level 2 prohibits
weak RSA, DH, and ECC keys with less than 112 bits of security.
:class:`~ssl.SSLContext` defaults to minimum protocol version TLS 1.2.
Settings are based on Hynek Schlawack's research.

```
$ openssl version
OpenSSL 1.1.1k  FIPS 25 Mar 2021
$ openssl ciphers -v '@SECLEVEL=2:ECDH+AESGCM:ECDH+CHACHA20:ECDH+AES:DHE+AES:!aNULL:!eNULL:!aDSS:!SHA1:!AESCCM'
TLS_AES_256_GCM_SHA384  TLSv1.3 Kx=any      Au=any  Enc=AESGCM(256) Mac=AEAD
TLS_CHACHA20_POLY1305_SHA256 TLSv1.3 Kx=any      Au=any  Enc=CHACHA20/POLY1305(256) Mac=AEAD
TLS_AES_128_GCM_SHA256  TLSv1.3 Kx=any      Au=any  Enc=AESGCM(128) Mac=AEAD
TLS_AES_128_CCM_SHA256  TLSv1.3 Kx=any      Au=any  Enc=AESCCM(128) Mac=AEAD
ECDHE-ECDSA-AES256-GCM-SHA384 TLSv1.2 Kx=ECDH     Au=ECDSA Enc=AESGCM(256) Mac=AEAD
ECDHE-RSA-AES256-GCM-SHA384 TLSv1.2 Kx=ECDH     Au=RSA  Enc=AESGCM(256) Mac=AEAD
ECDHE-ECDSA-AES128-GCM-SHA256 TLSv1.2 Kx=ECDH     Au=ECDSA Enc=AESGCM(128) Mac=AEAD
ECDHE-RSA-AES128-GCM-SHA256 TLSv1.2 Kx=ECDH     Au=RSA  Enc=AESGCM(128) Mac=AEAD
ECDHE-ECDSA-CHACHA20-POLY1305 TLSv1.2 Kx=ECDH     Au=ECDSA Enc=CHACHA20/POLY1305(256) Mac=AEAD
ECDHE-RSA-CHACHA20-POLY1305 TLSv1.2 Kx=ECDH     Au=RSA  Enc=CHACHA20/POLY1305(256) Mac=AEAD
ECDHE-ECDSA-AES256-SHA384 TLSv1.2 Kx=ECDH     Au=ECDSA Enc=AES(256)  Mac=SHA384
ECDHE-RSA-AES256-SHA384 TLSv1.2 Kx=ECDH     Au=RSA  Enc=AES(256)  Mac=SHA384
ECDHE-ECDSA-AES128-SHA256 TLSv1.2 Kx=ECDH     Au=ECDSA Enc=AES(128)  Mac=SHA256
ECDHE-RSA-AES128-SHA256 TLSv1.2 Kx=ECDH     Au=RSA  Enc=AES(128)  Mac=SHA256
DHE-RSA-AES256-GCM-SHA384 TLSv1.2 Kx=DH       Au=RSA  Enc=AESGCM(256) Mac=AEAD
DHE-RSA-AES128-GCM-SHA256 TLSv1.2 Kx=DH       Au=RSA  Enc=AESGCM(128) Mac=AEAD
DHE-RSA-AES256-SHA256   TLSv1.2 Kx=DH       Au=RSA  Enc=AES(256)  Mac=SHA256
DHE-RSA-AES128-SHA256   TLSv1.2 Kx=DH       Au=RSA  Enc=AES(128)  Mac=SHA256
```

Signed-off-by: Christian Heimes <christian@python.org>

Fixing doc for callback for lambda (GG-25779)

Fixing callback for lambda when no return value is provided

If using a frozen class with slots, add __getstate__ and __setstate__ to set the instance values. (GH-25786)

bpo-43989: Temporarily disable warnings in ssltests (GH-25780)

-Werror is currently broken.

bpo-43993: Update vendored pip to 21.1.1 (GH-25761)

Noted my recent contributions in "What's New In Python 3.10". (#25771)

Noted my recent contributions in "What's New In Python 3.10".  Also made some edits clarifying "annotations" vs "type hints", and some other edits for correctness.

bpo-42269: Add slots parameter to dataclass decorator (GH-24171)

Add slots parameter to dataclass decorator and make_dataclass function.

bpo-43916: Export the _PyStructSequence_InitType to fix build errors in the curses module (GH-25768)

bpo-41486: Fix initial buffer size can't > UINT32_MAX in zlib module (GH-25738)

* Fix initial buffer size can't > UINT32_MAX in zlib module

After commit f9bedb630e8a0b7d94e1c7e609b20dfaa2b22231, in 64-bit build,
if the initial buffer size > UINT32_MAX, ValueError will be raised.

These two functions are affected:
1. zlib.decompress(data, /, wbits=MAX_WBITS, bufsize=DEF_BUF_SIZE)
2. zlib.Decompress.flush([length])

This commit re-allows the size > UINT32_MAX.

* adds curly braces per PEP 7.

* Renames `Buffer_*` to `OutputBuffer_*` for clarity

bpo-43995: Fix reference leak in test_grammar (GH-25764)

bpo-43971: Add spaces around annotated arg default '=' (GH-25702)

Result: "quantity_on_hand: int = 0".

bpo-43928: Fix 'succesfully' typo in document (GH-25569)

bpo-43935: Fix typo in Turtle.back() docstring (GH-25581)

'e ,' to 'e, '.

bpo-43888: Remove coverage builds from CI (GH-25679)

The coverage builds were consistently timing out in CI, suggesting that people were not reviewing the uploaded reports.

bpo-43979: Remove unnecessary operation from urllib.parse.parse_qsl (GH-25756)

Automerge-Triggered-By: GH:gpshead

bpo-43981: Fix reference leaks in test_squeezer (GH-25758)

bpo-43916: _md5.md5 uses Py_TPFLAGS_DISALLOW_INSTANTIATION (GH-25753)

The following types use Py_TPFLAGS_DISALLOW_INSTANTIATION flag:

* _md5.md5
* _sha1.sha1
* _sha256.sha224
* _sha256.sha256
* _sha512.sha384
* _sha512.sha512

bpo-43901: Fix refleaks in test_module (GH-25754)

bpo-43916: select.devpoll uses Py_TPFLAGS_DISALLOW_INSTANTIATION (GH-25751)

bpo-43916: Apply Py_TPFLAGS_DISALLOW_INSTANTIATION to selected types (GH-25748)

Apply Py_TPFLAGS_DISALLOW_INSTANTIATION to the following types:

* _dbm.dbm
* _gdbm.gdbm
* _multibytecodec.MultibyteCodec
* _sre..SRE_Scanner
* _thread._localdummy
* _thread.lock
* _winapi.Overlapped
* array.arrayiterator
* functools.KeyWrapper
* functools._lru_list_elem
* pyexpat.xmlparser
* re.Match
* re.Pattern
* unicodedata.UCD
* zlib.Compress
* zlib.Decompress

bpo-43916: select.poll uses Py_TPFLAGS_DISALLOW_INSTANTIATION (GH-25750)

bpo-43933:  Set frame.f_lineno during call to __exit__ (GH-25719)

* Set line number of __exit__ call in a with statement to be that of the with keyword.

bpo-43908: check_set_special_type_attr() checks Py_TPFLAGS_IMMUTABLETYPE (GH-25743)

check_set_special_type_attr() and type_set_annotations()
now check for immutable flag (Py_TPFLAGS_IMMUTABLETYPE).

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

bpo-43667: Fix broken Unicode encoding in non-UTF locales on Solaris (GH-25096)

bpo-43916: PyStdPrinter_Type uses Py_TPFLAGS_DISALLOW_INSTANTIATION (GH-25749)

The PyStdPrinter_Type type now uses the
Py_TPFLAGS_DISALLOW_INSTANTIATION flag to disallow instantiation,
rather than seting a tp_init method which always fail.

Write also unit tests for PyStdPrinter_Type.