Mailman 3 February 2020 - Python-checkins

[3.7] bpo-3950: Fix docs for default locale used by gettext to match implementation (GH-18435) (GH-18439)
by Miss Islington (bot) Feb. 10, 2020

Feb. 10, 2020

https://github.com/python/cpython/commit/3b888ad70aaed39df1985b38b4987feb5b… commit: 3b888ad70aaed39df1985b38b4987feb5bee7981 branch: 3.7 author: Miss Islington (bot) <31488909+miss-islington(a)users.noreply.github.com> committer: GitHub <noreply(a)github.com> date: 2020-02-10T13:34:22-08:00 summary: [3.7] bpo-3950: Fix docs for default locale used by gettext to match implementation (GH-18435) (GH-18439) documentation for default locale directory Doc/library/gettext.rst changed to match gettext implementation line 63. (cherry picked from commit d68e0a8a165761604e820c8cb4f20abc735e717f) Co-authored-by: Carl <Carl-Ty(a)users.noreply.github.com> https://bugs.python.org/issue3950 Automerge-Triggered-By: @gvanrossum files: M Doc/library/gettext.rst diff --git a/Doc/library/gettext.rst b/Doc/library/gettext.rst index 94ed340a22f20..c4e04832ed5f9 100644 --- a/Doc/library/gettext.rst +++ b/Doc/library/gettext.rst @@ -652,8 +652,8 @@ implementations, and valuable experience to the creation of this module: .. [#] The default locale directory is system dependent; for example, on RedHat Linux it is :file:`/usr/share/locale`, but on Solaris it is :file:`/usr/lib/locale`. The :mod:`gettext` module does not try to support these system dependent - defaults; instead its default is :file:`{sys.prefix}/share/locale` (see - :data:`sys.prefix`). For this reason, it is always best to call + defaults; instead its default is :file:`{sys.base_prefix}/share/locale` (see + :data:`sys.base_prefix`). For this reason, it is always best to call :func:`bindtextdomain` with an explicit absolute path at the start of your application.

1 0

Issue3950: Fix docs for default locale used by gettext to match implementation (GH-18435)
by Miss Islington (bot) Feb. 10, 2020

Feb. 10, 2020

https://github.com/python/cpython/commit/a83d9108066a7a22605ba7ee962a755f4b… commit: a83d9108066a7a22605ba7ee962a755f4bec1ab1 branch: 3.8 author: Miss Islington (bot) <31488909+miss-islington(a)users.noreply.github.com> committer: GitHub <noreply(a)github.com> date: 2020-02-10T13:24:53-08:00 summary: Issue3950: Fix docs for default locale used by gettext to match implementation (GH-18435) documentation for default locale directory Doc/library/gettext.rst changed to match gettext implementation line 63. (cherry picked from commit d68e0a8a165761604e820c8cb4f20abc735e717f) Co-authored-by: Carl <Carl-Ty(a)users.noreply.github.com> files: M Doc/library/gettext.rst diff --git a/Doc/library/gettext.rst b/Doc/library/gettext.rst index 937330bb201b0..ec2c12806b416 100644 --- a/Doc/library/gettext.rst +++ b/Doc/library/gettext.rst @@ -724,8 +724,8 @@ implementations, and valuable experience to the creation of this module: .. [#] The default locale directory is system dependent; for example, on RedHat Linux it is :file:`/usr/share/locale`, but on Solaris it is :file:`/usr/lib/locale`. The :mod:`gettext` module does not try to support these system dependent - defaults; instead its default is :file:`{sys.prefix}/share/locale` (see - :data:`sys.prefix`). For this reason, it is always best to call + defaults; instead its default is :file:`{sys.base_prefix}/share/locale` (see + :data:`sys.base_prefix`). For this reason, it is always best to call :func:`bindtextdomain` with an explicit absolute path at the start of your application.

1 0

