[Python-checkins] (no subject)
Łukasz Langa
webhook-mailer at python.org
Sun Oct 13 16:35:25 EDT 2019
To: python-checkins at python.org
Subject: Rebased version of what's new PR (GH-16745) (#16748)
Content-Type: text/plain; charset="utf-8"
Content-Transfer-Encoding: quoted-printable
MIME-Version: 1.0
https://github.com/python/cpython/commit/02d6f4f9bcf147fa34a0f5e00ffba92225c0=
ced3
commit: 02d6f4f9bcf147fa34a0f5e00ffba92225c0ced3
branch: 3.8
author: Miss Islington (bot) <31488909+miss-islington at users.noreply.github.co=
m>
committer: =C5=81ukasz Langa <lukasz at langa.pl>
date: 2019-10-13T22:35:10+02:00
summary:
Rebased version of what's new PR (GH-16745) (#16748)
* Use Unicode character for accent
* Various grammar fixes
* Sort library modules alphabetically; remove duplicated idlelib/IDLE section
(cherry picked from commit bb78f6cfa6f2b84fa4611d39c35baf1c7dce7f8d)
Co-authored-by: Andrew Kuchling <amk at amk.ca>
files:
M Doc/whatsnew/3.8.rst
diff --git a/Doc/whatsnew/3.8.rst b/Doc/whatsnew/3.8.rst
index 9bf028deaa9de..c53bffb08edea 100644
--- a/Doc/whatsnew/3.8.rst
+++ b/Doc/whatsnew/3.8.rst
@@ -82,7 +82,7 @@ Assignment expressions
----------------------
=20
There is new syntax ``:=3D`` that assigns values to variables as part of a l=
arger
-expression. It is affectionately known as "walrus operator" due to
+expression. It is affectionately known as "the walrus operator" due to
its resemblance to `the eyes and tusks of a walrus
<https://en.wikipedia.org/wiki/Walrus#/media/File:Pacific_Walrus_-_Bull_(824=
7646168).jpg>`_.
=20
@@ -620,6 +620,16 @@ where the DLL is stored (if a full or partial path is us=
ed to load the initial
DLL) and paths added by :func:`~os.add_dll_directory`.
=20
=20
+datetime
+--------
+
+Added new alternate constructors :meth:`datetime.date.fromisocalendar` and
+:meth:`datetime.datetime.fromisocalendar`, which construct :class:`date` and
+:class:`datetime` objects respectively from ISO year, week number, and weekd=
ay;
+these are the inverse of each class's ``isocalendar`` method.
+(Contributed by Paul Ganssle in :issue:`36004`.)
+
+
functools
---------
=20
@@ -637,14 +647,12 @@ than as a function returning a decorator. So both of t=
hese are now supported::
(Contributed by Raymond Hettinger in :issue:`36772`.)
=20
=20
-datetime
---------
+gc
+--
=20
-Added new alternate constructors :meth:`datetime.date.fromisocalendar` and
-:meth:`datetime.datetime.fromisocalendar`, which construct :class:`date` and
-:class:`datetime` objects respectively from ISO year, week number and weekda=
y;
-these are the inverse of each class's ``isocalendar`` method.
-(Contributed by Paul Ganssle in :issue:`36004`.)
+:func:`~gc.get_objects` can now receive an optional *generation* parameter
+indicating a generation to get objects from. Contributed in
+:issue:`36016` by Pablo Galindo.
=20
=20
gettext
@@ -654,6 +662,18 @@ Added :func:`~gettext.pgettext` and its variants.
(Contributed by Franz Glasner, =C3=89ric Araujo, and Cheryl Sabella in :issu=
e:`2504`.)
=20
=20
+gzip
+----
+
+Added the *mtime* parameter to :func:`gzip.compress` for reproducible output.
+(Contributed by Guo Ci Teo in :issue:`34898`.)
+
+A :exc:`~gzip.BadGzipFile` exception is now raised instead of :exc:`OSError`
+for certain types of invalid or corrupt gzip files.
+(Contributed by Filip Gruszczy=C5=84ski, Michele Orr=C3=B9, and Zackery Spyt=
z in
+:issue:`6584`.)
+
+
idlelib and IDLE
----------------
=20
@@ -704,44 +724,6 @@ fails. The exception is ignored silently by default in r=
elease build.
(Contributed by Victor Stinner in :issue:`18748`.)
=20
=20
-gc
---
-
-:func:`~gc.get_objects` can now receive an optional *generation* parameter
-indicating a generation to get objects from. Contributed in
-:issue:`36016` by Pablo Galindo.
-
-
-gzip
-----
-
-Added the *mtime* parameter to :func:`gzip.compress` for reproducible output.
-(Contributed by Guo Ci Teo in :issue:`34898`.)
-
-A :exc:`~gzip.BadGzipFile` exception is now raised instead of :exc:`OSError`
-for certain types of invalid or corrupt gzip files.
-(Contributed by Filip Gruszczy=C5=84ski, Michele Orr=C3=B9, and Zackery Spyt=
z in
-:issue:`6584`.)
-
-
-idlelib and IDLE
-----------------
-
-Add optional line numbers for IDLE editor windows. Windows
-open without line numbers unless set otherwise in the General
-tab of the configuration dialog.
-(Contributed by Tal Einat and Saimadhav Heblikar in :issue:`17535`.)
-
-Output over N lines (50 by default) is squeezed down to a button.
-N can be changed in the PyShell section of the General page of the
-Settings dialog. Fewer, but possibly extra long, lines can be squeezed by
-right clicking on the output. Squeezed output can be expanded in place
-by double-clicking the button or into the clipboard or a separate window
-by right-clicking the button. (Contributed by Tal Einat in :issue:`1529353`=
.)
-
-The changes above have been backported to 3.7 maintenance releases.
-
-
json.tool
---------
=20
@@ -899,18 +881,6 @@ py_compile
(Contributed by Joannah Nanjekye in :issue:`22640`.)
=20
=20
-socket
-------
-
-Added :meth:`~socket.create_server()` and :meth:`~socket.has_dualstack_ipv6(=
)`
-convenience functions to automate the necessary tasks usually involved when
-creating a server socket, including accepting both IPv4 and IPv6 connections
-on the same socket. (Contributed by Giampaolo Rodola in :issue:`17561`.)
-
-The :func:`socket.if_nameindex()`, :func:`socket.if_nametoindex()`, and
-:func:`socket.if_indextoname()` functions have been implemented on Windows.
-(Contributed by Zackery Spytz in :issue:`37007`.)
-
shlex
----------
=20
@@ -932,6 +902,19 @@ inherited from the corresponding change to the :mod:`tar=
file` module.
recursively removing their contents first.
=20
=20
+socket
+------
+
+Added :meth:`~socket.create_server()` and :meth:`~socket.has_dualstack_ipv6(=
)`
+convenience functions to automate the necessary tasks usually involved when
+creating a server socket, including accepting both IPv4 and IPv6 connections
+on the same socket. (Contributed by Giampaolo Rodol=C3=A0 in :issue:`17561`=
.)
+
+The :func:`socket.if_nameindex()`, :func:`socket.if_nametoindex()`, and
+:func:`socket.if_indextoname()` functions have been implemented on Windows.
+(Contributed by Zackery Spytz in :issue:`37007`.)
+
+
ssl
---
=20
@@ -1202,14 +1185,14 @@ Optimizations
+26% on Linux, +50% on macOS and +40% on Windows. Also, much less CPU cycl=
es
are consumed.
See :ref:`shutil-platform-dependent-efficient-copy-operations` section.
- (Contributed by Giampaolo Rodola' in :issue:`33671`.)
+ (Contributed by Giampaolo Rodol=C3=A0 in :issue:`33671`.)
=20
* :func:`shutil.copytree` uses :func:`os.scandir` function and all copy
functions depending from it use cached :func:`os.stat` values. The speedup
for copying a directory with 8000 files is around +9% on Linux, +20% on
Windows and +30% on a Windows SMB share. Also the number of :func:`os.stat`
syscalls is reduced by 38% making :func:`shutil.copytree` especially faster
- on network filesystems. (Contributed by Giampaolo Rodola' in :issue:`33695=
`.)
+ on network filesystems. (Contributed by Giampaolo Rodol=C3=A0 in :issue:`3=
3695`.)
=20
* The default protocol in the :mod:`pickle` module is now Protocol 4,
first introduced in Python 3.4. It offers better performance and smaller
@@ -1361,7 +1344,7 @@ Deprecated
(Contributed by Victor Stinner in :issue:`37481`.)
=20
* Deprecated methods ``getchildren()`` and ``getiterator()`` in
- the :mod:`~xml.etree.ElementTree` module emit now a
+ the :mod:`~xml.etree.ElementTree` module now emit a
:exc:`DeprecationWarning` instead of :exc:`PendingDeprecationWarning`.
They will be removed in Python 3.9.
(Contributed by Serhiy Storchaka in :issue:`29209`.)
@@ -1456,28 +1439,29 @@ The following features and APIs have been removed fro=
m Python 3.8:
* The :mod:`macpath` module, deprecated in Python 3.7, has been removed.
(Contributed by Victor Stinner in :issue:`35471`.)
=20
-* The function :func:`platform.popen` has been removed, it was deprecated si=
nce
- Python 3.3: use :func:`os.popen` instead.
+* The function :func:`platform.popen` has been removed, after having been
+ deprecated since Python 3.3: use :func:`os.popen` instead.
(Contributed by Victor Stinner in :issue:`35345`.)
=20
-* The function :func:`time.clock` has been removed, it was deprecated since =
Python
- 3.3: use :func:`time.perf_counter` or :func:`time.process_time` instead, d=
epending
- on your requirements, to have a well defined behavior.
+* The function :func:`time.clock` has been removed, after having been
+ deprecated since Python 3.3: use :func:`time.perf_counter` or
+ :func:`time.process_time` instead, depending
+ on your requirements, to have well-defined behavior.
(Contributed by Matthias Bussonnier in :issue:`36895`.)
=20
* The ``pyvenv`` script has been removed in favor of ``python3.8 -m venv``
to help eliminate confusion as to what Python interpreter the ``pyvenv``
script is tied to. (Contributed by Brett Cannon in :issue:`25427`.)
=20
-* ``parse_qs``, ``parse_qsl``, and ``escape`` are removed from :mod:`cgi`
- module. They are deprecated from Python 3.2 or older. They should be impo=
rted
+* ``parse_qs``, ``parse_qsl``, and ``escape`` are removed from the :mod:`cgi`
+ module. They are deprecated in Python 3.2 or older. They should be import=
ed
from the ``urllib.parse`` and ``html`` modules instead.
=20
-* ``filemode`` function is removed from :mod:`tarfile` module.
+* ``filemode`` function is removed from the :mod:`tarfile` module.
It is not documented and deprecated since Python 3.3.
=20
* The :class:`~xml.etree.ElementTree.XMLParser` constructor no longer accepts
- the *html* argument. It never had effect and was deprecated in Python 3.4.
+ the *html* argument. It never had an effect and was deprecated in Python =
3.4.
All other parameters are now :ref:`keyword-only <keyword-only_parameter>`.
(Contributed by Serhiy Storchaka in :issue:`29209`.)
=20
@@ -1536,8 +1520,8 @@ Changes in Python behavior
=20
* On AIX, :attr:`sys.platform` doesn't contain the major version anymore.
It is always ``'aix'``, instead of ``'aix3'`` .. ``'aix7'``. Since
- older Python versions include the version number, it is recommended to
- always use the ``sys.platform.startswith('aix')``.
+ older Python versions include the version number, so it is recommended to
+ always use ``sys.platform.startswith('aix')``.
(Contributed by M. Felt in :issue:`36588`.)
=20
* :c:func:`PyEval_AcquireLock` and :c:func:`PyEval_AcquireThread` now
@@ -1557,8 +1541,8 @@ Changes in the Python API
=20
* :class:`subprocess.Popen` can now use :func:`os.posix_spawn` in some cases
for better performance. On Windows Subsystem for Linux and QEMU User
- Emulation, Popen constructor using :func:`os.posix_spawn` no longer raise =
an
- exception on errors like missing program, but the child process fails with=
a
+ Emulation, the :class:`Popen` constructor using :func:`os.posix_spawn` no =
longer raises an
+ exception on errors like "missing program". Instead the child process fai=
ls with a
non-zero :attr:`~Popen.returncode`.
(Contributed by Joannah Nanjekye and Victor Stinner in :issue:`35537`.)
=20
@@ -1571,7 +1555,7 @@ Changes in the Python API
* The :meth:`imap.IMAP4.logout` method no longer ignores silently arbitrary
exceptions.
=20
-* The function :func:`platform.popen` has been removed, it was deprecated si=
nce
+* The function :func:`platform.popen` has been removed, after having been de=
precated since
Python 3.3: use :func:`os.popen` instead.
(Contributed by Victor Stinner in :issue:`35345`.)
=20
@@ -1586,9 +1570,9 @@ Changes in the Python API
specialized methods like :meth:`~tkinter.ttk.Treeview.selection_set` for
changing the selection. (Contributed by Serhiy Storchaka in :issue:`31508=
`.)
=20
-* The :meth:`writexml`, :meth:`toxml` and :meth:`toprettyxml` methods of the
- :mod:`xml.dom.minidom` module, and :mod:`xml.etree` now preserve the attri=
bute
- order specified by the user.
+* The :meth:`writexml`, :meth:`toxml` and :meth:`toprettyxml` methods of
+ :mod:`xml.dom.minidom`, and the :meth:`write` method of :mod:`xml.etree`,
+ now preserve the attribute order specified by the user.
(Contributed by Diego Rojas and Raymond Hettinger in :issue:`34160`.)
=20
* A :mod:`dbm.dumb` database opened with flags ``'r'`` is now read-only.
@@ -1598,7 +1582,7 @@ Changes in the Python API
=20
* The ``doctype()`` method defined in a subclass of
:class:`~xml.etree.ElementTree.XMLParser` will no longer be called and will
- cause emitting a :exc:`RuntimeWarning` instead of a :exc:`DeprecationWarni=
ng`.
+ emit a :exc:`RuntimeWarning` instead of a :exc:`DeprecationWarning`.
Define the :meth:`doctype() <xml.etree.ElementTree.TreeBuilder.doctype>`
method on a target for handling an XML doctype declaration.
(Contributed by Serhiy Storchaka in :issue:`29209`.)
@@ -1641,7 +1625,7 @@ Changes in the Python API
=20
* The :meth:`mmap.flush() <mmap.mmap.flush>` method now returns ``None`` on
success and raises an exception on error under all platforms. Previously,
- its behavior was platform-depended: a nonzero value was returned on succes=
s;
+ its behavior was platform-dependent: a nonzero value was returned on succe=
ss;
zero was returned on error under Windows. A zero value was returned on
success; an exception was raised on error under Unix.
(Contributed by Berker Peksag in :issue:`2122`.)
@@ -1685,7 +1669,7 @@ Changes in the Python API
* :class:`types.CodeType` has a new parameter in the second position of the
constructor (*posonlyargcount*) to support positional-only arguments defin=
ed
in :pep:`570`. The first argument (*argcount*) now represents the total
- number of positional arguments (including positional-only arguments). A new
+ number of positional arguments (including positional-only arguments). The =
new
``replace()`` method of :class:`types.CodeType` can be used to make the co=
de
future-proof.
=20
@@ -1693,9 +1677,9 @@ Changes in the Python API
Changes in the C API
--------------------
=20
-* The :c:type:`PyCompilerFlags` structure gets a new *cf_feature_version*
+* The :c:type:`PyCompilerFlags` structure got a new *cf_feature_version*
field. It should be initialized to ``PY_MINOR_VERSION``. The field is igno=
red
- by default, it is used if and only if ``PyCF_ONLY_AST`` flag is set in
+ by default, and is used if and only if ``PyCF_ONLY_AST`` flag is set in
*cf_flags*.
=20
* The :c:func:`PyEval_ReInitThreads` function has been removed from the C AP=
I.
More information about the Python-checkins
mailing list