Mailman 3 April 2022 - Python-checkins

gh-89253: Add 3.10 whatsnew section for itertools.pairwise (GH-91563)
by miss-islington April 30, 2022

April 30, 2022

https://github.com/python/cpython/commit/8b6e5d38636807850e6b9579a98117b71b… commit: 8b6e5d38636807850e6b9579a98117b71b116e97 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-04-30T15:29:09-07:00 summary: gh-89253: Add 3.10 whatsnew section for itertools.pairwise (GH-91563) GH-89253 [`pairwise()`](https://docs.python.org/3/library/itertools.htmlGH-itertools.pairwise) already has the 'new in python3.10' Automerge-Triggered-By: GH:rhettinger (cherry picked from commit 5dcfb916c765d825b2e8372281d71d32316b41cf) Co-authored-by: slateny <46876382+slateny(a)users.noreply.github.com> files: M Doc/whatsnew/3.10.rst diff --git a/Doc/whatsnew/3.10.rst b/Doc/whatsnew/3.10.rst index 5788e32da1c92..55e7d62b54159 100644 --- a/Doc/whatsnew/3.10.rst +++ b/Doc/whatsnew/3.10.rst @@ -1212,6 +1212,12 @@ now call :func:`inspect.get_annotations` to retrieve annotations. This means also now un-stringize stringized annotations. (Contributed by Larry Hastings in :issue:`43817`.) +itertools +--------- + +Add :func:`itertools.pairwise()`. +(Contributed by Raymond Hettinger in :issue:`38200`.) + linecache ---------

1 0

Improving readability of argparse.rst (GH-91751)
by miss-islington April 30, 2022

April 30, 2022

https://github.com/python/cpython/commit/238aa6253bcd89a4eff50513cd72c07054… commit: 238aa6253bcd89a4eff50513cd72c07054e47d8e branch: main author: Antonio Andrade <andrade.antonio(a)gmail.com> committer: miss-islington <31488909+miss-islington(a)users.noreply.github.com> date: 2022-04-30T15:20:10-07:00 summary: Improving readability of argparse.rst (GH-91751) Fixed few typos and enhanced few paragraphs for your review and consideration. Trivial contribution towards continuous improvement, so no issue was raised. Automerge-Triggered-By: GH:rhettinger files: M Doc/library/argparse.rst diff --git a/Doc/library/argparse.rst b/Doc/library/argparse.rst index 17570efb27081..5d269cc4eac4a 100644 --- a/Doc/library/argparse.rst +++ b/Doc/library/argparse.rst @@ -22,8 +22,8 @@ The :mod:`argparse` module makes it easy to write user-friendly command-line interfaces. The program defines what arguments it requires, and :mod:`argparse` will figure out how to parse those out of :data:`sys.argv`. The :mod:`argparse` -module also automatically generates help and usage messages and issues errors -when users give the program invalid arguments. +module also automatically generates help and usage messages. The module +will also issue errors when users give the program invalid arguments. Core Functionality @@ -91,8 +91,8 @@ produces either the sum or the max:: args = parser.parse_args() print(args.accumulate(args.integers)) -Assuming the Python code above is saved into a file called ``prog.py``, it can -be run at the command line and provides useful help messages: +Assuming the above Python code is saved into a file called ``prog.py``, it can +be run at the command line and it provides useful help messages: .. code-block:: shell-session @@ -119,7 +119,7 @@ the command-line integers: $ python prog.py 1 2 3 4 --sum 10 -If invalid arguments are passed in, it will issue an error: +If invalid arguments are passed in, an error will be displayed: .. code-block:: shell-session @@ -159,7 +159,7 @@ used when :meth:`~ArgumentParser.parse_args` is called. For example:: Later, calling :meth:`~ArgumentParser.parse_args` will return an object with two attributes, ``integers`` and ``accumulate``. The ``integers`` attribute -will be a list of one or more ints, and the ``accumulate`` attribute will be +will be a list of one or more integers, and the ``accumulate`` attribute will be either the :func:`sum` function, if ``--sum`` was specified at the command line, or the :func:`max` function if it was not. @@ -555,7 +555,7 @@ disallowed. fromfile_prefix_chars ^^^^^^^^^^^^^^^^^^^^^ -Sometimes, for example when dealing with a particularly long argument lists, it +Sometimes, when dealing with a particularly long argument lists, it may make sense to keep the list of arguments in a file rather than typing it out at the command line. If the ``fromfile_prefix_chars=`` argument is given to the :class:`ArgumentParser` constructor, then arguments that start with any of the @@ -1228,7 +1228,7 @@ Any container can be passed as the *choices* value, so :class:`list` objects, Use of :class:`enum.Enum` is not recommended because it is difficult to control its appearance in usage, help, and error messages. -Formatted choices overrides the default *metavar* which is normally derived +Formatted choices override the default *metavar* which is normally derived from *dest*. This is usually what you want because the user never sees the *dest* parameter. If this display isn't desirable (perhaps because there are many choices), just specify an explicit metavar_.