Issue3950: Fix docs for default locale used by gettext to match implementation (#18435)
by Carl Feb. 10, 2020

Feb. 10, 2020

https://github.com/python/cpython/commit/d68e0a8a165761604e820c8cb4f20abc73… commit: d68e0a8a165761604e820c8cb4f20abc735e717f branch: master author: Carl <Carl-Ty(a)users.noreply.github.com> committer: GitHub <noreply(a)github.com> date: 2020-02-10T13:15:34-08:00 summary: Issue3950: Fix docs for default locale used by gettext to match implementation (#18435) documentation for default locale directory Doc/library/gettext.rst changed to match gettext implementation line 63. files: M Doc/library/gettext.rst diff --git a/Doc/library/gettext.rst b/Doc/library/gettext.rst index 937330bb201b0..ec2c12806b416 100644 --- a/Doc/library/gettext.rst +++ b/Doc/library/gettext.rst @@ -724,8 +724,8 @@ implementations, and valuable experience to the creation of this module: .. [#] The default locale directory is system dependent; for example, on RedHat Linux it is :file:`/usr/share/locale`, but on Solaris it is :file:`/usr/lib/locale`. The :mod:`gettext` module does not try to support these system dependent - defaults; instead its default is :file:`{sys.prefix}/share/locale` (see - :data:`sys.prefix`). For this reason, it is always best to call + defaults; instead its default is :file:`{sys.base_prefix}/share/locale` (see + :data:`sys.base_prefix`). For this reason, it is always best to call :func:`bindtextdomain` with an explicit absolute path at the start of your application.

1 0

bpo-39545: docs: do not use await in f-strings (GH-18434)
by Elena Oat Feb. 10, 2020

Feb. 10, 2020

https://github.com/python/cpython/commit/a2963f09629a0a8c63e9acef79c1dcc0a0… commit: a2963f09629a0a8c63e9acef79c1dcc0a040ddb6 branch: 3.6 author: Elena Oat <oat.elena(a)gmail.com> committer: GitHub <noreply(a)github.com> date: 2020-02-10T15:28:11-05:00 summary: bpo-39545: docs: do not use await in f-strings (GH-18434) files: M Doc/reference/compound_stmts.rst diff --git a/Doc/reference/compound_stmts.rst b/Doc/reference/compound_stmts.rst index 8d050a69a931d..b4e95b90dbc70 100644 --- a/Doc/reference/compound_stmts.rst +++ b/Doc/reference/compound_stmts.rst @@ -730,7 +730,7 @@ Functions defined with ``async def`` syntax are always coroutine functions, even if they do not contain ``await`` or ``async`` keywords. It is a :exc:`SyntaxError` to use ``yield from`` expressions in -``async def`` coroutines. +``async def`` coroutines. Using ``await`` in :keyword:`f-strings` will also produce a :exc:`SyntaxError`. An example of a coroutine function::

1 0

Remove redundant references in struct doc (GH-18053)
by Christophe Nanteuil Feb. 10, 2020

Feb. 10, 2020

https://github.com/python/cpython/commit/3c5dec65e99ab7b641f1663c88e3332fff… commit: 3c5dec65e99ab7b641f1663c88e3332fff944881 branch: master author: Christophe Nanteuil <35002064+christopheNan(a)users.noreply.github.com> committer: GitHub <noreply(a)github.com> date: 2020-02-10T12:17:54-08:00 summary: Remove redundant references in struct doc (GH-18053) files: M Doc/library/struct.rst diff --git a/Doc/library/struct.rst b/Doc/library/struct.rst index 1f90e3d1ba855..856b6da8bb255 100644 --- a/Doc/library/struct.rst +++ b/Doc/library/struct.rst @@ -259,7 +259,7 @@ Notes: called to convert the argument to an integer before packing. .. versionchanged:: 3.2 - Use of the :meth:`__index__` method for non-integers is new in 3.2. + Added use of the :meth:`__index__` method for non-integers. (3) The ``'n'`` and ``'N'`` conversion codes are only available for the native @@ -312,7 +312,7 @@ When packing a value ``x`` using one of the integer formats (``'b'``, then :exc:`struct.error` is raised. .. versionchanged:: 3.1 - In 3.0, some of the integer formats wrapped out-of-range values and + Previously, some of the integer formats wrapped out-of-range values and raised :exc:`DeprecationWarning` instead of :exc:`struct.error`. The ``'p'`` format character encodes a "Pascal string", meaning a short

1 0

bpo-39369 Doc: Update mmap readline method documentation (GH-17957)
by Wellington Pardim Feb. 10, 2020

Feb. 10, 2020

https://github.com/python/cpython/commit/6c9974e12c50150149b989aaef68be1fe4… commit: 6c9974e12c50150149b989aaef68be1fe46ea670 branch: master author: Wellington Pardim <wellpardim10(a)gmail.com> committer: GitHub <noreply(a)github.com> date: 2020-02-10T12:13:41-08:00 summary: bpo-39369 Doc: Update mmap readline method documentation (GH-17957) * Update mmap readline method documentation Update mmap `readline` method description. The fact that the `readline` method does update the file position should not be ignored since this might give the impression for the programmer that it doesn't update it. * 📜🤖 Added by blurb_it. Co-authored-by: blurb-it[bot] <43283697+blurb-it[bot](a)users.noreply.github.com> files: A Misc/NEWS.d/next/Documentation/2020-01-17-13-59-21.bpo-39369.Bx5yE3.rst M Doc/library/mmap.rst diff --git a/Doc/library/mmap.rst b/Doc/library/mmap.rst index 12b14d69332d7..1f3fbc340fc26 100644 --- a/Doc/library/mmap.rst +++ b/Doc/library/mmap.rst @@ -244,7 +244,8 @@ To map anonymous memory, -1 should be passed as the fileno along with the length .. method:: readline() Returns a single line, starting at the current file position and up to the - next newline. + next newline. The file position is updated to point after the bytes that were + returned. .. method:: resize(newsize) diff --git a/Misc/NEWS.d/next/Documentation/2020-01-17-13-59-21.bpo-39369.Bx5yE3.rst b/Misc/NEWS.d/next/Documentation/2020-01-17-13-59-21.bpo-39369.Bx5yE3.rst new file mode 100644 index 0000000000000..7f41735b9d3e3 --- /dev/null +++ b/Misc/NEWS.d/next/Documentation/2020-01-17-13-59-21.bpo-39369.Bx5yE3.rst @@ -0,0 +1 @@ +Update mmap readline method description. The fact that the readline method does update the file position should not be ignored since this might give the impression for the programmer that it doesn't update it. \ No newline at end of file

1 0

bpo-39600, IDLE: Remove duplicated font names (GH-18430)
by Victor Stinner Feb. 10, 2020

Feb. 10, 2020

https://github.com/python/cpython/commit/ed335cf53b5d4bca9a08c9b83ba684ba17… commit: ed335cf53b5d4bca9a08c9b83ba684ba17be0f10 branch: master author: Victor Stinner <vstinner(a)python.org> committer: GitHub <noreply(a)github.com> date: 2020-02-10T11:41:26-08:00 summary: bpo-39600, IDLE: Remove duplicated font names (GH-18430) In the font configuration window, remove duplicated font names. files: A Misc/NEWS.d/next/IDLE/2020-02-10-17-09-48.bpo-39600.X6NsyM.rst M Lib/idlelib/configdialog.py diff --git a/Lib/idlelib/configdialog.py b/Lib/idlelib/configdialog.py index 22359735874d1..7b844f00e7736 100644 --- a/Lib/idlelib/configdialog.py +++ b/Lib/idlelib/configdialog.py @@ -607,8 +607,9 @@ def load_font_cfg(self): font_bold = configured_font[2]=='bold' # Set editor font selection list and font_name. - fonts = list(tkFont.families(self)) - fonts.sort() + fonts = tkFont.families(self) + # remove duplicated names and sort + fonts = sorted(set(fonts)) for font in fonts: self.fontlist.insert(END, font) self.font_name.set(font_name) diff --git a/Misc/NEWS.d/next/IDLE/2020-02-10-17-09-48.bpo-39600.X6NsyM.rst b/Misc/NEWS.d/next/IDLE/2020-02-10-17-09-48.bpo-39600.X6NsyM.rst new file mode 100644 index 0000000000000..102aa75f5813e --- /dev/null +++ b/Misc/NEWS.d/next/IDLE/2020-02-10-17-09-48.bpo-39600.X6NsyM.rst @@ -0,0 +1 @@ +In the font configuration window, remove duplicated font names.

1 0

Remove note saying patch is straightforward (#18431)
by Brian Curtin Feb. 10, 2020

Feb. 10, 2020

https://github.com/python/cpython/commit/e00c1d0c45975c0e9367f05f8c68bb32d6… commit: e00c1d0c45975c0e9367f05f8c68bb32d68c2fbf branch: master author: Brian Curtin <brian(a)python.org> committer: GitHub <noreply(a)github.com> date: 2020-02-10T10:47:17-07:00 summary: Remove note saying patch is straightforward (#18431) While `unittest.mock.patch` is a great thing, it is not straightforward. If it were straightforward there wouldn't be such a huge amount of documentation for it, and frankly, when myself and others who I've read about often struggle to figure out what on earth `patch()` wants, coming to the docs to read that it's straightforward is not helpful. files: M Doc/library/unittest.mock.rst diff --git a/Doc/library/unittest.mock.rst b/Doc/library/unittest.mock.rst index 515bdd060a198..3643d1ad96ed1 100644 --- a/Doc/library/unittest.mock.rst +++ b/Doc/library/unittest.mock.rst @@ -1327,8 +1327,7 @@ patch .. note:: - :func:`patch` is straightforward to use. The key is to do the patching in the - right namespace. See the section `where to patch`_. + The key is to do the patching in the right namespace. See the section `where to patch`_. .. function:: patch(target, new=DEFAULT, spec=None, create=False, spec_set=None, autospec=None, new_callable=None, **kwargs)

1 0

bpo-39586: Deprecate distutils bdist_msi command (GH-18415)
by Hugo van Kemenade Feb. 10, 2020

Feb. 10, 2020

https://github.com/python/cpython/commit/29b3fc0a18f105de666fdd586b537f34e3… commit: 29b3fc0a18f105de666fdd586b537f34e349766d branch: master author: Hugo van Kemenade <hugovk(a)users.noreply.github.com> committer: GitHub <noreply(a)github.com> date: 2020-02-10T14:26:40+01:00 summary: bpo-39586: Deprecate distutils bdist_msi command (GH-18415) files: A Misc/NEWS.d/next/Library/2020-02-08-13-37-00.bpo-39586.nfTPxX.rst M Doc/distutils/apiref.rst M Doc/distutils/builtdist.rst M Doc/whatsnew/3.9.rst M Lib/distutils/command/bdist_msi.py M Lib/distutils/tests/test_bdist_msi.py M Misc/ACKS diff --git a/Doc/distutils/apiref.rst b/Doc/distutils/apiref.rst index 12e0c0b2c9757..b14197c2f94db 100644 --- a/Doc/distutils/apiref.rst +++ b/Doc/distutils/apiref.rst @@ -1855,6 +1855,9 @@ Subclasses of :class:`Command` must define the following methods. .. class:: bdist_msi +.. deprecated:: 3.9 + Use bdist_wheel (wheel packages) instead. + Builds a `Windows Installer`_ (.msi) binary package. .. _Windows Installer: https://msdn.microsoft.com/en-us/library/cc185688(VS.85).aspx diff --git a/Doc/distutils/builtdist.rst b/Doc/distutils/builtdist.rst index b814f2e9508c9..e032c03e229a5 100644 --- a/Doc/distutils/builtdist.rst +++ b/Doc/distutils/builtdist.rst @@ -149,6 +149,9 @@ generated by each, are: .. note:: bdist_wininst is deprecated since Python 3.8. +.. note:: + bdist_msi is deprecated since Python 3.9. + The following sections give details on the individual :command:`bdist_\*` commands. @@ -304,6 +307,9 @@ Creating Windows Installers .. warning:: bdist_wininst is deprecated since Python 3.8. +.. warning:: + bdist_msi is deprecated since Python 3.9. + Executable installers are the natural format for binary distributions on Windows. They display a nice graphical user interface, display some information about the module distribution to be installed taken from the metadata in the @@ -468,3 +474,6 @@ installed for all users) and 'force' (meaning always prompt for elevation). .. note:: bdist_wininst is deprecated since Python 3.8. + +.. note:: + bdist_msi is deprecated since Python 3.9. diff --git a/Doc/whatsnew/3.9.rst b/Doc/whatsnew/3.9.rst index 4991e56759b1c..4f4c7f2808d01 100644 --- a/Doc/whatsnew/3.9.rst +++ b/Doc/whatsnew/3.9.rst @@ -398,6 +398,10 @@ Build and C API Changes Deprecated ========== +* The distutils ``bdist_msi`` command is now deprecated, use + ``bdist_wheel`` (wheel packages) instead. + (Contributed by Hugo van Kemenade in :issue:`39586`.) + * Currently :func:`math.factorial` accepts :class:`float` instances with non-negative integer values (like ``5.0``). It raises a :exc:`ValueError` for non-integral and negative floats. It is now deprecated. In future diff --git a/Lib/distutils/command/bdist_msi.py b/Lib/distutils/command/bdist_msi.py index f335a34898620..0863a1883e720 100644 --- a/Lib/distutils/command/bdist_msi.py +++ b/Lib/distutils/command/bdist_msi.py @@ -6,7 +6,9 @@ Implements the bdist_msi command. """ -import sys, os +import os +import sys +import warnings from distutils.core import Command from distutils.dir_util import remove_tree from distutils.sysconfig import get_python_version @@ -122,6 +124,12 @@ class bdist_msi(Command): '3.5', '3.6', '3.7', '3.8', '3.9'] other_version = 'X' + def __init__(self, *args, **kw): + super().__init__(*args, **kw) + warnings.warn("bdist_msi command is deprecated since Python 3.9, " + "use bdist_wheel (wheel packages) instead", + DeprecationWarning, 2) + def initialize_options(self): self.bdist_dir = None self.plat_name = None diff --git a/Lib/distutils/tests/test_bdist_msi.py b/Lib/distutils/tests/test_bdist_msi.py index 15d8bdff2b4f5..418e60ec72977 100644 --- a/Lib/distutils/tests/test_bdist_msi.py +++ b/Lib/distutils/tests/test_bdist_msi.py @@ -1,7 +1,7 @@ """Tests for distutils.command.bdist_msi.""" import sys import unittest -from test.support import run_unittest +from test.support import run_unittest, check_warnings from distutils.tests import support @@ -14,7 +14,8 @@ def test_minimal(self): # minimal test XXX need more tests from distutils.command.bdist_msi import bdist_msi project_dir, dist = self.create_dist() - cmd = bdist_msi(dist) + with check_warnings(("", DeprecationWarning)): + cmd = bdist_msi(dist) cmd.ensure_finalized() diff --git a/Misc/ACKS b/Misc/ACKS index f3e368078124d..5a779833e68be 100644 --- a/Misc/ACKS +++ b/Misc/ACKS @@ -843,6 +843,7 @@ Dmitry Kazakov Brian Kearns Sebastien Keim Ryan Kelly +Hugo van Kemenade Dan Kenigsberg Randall Kern Robert Kern diff --git a/Misc/NEWS.d/next/Library/2020-02-08-13-37-00.bpo-39586.nfTPxX.rst b/Misc/NEWS.d/next/Library/2020-02-08-13-37-00.bpo-39586.nfTPxX.rst new file mode 100644 index 0000000000000..5189f131afd98 --- /dev/null +++ b/Misc/NEWS.d/next/Library/2020-02-08-13-37-00.bpo-39586.nfTPxX.rst @@ -0,0 +1,2 @@ +The distutils ``bdist_msi`` command is deprecated in Python 3.9, use +``bdist_wheel`` (wheel packages) instead. \ No newline at end of file

1 0

Grammar fix in tutorial (GH-18425) (GH-18426)
by Miss Islington (bot) Feb. 10, 2020

Feb. 10, 2020

https://github.com/python/cpython/commit/b086ea5edc44cf64ecfb645d578927aa96… commit: b086ea5edc44cf64ecfb645d578927aa96e8c355 branch: 3.8 author: Miss Islington (bot) <31488909+miss-islington(a)users.noreply.github.com> committer: GitHub <noreply(a)github.com> date: 2020-02-10T06:40:15-05:00 summary: Grammar fix in tutorial (GH-18425) (GH-18426) (cherry picked from commit 3ed4d251587c36c3853daf42602eaad121b59bba) Co-authored-by: Don Kirkby <donkirkby(a)users.noreply.github.com> files: M Doc/tutorial/controlflow.rst diff --git a/Doc/tutorial/controlflow.rst b/Doc/tutorial/controlflow.rst index 7dfd33af25886..f05f5edd5ccc4 100644 --- a/Doc/tutorial/controlflow.rst +++ b/Doc/tutorial/controlflow.rst @@ -142,7 +142,7 @@ the list, thus saving space. We say such an object is :term:`iterable`, that is, suitable as a target for functions and constructs that expect something from which they can obtain successive items until the supply is exhausted. We have seen that -the :keyword:`for` statement is such a construct, while an example of function +the :keyword:`for` statement is such a construct, while an example of a function that takes an iterable is :func:`sum`:: >>> sum(range(4)) # 0 + 1 + 2 + 3

1 0