Post 3.10.0a1

Python 3.10.0a1

bpo-41584: clarify when the reflected method of a binary arithemtic operator is called (#22505)

bpo-41939: Fix test_site.test_license_exists_at_url() (#22559)

Call urllib.request.urlcleanup() to reset the global
urllib.request._opener.

bpo-41774: Tweak new programming FAQ entry (GH-22562)

Remove mention of space in "remove multiple items from list".

bpo-41936. Remove macros Py_ALLOW_RECURSION/Py_END_ALLOW_RECURSION (GH-22552)

bpo-41557: Update macOS installer to use SQLite 3.33.0 (GH-21959)

https://sqlite.org/releaselog/3_33_0.html

bpo-41428: Documentation for PEP 604  (gh-22517)

bpo-41892: Clarify that an example in the ElementTree docs explicitly avoids modifying an XML tree while iterating over it. (GH-22464)

bpo-41909: Enable previously disabled recursion checks. (GH-22536)

Enable recursion checks which were disabled when get __bases__ of
non-type objects in issubclass() and isinstance() and when intern
strings. It fixes a stack overflow when getting __bases__ leads
to infinite recursion.

Originally recursion checks was disabled for PyDict_GetItem() which
silences all errors including the one raised in case of detected
recursion and can return incorrect result. But now the code uses
PyDict_GetItemWithError() and PyDict_SetDefault() instead.

Typo fix (GH-22496)

Multiple typo fixes in code comments

Automerge-Triggered-By: @Mariatta

bpo-41490: Bump vendored pip to version 20.2.3 (#22527)

Delete extra 'the' from `Formatter` class docstring (GH-22530)

bpo-41898: add caveat on root logger seeing all messages in assertLogs doc (GH-22526)

bpo-41887: omit leading spaces/tabs on ast.literal_eval (#22469)

Also document that eval() does this (the same way).

[doc] Use list[int] instead of List[int] (etc.) in a few more places (GH-22524)

This changes a few occurrences left behind by #22340.

Automerge-Triggered-By: @gvanrossum

bpo-41840: Report module-level globals as both local and global in the symtable module (GH-22391)

bpo-41922: Use PEP 590 vectorcall to speed up reversed() (GH-22523)

[doc] Fix link to abc.collections.Iterable (GH-22520)

Missed this occurrence before, sorry. Also changed "the PEP" to "PEP".

Automerge-Triggered-By: @gvanrossum

bpo-40564: Avoid copying state from extant ZipFile. (GH-22371)

bpo-40564: Avoid copying state from extant ZipFile.

bpo-41826: Fix compiler warnings in test_peg_generator (GH-22455)

Co-authored-by: Skip Montanaro

bpo-41867: List options for timespec in docstrings of isoformat methods (GH-22418)

bpo-40833: Clarify Path.rename doc-string regarding relative paths (GH-20554)

bpo-41900: C14N 2.0 serialisation failed for unprefixed attributes when a default namespace was defined. (GH-22474)

[doc] Fix link to abc.collections.Iterable (GH-22502)

Automerge-Triggered-By: @gvanrossum

Fix is_typeddict markup (#22501)

Typo fix - "mesasge" should be "message" (GH-22498)

* Correct at 2 places in email module

bpo-41802: Document 'PyDict_DelItem' can raise a 'KeyError' (GH-22291)

bpo-41692: Deprecate PyUnicode_InternImmortal() (GH-22486)

The PyUnicode_InternImmortal() function is now deprecated and will be
removed in Python 3.12: use PyUnicode_InternInPlace() instead.

Update link to supporting references (GH-22488)

[doc] Update references to NumPy (GH-22458)

Numeric(al) Python to NumPy. It seems the old name hasn't been used for some time.

bpo-21955: Change my nickname in BINARY_ADD comment (GH-22481)

bpo-26680: Incorporate is_integer in all built-in and standard library numeric types (GH-6121)

* bpo-26680: Adds support for int.is_integer() for compatibility with float.is_integer().

The int.is_integer() method always returns True.

* bpo-26680: Adds a test to ensure that False.is_integer() and True.is_integer() are always True.

* bpo-26680: Adds Real.is_integer() with a trivial implementation using conversion to int.

This default implementation is intended to reduce the workload for subclass
implementers. It is not robust in the presence of infinities or NaNs and
may have suboptimal performance for other types.

* bpo-26680: Adds Rational.is_integer which returns True if the denominator is one.

This implementation assumes the Rational is represented in it's
lowest form, as required by the class docstring.

* bpo-26680: Adds Integral.is_integer which always returns True.

* bpo-26680: Adds tests for Fraction.is_integer called as an instance method.

The tests for the Rational abstract base class use an unbound
method to sidestep the inability to directly instantiate Rational.
These tests check that everything works correct as an instance method.

* bpo-26680: Updates documentation for Real.is_integer and built-ins int and float.

The call x.is_integer() is now listed in the table of operations
which apply to all numeric types except complex, with a reference
to the full documentation for Real.is_integer().  Mention of
is_integer() has been removed from the section 'Additional Methods
on Float'.

The documentation for Real.is_integer() describes its purpose, and
mentions that it should be overridden for performance reasons, or
to handle special values like NaN.

* bpo-26680: Adds Decimal.is_integer to the Python and C implementations.

The C implementation of Decimal already implements and uses
mpd_isinteger internally, we just expose the existing function to
Python.

The Python implementation uses internal conversion to integer
using to_integral_value().

In both cases, the corresponding context methods are also
implemented.

Tests and documentation are included.

* bpo-26680: Updates the ACKS file.

* bpo-26680: NEWS entries for int, the numeric ABCs and Decimal.

Co-authored-by: Robert Smallshire <rob@sixty-north.com>

bpo-41861: Convert _sqlite3 CursorType and ConnectionType to heap types (GH-22478)

bpo-41861: Convert _sqlite3 RowType and StatementType to heap types (GH-22444)

bpo-41870: Avoid the test when nargs=0 (GH-22462)

Fix grammar in secrets module documentation (GH-22467)

From `In particularly,` to `In particular,`

bpo-41670: Remove outdated predict macro invocation. (GH-22026)

Remove PREDICTion of POP_BLOCK from FOR_ITER.

bpo-41774: Add programming FAQ entry (GH-22402)

In the "Sequences (Tuples/Lists)" section, add
"How do you remove multiple items from a list".

bpo-41773: Raise exception for non-finite weights in random.choices().  (GH-22441)

bpo-41873: Add vectorcall for float() (GH-22432)

 bpo-41861: Convert _sqlite3 PrepareProtocolType to heap type (GH-22428)

bpo-41842: Add codecs.unregister() function (GH-22360)

Add codecs.unregister() and PyCodec_Unregister() functions
to unregister a codec search function.

bpo-41875: Use __builtin_unreachable when possible (GH-22433)

bpo-40105: ZipFile truncate in append mode with shorter comment (GH-19337)

bpo-41870: Use PEP 590 vectorcall to speed up bool()  (GH-22427)

* bpo-41870: Use PEP 590 vectorcall to speed up bool()

* bpo-41870: Add NEWS.d

[doc] Leverage the fact that the actual types can now be indexed for typing (GH-22340)

This shows users that they can use the actual types. Using deprecated types is confusing.

This also prefers colections.abc.Sized instead of the alias typing.Sized. I guess the aliases were created to make it convenient to import all collections related types from the same place.

This should be backported to 3.9.

Automerge-Triggered-By: @gvanrossum

bpo-41861: Convert _sqlite3 cache and node static types to heap types (GH-22417)

bpo-41858: Clarify line in optparse doc (GH-22407)

The existing line is easily read as being incomplete.

Revert "Fix all Python Cookbook links (#22205)" (GH-22424)

This commit reverts commit ac0333e1e117b7f61ed7ef1dbcdb6e515ada603b as the original links are working again and they provide extended features such as comments and alternative versions.

bpo-1635741: Port _bisect module to multi-phase init (GH-22415)

bpo-41428: Fix compiler warning in unionobject.c (GH-22416)

Use Py_ssize_t type rather than int, to store lengths in
unionobject.c. Fix the warning:

Objects\unionobject.c(205,1): warning C4244: 'initializing':
conversion from 'Py_ssize_t' to 'int', possible loss of data

Fix logging error message (GH-22410)

Same changes as #22276 squashed to a single commit. Just hoping to get Travis to cooperate by opening a new PR...

Automerge-Triggered-By: @vsajip

bpo-39934: Account for control blocks in 'except' in compiler. (GH-22395)

* Account for control blocks in 'except' in compiler. Fixes #39934.

bpo-41775: Make 'IDLE Shell' the shell title  (#22399)

'Python Shell' may have contributed to some beginners confusing 'IDLE' with ' Python'.

bpo-41428: Fix compiler warnings in unionobject.c (GH-22388)

Use Py_ssize_t type rather than int, to store lengths in
unionobject.c. Fix warnings:

Objects\unionobject.c(189,71): warning C4244: '+=':
conversion from 'Py_ssize_t' to 'int', possible loss of data

Objects\unionobject.c(182,1): warning C4244: 'initializing':
conversion from 'Py_ssize_t' to 'int', possible loss of data

Objects\unionobject.c(205,1): warning C4244: 'initializing':
conversion from 'Py_ssize_t' to 'int', possible loss of data

Objects\unionobject.c(437,1): warning C4244: 'initializing':
conversion from 'Py_ssize_t' to 'int', possible loss of data

bpo-41654: Fix compiler warning in MemoryError_dealloc() (GH-22387)

Fix warning:

Objects\exceptions.c(2324,56): warning C4098:
'MemoryError_dealloc': 'void' function returning a value

bpo-41833: threading.Thread now uses the target name (GH-22357)

bpo-30155: Add macros to get tzinfo from datetime instances (GH-21633)

Add PyDateTime_DATE_GET_TZINFO() and PyDateTime_TIME_GET_TZINFO()
macros.

bpo-33822: Update IDLE section of What's New 3.8 (GH-22383)

bpo-41844: Add IDLE section to What's New 3.9 (GN-22382)

bpo-41841: Prepare IDLE News for 3.10 (GH-22379)

bpo-37779 : Add information about the overriding behavior of ConfigParser.read (GH-15177)

Co-Authored-By: Kyle Stanley <aeros167@gmail.com>
Co-Authored-By: Paul Ganssle <p.ganssle@gmail.com>

bpo-40170: Use inline _PyType_HasFeature() function (GH-22375)

Use _PyType_HasFeature() in the _io module and in structseq
implementation. Replace PyType_HasFeature() opaque function call with
_PyType_HasFeature() inlined function.

bpo-40941: Fix stackdepth compiler warnings (GH-22377)

Explicitly cast a difference of two pointers to int:
PyFrameObject.f_stackdepth is an int.

bpo-40941: Fix fold_tuple_on_constants() compiler warnings (GH-22378)

Add explicit casts to fix compiler warnings in
fold_tuple_on_constants().

The limit of constants per code is now INT_MAX, rather than UINT_MAX.

bpo-40521: Fix PyUnicode_InternInPlace() (GH-22376)

Fix PyUnicode_InternInPlace() when the INTERNED_STRINGS macro is not
defined (when the EXPERIMENTAL_ISOLATED_SUBINTERPRETERS macro is
defined).

bpo-41834: Remove _Py_CheckRecursionLimit variable (GH-22359)

Remove the global _Py_CheckRecursionLimit variable: it has been
replaced by ceval.recursion_limit of the PyInterpreterState
structure.

There is no need to keep the variable for the stable ABI, since
Py_EnterRecursiveCall() and Py_LeaveRecursiveCall() were not usable
in Python 3.8 and older: these macros accessed PyThreadState members,
whereas the PyThreadState structure is opaque in the limited C API.

bpo-1635741, unicodedata: add ucd_type parameter to UCD_Check() macro (GH-22328)

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

bpo-1635741: Port _lsprof extension to multi-phase init (PEP 489) (GH-22220)

bpo-41513: Improve order of adding fractional values. Improve variable names. (GH-22368)

bpo-41816: `StrEnum.__str__` is `str.__str__` (GH-22362)

use `str.__str__` for `StrEnum` so that `str(StrEnum.member)` is the same as directly accessing the string value of the `StrEnum` member

bpo-35764: Rewrite the IDLE Calltips doc section  (GH-22363)

bpo-41810: Reintroduce `types.EllipsisType`, `.NoneType` & `.NotImplementedType` (GH-22336)

closes issue 41810

bpo-41602: raise SIGINT exit code on KeyboardInterrupt from pymain_run_module (#21956)

Closes bpo issue 41602

bpo-41817: use new StrEnum to ensure all members are strings (GH-22348)

* use new StrEnum to ensure all members are strings

bpo-40670: More reliable validation of statements in timeit.Timer. (GH-22358)

It now accepts "empty" statements (only whitespaces and comments)
and rejects misindentent statements.

Py_IS_TYPE() macro uses Py_TYPE() (GH-22341)

Enum: add extended AutoNumber example (GH-22349)

bpo-40181: Remove '/' reminder in IDLE calltips. (GH-22350)

The marker was added to the language in 3.8 and
3.7 only gets security patches.

bpo-41756: Refactor gen_send_ex(). (GH-22330)

bpo-41816: add `StrEnum` (GH-22337)

`StrEnum` ensures that its members were already strings, or intended to
be strings.

bpo-40084: Enum - dir() includes member attributes (GH-19219)

bpo-1635741: Convert an  _lsprof method to argument clinic (GH-22240)

bpo-41819: Fix compiler warning in init_dump_ascii_wstr() (GH-22332)

Fix the compiler warning:

format specifies type `wint_t` (aka `int`) but the argument has type `unsigned int`

bpo-41513: Add accuracy tests for math.hypot() (GH-22327)

[doc] Teach 0-args form of super in Programming FAQ (GH-22176)

bpo-12178: Fix escaping of escapechar in csv.writer() (GH-13710)

Co-authored-by: Itay Elbirt <anotahacou@gmail.com>

bpo-41815: SQLite: segfault if backup called on closed database (GH-22322)

# [bpo-41815](): SQLite: fix segfault if backup called on closed database

Attempting to backup a closed database will trigger segfault:

```python
import sqlite3
target = sqlite3.connect(':memory:')
source = sqlite3.connect(':memory:')
source.close()
source.backup(target)
```

Add missing whatsnew entry for TestCase.assertNoLogs (GH-22317)

bpo-33689: Blank lines in .pth file cause a duplicate sys.path entry (GH-20679)

bpo-41811: create SortKey members using first given value (GH-22316)

bpo-41756: Introduce PyGen_Send C API (GH-22196)

The new API allows to efficiently send values into native generators
and coroutines avoiding use of StopIteration exceptions to signal
returns.

ceval loop now uses this method instead of the old "private"
_PyGen_Send C API. This translates to 1.6x increased performance
of 'await' calls in micro-benchmarks.

Aside from CPython core improvements, this new API will also allow
Cython to generate more efficient code, benefiting high-performance
IO libraries like uvloop.

Make fractional value accumulation consistent inside and outside the loop. (GH-22315)

bpo-35293: Travis CI uses "make venv" for the doc (GH-22307)

Doc/requirements.txt becomes the reference for packages and package
versions needed to build the Python documentation.

* Doc/Makefile now uses Doc/requirements.txt
* .travis.yml now uses "make env" of Doc/Makefile

bpo-35293: Remove RemovedInSphinx40Warning (GH-22198)

* bpo-35293: Remove RemovedInSphinx40Warning

* Update Misc/NEWS.d/next/Documentation/2020-09-12-17-37-13.bpo-35293._cOwPD.rst

Co-authored-by: Victor Stinner <vstinner@python.org>
* bpo-35293: Apply Victor's review

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

bpo-41762: Fix usage of productionlist markup in the doc (GH-22281)

Use an unique identifier for the different grammars documented using
the Sphinx productionlist markup.

productionlist markups of the same grammar, like "expressions" or
"compound statements", use the same identifier "python-grammar".

Remove duplicated words words (GH-22298)

bpo-41808: Add What's New 3.9 entry missing from master (#22294)

Entry was added by bpo-40939, #21012 and #21039.

bpo-27032, bpo-37328: Document removing HTMLParser.unescape(). (GH-22288)