Mailman 3 December 2022 - Python-checkins

Fix `pydtrace.d` path comment in `Include/pydtrace.h` (#28539)
by kumaraditya303 Dec. 31, 2022

Dec. 31, 2022

https://github.com/python/cpython/commit/baf234971f20e5e6c7438f46889e9c8f17… commit: baf234971f20e5e6c7438f46889e9c8f172cc25e branch: main author: Mark Hansen <mark(a)markhansen.co.nz> committer: kumaraditya303 <59607654+kumaraditya303(a)users.noreply.github.com> date: 2022-12-31T22:40:25+05:30 summary: Fix `pydtrace.d` path comment in `Include/pydtrace.h` (#28539) files: M Include/pydtrace.h diff --git a/Include/pydtrace.h b/Include/pydtrace.h index 75f8e7f70979..e197d3669453 100644 --- a/Include/pydtrace.h +++ b/Include/pydtrace.h @@ -12,7 +12,7 @@ extern "C" { /* pydtrace_probes.h, on systems with DTrace, is auto-generated to include `PyDTrace_{PROBE}` and `PyDTrace_{PROBE}_ENABLED()` macros for every probe - defined in pydtrace_provider.d. + defined in pydtrace.d. Calling these functions must be guarded by a `PyDTrace_{PROBE}_ENABLED()` check to minimize performance impact when probing is off. For example:

1 0

GH-87002: fix caching documentation in `struct` module (#24164)
by kumaraditya303 Dec. 31, 2022

Dec. 31, 2022

https://github.com/python/cpython/commit/ac7a0a9f9e9a749ebcdd9d1ac21f73449d… commit: ac7a0a9f9e9a749ebcdd9d1ac21f73449d279958 branch: main author: Sandeep Subramanian <sandeepsubramanian94(a)gmail.com> committer: kumaraditya303 <59607654+kumaraditya303(a)users.noreply.github.com> date: 2022-12-31T22:27:58+05:30 summary: GH-87002: fix caching documentation in `struct` module (#24164) files: M Doc/library/struct.rst diff --git a/Doc/library/struct.rst b/Doc/library/struct.rst index 50d70731f775..830ba69e294d 100644 --- a/Doc/library/struct.rst +++ b/Doc/library/struct.rst @@ -548,9 +548,9 @@ The :mod:`struct` module also defines the following type: .. note:: The compiled versions of the most recent format strings passed to - :class:`Struct` and the module-level functions are cached, so programs - that use only a few format strings needn't worry about reusing a single - :class:`Struct` instance. + the module-level functions are cached, so programs that use only a few + format strings needn't worry about reusing a single :class:`Struct` + instance. Compiled Struct objects support the following methods and attributes:

1 0

gh-100633 Tutorial: Fix dataclasses import (GH-100638)
by miss-islington Dec. 31, 2022

Dec. 31, 2022

https://github.com/python/cpython/commit/f80ba44f7d01b153b12eb7573568f9b1f3… commit: f80ba44f7d01b153b12eb7573568f9b1f33654ee branch: 3.11 author: Miss Islington (bot) <31488909+miss-islington(a)users.noreply.github.com> committer: miss-islington <31488909+miss-islington(a)users.noreply.github.com> date: 2022-12-31T04:28:59-08:00 summary: gh-100633 Tutorial: Fix dataclasses import (GH-100638) import dataclass not dataclasses from dataclasses (cherry picked from commit 98308dbeb110198ebe28bdb7720d3671b3e7f57b) Co-authored-by: Owain Davies <116417456+OTheDev(a)users.noreply.github.com> files: M Doc/tutorial/classes.rst diff --git a/Doc/tutorial/classes.rst b/Doc/tutorial/classes.rst index 5abb767cb0a8..30450c70f3e8 100644 --- a/Doc/tutorial/classes.rst +++ b/Doc/tutorial/classes.rst @@ -740,7 +740,7 @@ Sometimes it is useful to have a data type similar to the Pascal "record" or C "struct", bundling together a few named data items. The idiomatic approach is to use :mod:`dataclasses` for this purpose:: - from dataclasses import dataclasses + from dataclasses import dataclass @dataclass class Employee:

1 0

gh-100633 Tutorial: Fix dataclasses import (GH-100638)
by miss-islington Dec. 31, 2022

Dec. 31, 2022

https://github.com/python/cpython/commit/f7ad4ffa563fbe14d6b0020c45720bebde… commit: f7ad4ffa563fbe14d6b0020c45720bebde73de62 branch: 3.10 author: Miss Islington (bot) <31488909+miss-islington(a)users.noreply.github.com> committer: miss-islington <31488909+miss-islington(a)users.noreply.github.com> date: 2022-12-31T04:28:36-08:00 summary: gh-100633 Tutorial: Fix dataclasses import (GH-100638) import dataclass not dataclasses from dataclasses (cherry picked from commit 98308dbeb110198ebe28bdb7720d3671b3e7f57b) Co-authored-by: Owain Davies <116417456+OTheDev(a)users.noreply.github.com> files: M Doc/tutorial/classes.rst diff --git a/Doc/tutorial/classes.rst b/Doc/tutorial/classes.rst index 5abb767cb0a8..30450c70f3e8 100644 --- a/Doc/tutorial/classes.rst +++ b/Doc/tutorial/classes.rst @@ -740,7 +740,7 @@ Sometimes it is useful to have a data type similar to the Pascal "record" or C "struct", bundling together a few named data items. The idiomatic approach is to use :mod:`dataclasses` for this purpose:: - from dataclasses import dataclasses + from dataclasses import dataclass @dataclass class Employee:

1 0

gh-100633 Tutorial: Fix dataclasses import (#100638)
by AlexWaygood Dec. 31, 2022

Dec. 31, 2022

https://github.com/python/cpython/commit/98308dbeb110198ebe28bdb7720d3671b3… commit: 98308dbeb110198ebe28bdb7720d3671b3e7f57b branch: main author: Owain Davies <116417456+OTheDev(a)users.noreply.github.com> committer: AlexWaygood <Alex.Waygood(a)Gmail.com> date: 2022-12-31T10:23:18Z summary: gh-100633 Tutorial: Fix dataclasses import (#100638) import dataclass not dataclasses from dataclasses files: M Doc/tutorial/classes.rst diff --git a/Doc/tutorial/classes.rst b/Doc/tutorial/classes.rst index a206ba371976..116801177a3a 100644 --- a/Doc/tutorial/classes.rst +++ b/Doc/tutorial/classes.rst @@ -741,7 +741,7 @@ Sometimes it is useful to have a data type similar to the Pascal "record" or C "struct", bundling together a few named data items. The idiomatic approach is to use :mod:`dataclasses` for this purpose:: - from dataclasses import dataclasses + from dataclasses import dataclass @dataclass class Employee:

1 0

gh-94808: Improve coverage of dictresize (GH-100619)
by methane Dec. 31, 2022

Dec. 31, 2022

https://github.com/python/cpython/commit/636e9dd23f88c701eecf91156835fe0fc8… commit: 636e9dd23f88c701eecf91156835fe0fc8b1feb6 branch: main author: tqxia <44689929+tqxia(a)users.noreply.github.com> committer: methane <songofacandy(a)gmail.com> date: 2022-12-31T18:15:30+09:00 summary: gh-94808: Improve coverage of dictresize (GH-100619) files: M Lib/test/test_dict.py diff --git a/Lib/test/test_dict.py b/Lib/test/test_dict.py index 5b8baaf9e6e2..79638340059f 100644 --- a/Lib/test/test_dict.py +++ b/Lib/test/test_dict.py @@ -1094,6 +1094,21 @@ def __init__(self, order): d.update(o.__dict__) self.assertEqual(list(d), ["c", "b", "a"]) + @support.cpython_only + def test_splittable_to_generic_combinedtable(self): + """split table must be correctly resized and converted to generic combined table""" + class C: + pass + + a = C() + a.x = 1 + d = a.__dict__ + before_resize = sys.getsizeof(d) + d[2] = 2 # split table is resized to a generic combined table + + self.assertGreater(sys.getsizeof(d), before_resize) + self.assertEqual(list(d), ['x', 2]) + def test_iterator_pickling(self): for proto in range(pickle.HIGHEST_PROTOCOL + 1): data = {1:"a", 2:"b", 3:"c"}

1 0

GH-85979: Clarify specification of `object.__await__` (GH-22320)
by miss-islington Dec. 31, 2022

Dec. 31, 2022

https://github.com/python/cpython/commit/f9ddbc0de5ca0689f87f18819c0bf4b7f1… commit: f9ddbc0de5ca0689f87f18819c0bf4b7f1271726 branch: 3.11 author: Miss Islington (bot) <31488909+miss-islington(a)users.noreply.github.com> committer: miss-islington <31488909+miss-islington(a)users.noreply.github.com> date: 2022-12-30T22:34:12-08:00 summary: GH-85979: Clarify specification of `object.__await__` (GH-22320) (cherry picked from commit f59c7f8edd5ba5f6c1954383542a2292bcf51d91) Co-authored-by: Paolo Lammens <lammenspaolo(a)gmail.com> Co-authored-by: Kumar Aditya <59607654+kumaraditya303(a)users.noreply.github.com> files: M Doc/reference/datamodel.rst diff --git a/Doc/reference/datamodel.rst b/Doc/reference/datamodel.rst index 92cd2f8f8074..afd4a5477ffb 100644 --- a/Doc/reference/datamodel.rst +++ b/Doc/reference/datamodel.rst @@ -2950,6 +2950,14 @@ are awaitable. :term:`awaitable` objects. For instance, :class:`asyncio.Future` implements this method to be compatible with the :keyword:`await` expression. + .. note:: + + The language doesn't place any restriction on the type or value of the + objects yielded by the iterator returned by ``__await__``, as this is + specific to the implementation of the asynchronous execution framework + (e.g. :mod:`asyncio`) that will be managing the :term:`awaitable` object. + + .. versionadded:: 3.5 .. seealso:: :pep:`492` for additional information about awaitable objects.

1 0

GH-85979: Clarify specification of `object.__await__` (GH-22320)
by miss-islington Dec. 31, 2022

Dec. 31, 2022

https://github.com/python/cpython/commit/504aa92b70d3902f373dc5a6ca0b3ddc1a… commit: 504aa92b70d3902f373dc5a6ca0b3ddc1ad233d5 branch: 3.10 author: Miss Islington (bot) <31488909+miss-islington(a)users.noreply.github.com> committer: miss-islington <31488909+miss-islington(a)users.noreply.github.com> date: 2022-12-30T22:31:41-08:00 summary: GH-85979: Clarify specification of `object.__await__` (GH-22320) (cherry picked from commit f59c7f8edd5ba5f6c1954383542a2292bcf51d91) Co-authored-by: Paolo Lammens <lammenspaolo(a)gmail.com> Co-authored-by: Kumar Aditya <59607654+kumaraditya303(a)users.noreply.github.com> files: M Doc/reference/datamodel.rst diff --git a/Doc/reference/datamodel.rst b/Doc/reference/datamodel.rst index eafb6ff15998..6aed328a9fdb 100644 --- a/Doc/reference/datamodel.rst +++ b/Doc/reference/datamodel.rst @@ -2879,6 +2879,14 @@ are awaitable. :term:`awaitable` objects. For instance, :class:`asyncio.Future` implements this method to be compatible with the :keyword:`await` expression. + .. note:: + + The language doesn't place any restriction on the type or value of the + objects yielded by the iterator returned by ``__await__``, as this is + specific to the implementation of the asynchronous execution framework + (e.g. :mod:`asyncio`) that will be managing the :term:`awaitable` object. + + .. versionadded:: 3.5 .. seealso:: :pep:`492` for additional information about awaitable objects.

1 0

GH-85979: Clarify specification of `object.__await__` (#22320)
by kumaraditya303 Dec. 31, 2022

Dec. 31, 2022

https://github.com/python/cpython/commit/f59c7f8edd5ba5f6c1954383542a2292bc… commit: f59c7f8edd5ba5f6c1954383542a2292bcf51d91 branch: main author: Paolo Lammens <lammenspaolo(a)gmail.com> committer: kumaraditya303 <59607654+kumaraditya303(a)users.noreply.github.com> date: 2022-12-31T11:54:04+05:30 summary: GH-85979: Clarify specification of `object.__await__` (#22320) Co-authored-by: Kumar Aditya <59607654+kumaraditya303(a)users.noreply.github.com> files: M Doc/reference/datamodel.rst diff --git a/Doc/reference/datamodel.rst b/Doc/reference/datamodel.rst index fd682fcff020..1d2ddf3507ae 100644 --- a/Doc/reference/datamodel.rst +++ b/Doc/reference/datamodel.rst @@ -2950,6 +2950,14 @@ are awaitable. :term:`awaitable` objects. For instance, :class:`asyncio.Future` implements this method to be compatible with the :keyword:`await` expression. + .. note:: + + The language doesn't place any restriction on the type or value of the + objects yielded by the iterator returned by ``__await__``, as this is + specific to the implementation of the asynchronous execution framework + (e.g. :mod:`asyncio`) that will be managing the :term:`awaitable` object. + + .. versionadded:: 3.5 .. seealso:: :pep:`492` for additional information about awaitable objects.

1 0

[3.11] Improve comments in itertools uniquification recipes (GH-100631) (GH-100632)
by rhettinger Dec. 31, 2022

Dec. 31, 2022

https://github.com/python/cpython/commit/18006309eac07e5f42232fd4ba016640ae… commit: 18006309eac07e5f42232fd4ba016640aeac5b1a branch: 3.11 author: Miss Islington (bot) <31488909+miss-islington(a)users.noreply.github.com> committer: rhettinger <rhettinger(a)users.noreply.github.com> date: 2022-12-30T22:23:39-06:00 summary: [3.11] Improve comments in itertools uniquification recipes (GH-100631) (GH-100632) files: M Doc/library/itertools.rst diff --git a/Doc/library/itertools.rst b/Doc/library/itertools.rst index 93bc1f792f54..fbbc96c60aba 100644 --- a/Doc/library/itertools.rst +++ b/Doc/library/itertools.rst @@ -989,15 +989,14 @@ which incur interpreter overhead. def unique_everseen(iterable, key=None): "List unique elements, preserving order. Remember all elements ever seen." # unique_everseen('AAAABBBCCDAABBB') --> A B C D - # unique_everseen('ABBCcAD', str.lower) --> A B C D + # unique_everseen('ABBcCAD', str.lower) --> A B c D seen = set() if key is None: for element in filterfalse(seen.__contains__, iterable): seen.add(element) yield element - # Note: The steps shown above are intended to demonstrate - # filterfalse(). For order preserving deduplication, - # a better solution is: + # For order preserving deduplication, + # a faster but non-lazy solution is: # yield from dict.fromkeys(iterable) else: for element in iterable: @@ -1005,11 +1004,15 @@ which incur interpreter overhead. if k not in seen: seen.add(k) yield element + # For use cases that allow the last matching element to be returned, + # a faster but non-lazy solution is: + # t1, t2 = tee(iterable) + # yield from dict(zip(map(key, t1), t2)).values() def unique_justseen(iterable, key=None): "List unique elements, preserving order. Remember only the element just seen." # unique_justseen('AAAABBBCCDAABBB') --> A B C D A B - # unique_justseen('ABBCcAD', str.lower) --> A B C A D + # unique_justseen('ABBcCAD', str.lower) --> A B c A D return map(next, map(operator.itemgetter(1), groupby(iterable, key))) def iter_except(func, exception, first=None): @@ -1365,15 +1368,17 @@ which incur interpreter overhead. >>> list(unique_everseen('AAAABBBCCDAABBB')) ['A', 'B', 'C', 'D'] - >>> list(unique_everseen('ABBCcAD', str.lower)) ['A', 'B', 'C', 'D'] + >>> list(unique_everseen('ABBcCAD', str.lower)) + ['A', 'B', 'c', 'D'] >>> list(unique_justseen('AAAABBBCCDAABBB')) ['A', 'B', 'C', 'D', 'A', 'B'] - >>> list(unique_justseen('ABBCcAD', str.lower)) ['A', 'B', 'C', 'A', 'D'] + >>> list(unique_justseen('ABBcCAD', str.lower)) + ['A', 'B', 'c', 'A', 'D'] >>> d = dict(a=1, b=2, c=3) >>> it = iter_except(d.popitem, KeyError)

1 0