traverseda
/
cpython
1
0
Fork 0
Code Issues Pull Requests Releases Wiki Activity

whatsnew/3.5: Fix formatting. More minor edits.

This commit is contained in:
Serhiy Storchaka 2015-09-13 12:07:54 +03:00
parent 3854f9e9fe
commit 35a361f1af
1 changed files with 23 additions and 23 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

46
Doc/whatsnew/3.5.rst
View File

@ -683,13 +683,13 @@ Some smaller changes made to the core Python language are:
* New Kazakh :ref:`codec <standard-encodings>` ``kz1048``. (Contributed by * New Kazakh :ref:`codec <standard-encodings>` ``kz1048``. (Contributed by
Serhiy Storchaka in :issue:`22682`.) Serhiy Storchaka in :issue:`22682`.)
* New Tajik :ref:`codec <standard-encodings>` ``koi8_t``. (Contributed by
Serhiy Storchaka in :issue:`22681`.)
* Property docstrings are now writable. This is especially useful for * Property docstrings are now writable. This is especially useful for
:func:`collections.namedtuple` docstrings. :func:`collections.namedtuple` docstrings.
(Contributed by Berker Peksag in :issue:`24064`.) (Contributed by Berker Peksag in :issue:`24064`.)
* New Tajik :ref:`codec <standard-encodings>` ``koi8_t``. (Contributed by
Serhiy Storchaka in :issue:`22681`.)
* Circular imports involving relative imports are now supported. * Circular imports involving relative imports are now supported.
(Contributed by Brett Cannon and Antoine Pitrou in :issue:`17636`.) (Contributed by Brett Cannon and Antoine Pitrou in :issue:`17636`.)
@ -802,14 +802,14 @@ size of decompressed data. (Contributed by Nikolaus Rath in :issue:`15955`.)
cgi cgi
--- ---
The :class:`~cgi.FieldStorage` class now supports the context management The :class:`~cgi.FieldStorage` class now supports the :term:`context manager`
protocol. (Contributed by Berker Peksag in :issue:`20289`.) protocol. (Contributed by Berker Peksag in :issue:`20289`.)
csv csv
--- ---
:meth:`Writer.writerow <csv.Writer.writerow>` now supports arbitrary iterables, The :meth:`~csv.csvwriter.writerow` method now supports arbitrary iterables,
not just sequences. (Contributed by Serhiy Storchaka in :issue:`23171`.) not just sequences. (Contributed by Serhiy Storchaka in :issue:`23171`.)
@ -885,7 +885,7 @@ New :class:`~collections.abc.Awaitable` :class:`~collections.abc.Coroutine`,
compileall compileall
---------- ----------
A new :mod:`compileall` option, ``-j N``, allows to run ``N`` workers A new :mod:`compileall` option, :samp:`-j {N}`, allows to run *N* workers
sumultaneously to perform parallel bytecode compilation. sumultaneously to perform parallel bytecode compilation.
The :func:`~compileall.compile_dir` function has a corresponding ``workers`` The :func:`~compileall.compile_dir` function has a corresponding ``workers``
parameter. (Contributed by Claudiu Popa in :issue:`16104`.) parameter. (Contributed by Claudiu Popa in :issue:`16104`.)
@ -909,7 +909,7 @@ The :meth:`Executor.map <concurrent.futures.Executor.map>` method now accepts a
:meth:`~concurrent.futures.ProcessPoolExecutor` is used. :meth:`~concurrent.futures.ProcessPoolExecutor` is used.
(Contributed by Dan O'Reilly in :issue:`11271`.) (Contributed by Dan O'Reilly in :issue:`11271`.)
A number of workers in :class:`~concurrent.futures.ThreadPoolExecutor` is A number of workers in :class:`~concurrent.futures.ThreadPoolExecutor` constructor is
optional now. The default value equals to 5 times the number of CPUs. optional now. The default value equals to 5 times the number of CPUs.
(Contributed by Claudiu Popa in :issue:`21527`.) (Contributed by Claudiu Popa in :issue:`21527`.)
@ -943,7 +943,7 @@ Example::
contextlib contextlib
---------- ----------
The new :func:`~contextlib.redirect_stderr` context manager (similar to The new :func:`~contextlib.redirect_stderr` :term:`context manager` (similar to
:func:`~contextlib.redirect_stdout`) makes it easier for utility scripts to :func:`~contextlib.redirect_stdout`) makes it easier for utility scripts to
handle inflexible APIs that write their output to :data:`sys.stderr` and handle inflexible APIs that write their output to :data:`sys.stderr` and
don't provide any options to redirect it:: don't provide any options to redirect it::
@ -1031,7 +1031,7 @@ of using encoded words. This allows ``Messages`` to be formatted according to
``SMTPUTF8`` extension. (Contributed by R. David Murray in ``SMTPUTF8`` extension. (Contributed by R. David Murray in
:issue:`24211`.) :issue:`24211`.)
:class:`email.mime.text.MIMEText` constructor now accepts a :class:`~email.mime.text.MIMEText` constructor now accepts a
:class:`~email.charset.Charset` instance. :class:`~email.charset.Charset` instance.
(Contributed by Claude Paroz and Berker Peksag in :issue:`16324`.) (Contributed by Claude Paroz and Berker Peksag in :issue:`16324`.)
@ -1143,13 +1143,13 @@ Since idlelib implements the IDLE shell and editor and is not intended for
import by other programs, it gets improvements with every release. See import by other programs, it gets improvements with every release. See
:file:`Lib/idlelib/NEWS.txt` for a cumulative list of changes since 3.4.0, :file:`Lib/idlelib/NEWS.txt` for a cumulative list of changes since 3.4.0,
as well as changes made in future 3.5.x releases. This file is also available as well as changes made in future 3.5.x releases. This file is also available
from the IDLE Help -> About Idle dialog. from the IDLE :menuselection:`Help --> About IDLE` dialog.
imaplib imaplib
------- -------
The :class:`~imaplib.IMAP4` class now supports context manager protocol. The :class:`~imaplib.IMAP4` class now supports :term:`context manager` protocol.
When used in a :keyword:`with` statement, the IMAP4 ``LOGOUT`` When used in a :keyword:`with` statement, the IMAP4 ``LOGOUT``
command will be called automatically at the end of the block. command will be called automatically at the end of the block.
(Contributed by Tarek Ziadé and Serhiy Storchaka in :issue:`4972`.) (Contributed by Tarek Ziadé and Serhiy Storchaka in :issue:`4972`.)
@ -1220,7 +1220,7 @@ A new class method
subclassing of :class:`~inspect.Signature` easier. (Contributed subclassing of :class:`~inspect.Signature` easier. (Contributed
by Yury Selivanov and Eric Snow in :issue:`17373`.) by Yury Selivanov and Eric Snow in :issue:`17373`.)
The :func:`~inspect.signature` function now accepts a ``follow_wrapped`` The :func:`~inspect.signature` function now accepts a *follow_wrapped*
optional keyword argument, which, when set to ``False``, disables automatic optional keyword argument, which, when set to ``False``, disables automatic
following of ``__wrapped__`` links. following of ``__wrapped__`` links.
(Contributed by Yury Selivanov in :issue:`20691`.) (Contributed by Yury Selivanov in :issue:`20691`.)
@ -1264,7 +1264,7 @@ network objects from existing addresses::
(Contributed by Peter Moody and Antoine Pitrou in :issue:`16531`.) (Contributed by Peter Moody and Antoine Pitrou in :issue:`16531`.)
A new :attr:`~ipaddress.IPv4Network.reverse_pointer>` attribute for A new :attr:`~ipaddress.IPv4Network.reverse_pointer` attribute for
:class:`~ipaddress.IPv4Network` and :class:`~ipaddress.IPv6Network` classes :class:`~ipaddress.IPv4Network` and :class:`~ipaddress.IPv6Network` classes
returns the name of the reverse DNS PTR record:: returns the name of the reverse DNS PTR record::
@ -1287,7 +1287,7 @@ JSON objects passed in input. The new ``--sort-keys`` option can be used
to sort the keys alphabetically. (Contributed by Berker Peksag to sort the keys alphabetically. (Contributed by Berker Peksag
in :issue:`21650`.) in :issue:`21650`.)
JSON decoder now raises :exc:`json.JSONDecodeError` instead of JSON decoder now raises :exc:`~json.JSONDecodeError` instead of
:exc:`ValueError` to provide better context information about the error. :exc:`ValueError` to provide better context information about the error.
(Contributed by Serhiy Storchaka in :issue:`19361`.) (Contributed by Serhiy Storchaka in :issue:`19361`.)
@ -1327,7 +1327,7 @@ logging
All logging methods (:class:`~logging.Logger` :meth:`~logging.Logger.log`, All logging methods (:class:`~logging.Logger` :meth:`~logging.Logger.log`,
:meth:`~logging.Logger.exception`, :meth:`~logging.Logger.critical`, :meth:`~logging.Logger.exception`, :meth:`~logging.Logger.critical`,
:meth:`~logging.Logger.debug`, etc.), now accept exception instances :meth:`~logging.Logger.debug`, etc.), now accept exception instances
as an ``exc_info`` argument, in addition to boolean values and exception as an *exc_info* argument, in addition to boolean values and exception
tuples:: tuples::
>>> import logging >>> import logging
@ -1451,7 +1451,7 @@ either an another :class:`~pathlib.Path` object, or a string::
(Contributed by Vajrasky Kok and Antoine Pitrou in :issue:`19775`.) (Contributed by Vajrasky Kok and Antoine Pitrou in :issue:`19775`.)
The :meth:`Path.mkdir <pathlib.Path.mkdir>` method how accepts a new optional The :meth:`Path.mkdir <pathlib.Path.mkdir>` method how accepts a new optional
``exist_ok`` argument to match ``mkdir -p`` and :func:`os.makrdirs` *exist_ok* argument to match ``mkdir -p`` and :func:`os.makrdirs`
functionality. (Contributed by Berker Peksag in :issue:`21539`.) functionality. (Contributed by Berker Peksag in :issue:`21539`.)
There is a new :meth:`Path.expanduser <pathlib.Path.expanduser>` method to There is a new :meth:`Path.expanduser <pathlib.Path.expanduser>` method to
@ -1595,14 +1595,14 @@ The :class:`~smtpd.SMTPServer` class now advertises the ``8BITMIME`` extension
(:rfc:`6152`) if *decode_data* has been set ``True``. If the client (:rfc:`6152`) if *decode_data* has been set ``True``. If the client
specifies ``BODY=8BITMIME`` on the ``MAIL`` command, it is passed to specifies ``BODY=8BITMIME`` on the ``MAIL`` command, it is passed to
:meth:`SMTPServer.process_message <smtpd.SMTPServer.process_message>` :meth:`SMTPServer.process_message <smtpd.SMTPServer.process_message>`
via the ``mail_options`` keyword. via the *mail_options* keyword.
(Contributed by Milan Oberkirch and R. David Murray in :issue:`21795`.) (Contributed by Milan Oberkirch and R. David Murray in :issue:`21795`.)
The :class:`~smtpd.SMTPServer` class now also supports the ``SMTPUTF8`` The :class:`~smtpd.SMTPServer` class now also supports the ``SMTPUTF8``
extension (:rfc:`6531`: Internationalized Email). If the client specified extension (:rfc:`6531`: Internationalized Email). If the client specified
``SMTPUTF8 BODY=8BITMIME`` on the ``MAIL`` command, they are passed to ``SMTPUTF8 BODY=8BITMIME`` on the ``MAIL`` command, they are passed to
:meth:`SMTPServer.process_message <smtpd.SMTPServer.process_message>` :meth:`SMTPServer.process_message <smtpd.SMTPServer.process_message>`
via the ``mail_options`` keyword. It is the responsibility of the via the *mail_options* keyword. It is the responsibility of the
:meth:`~smtpd.SMTPServer.process_message` method to correctly handle the :meth:`~smtpd.SMTPServer.process_message` method to correctly handle the
``SMTPUTF8`` data. (Contributed by Milan Oberkirch in :issue:`21725`.) ``SMTPUTF8`` data. (Contributed by Milan Oberkirch in :issue:`21725`.)
@ -1840,7 +1840,7 @@ The :func:`~time.monotonic` function is now always available.
timeit timeit
------ ------
A new command line option ``-u`` or ``--unit=U`` can be used to specify the time A new command line option ``-u`` or :samp:`--unit={U}` can be used to specify the time
unit for the timer output. Supported options are ``usec``, ``msec``, unit for the timer output. Supported options are ``usec``, ``msec``,
or ``sec``. (Contributed by Julian Gindi in :issue:`18983`.) or ``sec``. (Contributed by Julian Gindi in :issue:`18983`.)
@ -1868,7 +1868,7 @@ functions to conveniently traverse frame and traceback objects.
(Contributed by Robert Collins in :issue:`17911`.) (Contributed by Robert Collins in :issue:`17911`.)
New lightweight classes: :class:`~traceback.TracebackException`, New lightweight classes: :class:`~traceback.TracebackException`,
:class:`~traceback.StackSummary`, and :class:`traceback.FrameSummary`. :class:`~traceback.StackSummary`, and :class:`~traceback.FrameSummary`.
(Contributed by Robert Collins in :issue:`17911`.) (Contributed by Robert Collins in :issue:`17911`.)
Both :func:`~traceback.print_tb` and :func:`~traceback.print_stack` functions Both :func:`~traceback.print_tb` and :func:`~traceback.print_stack` functions
@ -1978,8 +1978,8 @@ class constructor is now optional.
xmlrpc xmlrpc
------ ------
The :class:`client.ServerProxy <xmlrpc.client.ServerProxy>` class is now a The :class:`client.ServerProxy <xmlrpc.client.ServerProxy>` class now supports
:term:`context manager`. :term:`context manager` protocol.
(Contributed by Claudiu Popa in :issue:`20627`.) (Contributed by Claudiu Popa in :issue:`20627`.)
:class:`client.ServerProxy <xmlrpc.client.ServerProxy>` constructor now accepts :class:`client.ServerProxy <xmlrpc.client.ServerProxy>` constructor now accepts
@ -2252,7 +2252,7 @@ The :mod:`inspect` :func:`~inspect.getfullargspec`,
:func:`inspect.signature` API. :func:`inspect.signature` API.
(Contributed by Yury Selivanov in :issue:`20438`.) (Contributed by Yury Selivanov in :issue:`20438`.)
Use of ``re.LOCALE`` flag with str patterns or ``re.ASCII`` is now Use of :const:`re.LOCALE` flag with str patterns or :const:`re.ASCII` is now
deprecated. (Contributed by Serhiy Storchaka in :issue:`22407`.) deprecated. (Contributed by Serhiy Storchaka in :issue:`22407`.)
Use of unrecognized special sequences consisting of ``'\'`` and an ASCII letter Use of unrecognized special sequences consisting of ``'\'`` and an ASCII letter