1 0

gh-89253: Add 3.10 whatsnew section for itertools.pairwise (GH-91563)
by miss-islington April 30, 2022

April 30, 2022

https://github.com/python/cpython/commit/5dcfb916c765d825b2e8372281d71d3231… commit: 5dcfb916c765d825b2e8372281d71d32316b41cf branch: main author: slateny <46876382+slateny(a)users.noreply.github.com> committer: miss-islington <31488909+miss-islington(a)users.noreply.github.com> date: 2022-04-30T15:14:38-07:00 summary: gh-89253: Add 3.10 whatsnew section for itertools.pairwise (GH-91563) #89253 [`pairwise()`](https://docs.python.org/3/library/itertools.html#itertools.pairwise) already has the 'new in python3.10' Automerge-Triggered-By: GH:rhettinger files: M Doc/whatsnew/3.10.rst diff --git a/Doc/whatsnew/3.10.rst b/Doc/whatsnew/3.10.rst index dd01c88d8ae66..f93523a4c50a8 100644 --- a/Doc/whatsnew/3.10.rst +++ b/Doc/whatsnew/3.10.rst @@ -1223,6 +1223,12 @@ now call :func:`inspect.get_annotations` to retrieve annotations. This means also now un-stringize stringized annotations. (Contributed by Larry Hastings in :issue:`43817`.) +itertools +--------- + +Add :func:`itertools.pairwise()`. +(Contributed by Raymond Hettinger in :issue:`38200`.) + linecache ---------

1 0

gh-85757: Change wording from nested to inner (GH-91811)
by miss-islington April 30, 2022

April 30, 2022

https://github.com/python/cpython/commit/efb87b1090a21e1be8f5f4928349eb742f… commit: efb87b1090a21e1be8f5f4928349eb742fd17f4c branch: main author: slateny <46876382+slateny(a)users.noreply.github.com> committer: miss-islington <31488909+miss-islington(a)users.noreply.github.com> date: 2022-04-30T15:12:33-07:00 summary: gh-85757: Change wording from nested to inner (GH-91811) #85757 https://docs.python.org/3/tutorial/datastructures.html#nested-list-comprehe… I do think this is clearer, but I wonder if 'nested' should be kept though to get the terminology out there more often. So perhaps it could be something like 'inner (nested) listcomp' or 'nested (inner) listcomp' despite sounding a bit redundant Automerge-Triggered-By: GH:rhettinger files: M Doc/tutorial/datastructures.rst diff --git a/Doc/tutorial/datastructures.rst b/Doc/tutorial/datastructures.rst index 927a6722ca251..f847ee325e0d7 100644 --- a/Doc/tutorial/datastructures.rst +++ b/Doc/tutorial/datastructures.rst @@ -303,7 +303,7 @@ The following list comprehension will transpose rows and columns:: >>> [[row[i] for row in matrix] for i in range(4)] [[1, 5, 9], [2, 6, 10], [3, 7, 11], [4, 8, 12]] -As we saw in the previous section, the nested listcomp is evaluated in +As we saw in the previous section, the inner list comprehension is evaluated in the context of the :keyword:`for` that follows it, so this example is equivalent to::

1 0

