* New Kazakh :ref:`codec <standard-encodings>` ``kz1048``. (Contributed by
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
:func:`collections.namedtuple` docstrings.
(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.
(Contributed by Brett Cannon and Antoine Pitrou in :issue:`17636`.)
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`.)
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`.)
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.
The :func:`~compileall.compile_dir` function has a corresponding ``workers``
parameter. (Contributed by Claudiu Popa in :issue:`16104`.)
:meth:`~concurrent.futures.ProcessPoolExecutor` is used.
(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.
(Contributed by Claudiu Popa in :issue:`21527`.)
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
handle inflexible APIs that write their output to :data:`sys.stderr` and
don't provide any options to redirect it::
``SMTPUTF8`` extension. (Contributed by R. David Murray in
: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.
(Contributed by Claude Paroz and Berker Peksag in :issue:`16324`.)
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,
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
-------
-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``
command will be called automatically at the end of the block.
(Contributed by Tarek Ziadé and Serhiy Storchaka in :issue:`4972`.)
subclassing of :class:`~inspect.Signature` easier. (Contributed
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
following of ``__wrapped__`` links.
(Contributed by Yury Selivanov in :issue:`20691`.)
(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
returns the name of the reverse DNS PTR record::
to sort the keys alphabetically. (Contributed by Berker Peksag
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.
(Contributed by Serhiy Storchaka in :issue:`19361`.)
All logging methods (:class:`~logging.Logger` :meth:`~logging.Logger.log`,
:meth:`~logging.Logger.exception`, :meth:`~logging.Logger.critical`,
: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::
>>> import logging
(Contributed by Vajrasky Kok and Antoine Pitrou in :issue:`19775`.)
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`.)
There is a new :meth:`Path.expanduser <pathlib.Path.expanduser>` method to
(:rfc:`6152`) if *decode_data* has been set ``True``. If the client
specifies ``BODY=8BITMIME`` on the ``MAIL`` command, it is passed to
: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`.)
The :class:`~smtpd.SMTPServer` class now also supports the ``SMTPUTF8``
extension (:rfc:`6531`: Internationalized Email). If the client specified
``SMTPUTF8 BODY=8BITMIME`` on the ``MAIL`` command, they are passed to
: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
``SMTPUTF8`` data. (Contributed by Milan Oberkirch in :issue:`21725`.)
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``,
or ``sec``. (Contributed by Julian Gindi in :issue:`18983`.)
(Contributed by Robert Collins in :issue:`17911`.)
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`.)
Both :func:`~traceback.print_tb` and :func:`~traceback.print_stack` functions
xmlrpc
------
-The :class:`client.ServerProxy <xmlrpc.client.ServerProxy>` class is now a
-:term:`context manager`.
+The :class:`client.ServerProxy <xmlrpc.client.ServerProxy>` class now supports
+:term:`context manager` protocol.
(Contributed by Claudiu Popa in :issue:`20627`.)
:class:`client.ServerProxy <xmlrpc.client.ServerProxy>` constructor now accepts
:func:`inspect.signature` API.
(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`.)
Use of unrecognized special sequences consisting of ``'\'`` and an ASCII letter
projects / python / commitdiff