Fix typo in asyncio-extending.rst (#91609)
by JelleZijlstra April 30, 2022

April 30, 2022

https://github.com/python/cpython/commit/2b97d7f6dfb025c6ab8b522c26f07c6217… commit: 2b97d7f6dfb025c6ab8b522c26f07c621707731c branch: main author: Yurii Karabas <1998uriyyo(a)gmail.com> committer: JelleZijlstra <jelle.zijlstra(a)gmail.com> date: 2022-04-30T16:09:48-06:00 summary: Fix typo in asyncio-extending.rst (#91609) files: M Doc/library/asyncio-extending.rst diff --git a/Doc/library/asyncio-extending.rst b/Doc/library/asyncio-extending.rst index 215d215bb14fe..acbaa6f7faf74 100644 --- a/Doc/library/asyncio-extending.rst +++ b/Doc/library/asyncio-extending.rst @@ -63,7 +63,7 @@ For this purpose the following, *private* constructors are listed: *context* argument is added. -.. method:: Tasl._check_future(future) +.. method:: Task._check_future(future) Return ``True`` if *future* is attached to the same loop as the task, ``False`` otherwise.

1 0

gh-87801: Add run() to subprocess.CalledProcessError description (GH-91628)
by miss-islington April 30, 2022

April 30, 2022

https://github.com/python/cpython/commit/2e84e97656cf4929bc887b9a212a121383… commit: 2e84e97656cf4929bc887b9a212a12138382e807 branch: 3.9 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-04-30T14:54:58-07:00 summary: gh-87801: Add run() to subprocess.CalledProcessError description (GH-91628) (cherry picked from commit 567be058b403db9689af45bf831d4c732c8b1105) Co-authored-by: slateny <46876382+slateny(a)users.noreply.github.com> files: M Doc/library/subprocess.rst diff --git a/Doc/library/subprocess.rst b/Doc/library/subprocess.rst index f9e9f63f2151e..45eff7ffcc350 100644 --- a/Doc/library/subprocess.rst +++ b/Doc/library/subprocess.rst @@ -214,7 +214,9 @@ compatibility with older versions, see the :ref:`call-function-trio` section. .. exception:: CalledProcessError Subclass of :exc:`SubprocessError`, raised when a process run by - :func:`check_call` or :func:`check_output` returns a non-zero exit status. + :func:`check_call`, :func:`check_output`, or :func:`run` (with ``check=True``) + returns a non-zero exit status. + .. attribute:: returncode

1 0

gh-91611: Use example.com for documentation, not mydomain.com (#91613)
by JelleZijlstra April 30, 2022

April 30, 2022

https://github.com/python/cpython/commit/ea392467829d6e93f824bde8eb87bdb31d… commit: ea392467829d6e93f824bde8eb87bdb31d9e4c62 branch: main author: Motoki Naruse <motoki(a)naru.se> committer: JelleZijlstra <jelle.zijlstra(a)gmail.com> date: 2022-04-30T15:52:13-06:00 summary: gh-91611: Use example.com for documentation, not mydomain.com (#91613) example.com is reserved by the IANA as special-use domain name for documentation purposes. The domain names are used widely in books, tutorials, sample network configurations, and generally as examples for the use of domain name. On the other hand, mydomain.com is real Domain Name Registration service. files: M Doc/library/secrets.rst M Doc/library/ssl.rst diff --git a/Doc/library/secrets.rst b/Doc/library/secrets.rst index afa8e2d385fa4..c22da727b55c9 100644 --- a/Doc/library/secrets.rst +++ b/Doc/library/secrets.rst @@ -193,7 +193,7 @@ suitable for password recovery applications: .. testcode:: import secrets - url = 'https://mydomain.com/reset=' + secrets.token_urlsafe() + url = 'https://example.com/reset=' + secrets.token_urlsafe() diff --git a/Doc/library/ssl.rst b/Doc/library/ssl.rst index 04818f824d105..54bd335282699 100644 --- a/Doc/library/ssl.rst +++ b/Doc/library/ssl.rst @@ -2357,7 +2357,7 @@ waiting for clients to connect:: context.load_cert_chain(certfile="mycertfile", keyfile="mykeyfile") bindsocket = socket.socket() - bindsocket.bind(('myaddr.mydomain.com', 10023)) + bindsocket.bind(('myaddr.example.com', 10023)) bindsocket.listen(5) When a client connects, you'll call :meth:`accept` on the socket to get the

1 0

gh-87801: Add run() to subprocess.CalledProcessError description (GH-91628)
by miss-islington April 30, 2022

April 30, 2022

https://github.com/python/cpython/commit/335aae195093d89d11f4379d36c663233a… commit: 335aae195093d89d11f4379d36c663233abead61 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-04-30T14:51:45-07:00 summary: gh-87801: Add run() to subprocess.CalledProcessError description (GH-91628) (cherry picked from commit 567be058b403db9689af45bf831d4c732c8b1105) Co-authored-by: slateny <46876382+slateny(a)users.noreply.github.com> files: M Doc/library/subprocess.rst diff --git a/Doc/library/subprocess.rst b/Doc/library/subprocess.rst index ab9f1d88a0fc2..4d3312077bbd0 100644 --- a/Doc/library/subprocess.rst +++ b/Doc/library/subprocess.rst @@ -214,7 +214,9 @@ compatibility with older versions, see the :ref:`call-function-trio` section. .. exception:: CalledProcessError Subclass of :exc:`SubprocessError`, raised when a process run by - :func:`check_call` or :func:`check_output` returns a non-zero exit status. + :func:`check_call`, :func:`check_output`, or :func:`run` (with ``check=True``) + returns a non-zero exit status. + .. attribute:: returncode

1 0

gh-87192: Update wording for fcntl 'Changed in' (GH-91658)
by miss-islington April 30, 2022

April 30, 2022

https://github.com/python/cpython/commit/2830543247219427f46fa36a873eaa4b37… commit: 2830543247219427f46fa36a873eaa4b37813fa1 branch: 3.9 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-04-30T14:45:02-07:00 summary: gh-87192: Update wording for fcntl 'Changed in' (GH-91658) (cherry picked from commit d7eb1ffbe8f913693e4c9ffa1b32edccac987ab6) Co-authored-by: slateny <46876382+slateny(a)users.noreply.github.com> files: M Doc/library/fcntl.rst diff --git a/Doc/library/fcntl.rst b/Doc/library/fcntl.rst index 07a15d27216e9..f1c071ab991f7 100644 --- a/Doc/library/fcntl.rst +++ b/Doc/library/fcntl.rst @@ -37,7 +37,8 @@ descriptor. On macOS, the fcntl module exposes the ``F_GETPATH`` constant, which obtains the path of a file from a file descriptor. On Linux(>=3.15), the fcntl module exposes the ``F_OFD_GETLK``, ``F_OFD_SETLK`` - and ``F_OFD_SETLKW`` constants, which working with open file description locks. + and ``F_OFD_SETLKW`` constants, which are used when working with open file + description locks. The module defines the following functions:

1 0

gh-87192: Update wording for fcntl 'Changed in' (GH-91658)
by miss-islington April 30, 2022

April 30, 2022

https://github.com/python/cpython/commit/cfcda0acf27e40eab38c1c7c542362d872… commit: cfcda0acf27e40eab38c1c7c542362d872f6b403 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-04-30T14:44:08-07:00 summary: gh-87192: Update wording for fcntl 'Changed in' (GH-91658) (cherry picked from commit d7eb1ffbe8f913693e4c9ffa1b32edccac987ab6) Co-authored-by: slateny <46876382+slateny(a)users.noreply.github.com> files: M Doc/library/fcntl.rst diff --git a/Doc/library/fcntl.rst b/Doc/library/fcntl.rst index 9d8021150c42f..d9b579fc47d3d 100644 --- a/Doc/library/fcntl.rst +++ b/Doc/library/fcntl.rst @@ -37,7 +37,8 @@ descriptor. On macOS, the fcntl module exposes the ``F_GETPATH`` constant, which obtains the path of a file from a file descriptor. On Linux(>=3.15), the fcntl module exposes the ``F_OFD_GETLK``, ``F_OFD_SETLK`` - and ``F_OFD_SETLKW`` constants, which working with open file description locks. + and ``F_OFD_SETLKW`` constants, which are used when working with open file + description locks. .. versionchanged:: 3.10 On Linux >= 2.6.11, the fcntl module exposes the ``F_GETPIPE_SZ`` and

1 0