whatsnew/3.5: Fix library news till Py3.5a1. Update other docs.

This commit is contained in:
Yury Selivanov 2015-09-08 22:40:30 -04:00
parent dfcfe13300
commit 100fc3fbc2
4 changed files with 185 additions and 14 deletions

View File

@ -88,14 +88,12 @@ compile Python sources.
Added the ``-i``, ``-b`` and ``-h`` options.
.. versionchanged:: 3.5
Added the ``-j`` and ``-r`` options.
.. versionchanged:: 3.5
``-q`` option was changed to a multilevel value.
.. versionchanged:: 3.5
``-b`` will always produce a byte-code file ending in ``.pyc``, never
``.pyo``.
* Added the ``-j`` and ``-r`` options.
* ``-q`` option was changed to a multilevel value.
* ``-qq`` option.
* ``-b`` will always produce a byte-code file ending in ``.pyc``,
never ``.pyo``.
There is no command-line option to control the optimization level used by the

View File

@ -54,10 +54,8 @@ from :func:`what`:
+------------+-----------------------------------+
.. versionadded:: 3.5
The *exr* format was added.
The *exr* and *webp* formats were added.
.. versionchanged:: 3.5
The *webp* type was added.
You can extend the list of file types :mod:`imghdr` can recognize by appending
to this variable:

View File

@ -1039,6 +1039,11 @@ line.
returned list represents *frame*; the last entry represents the outermost call
on *frame*'s stack.
.. versionchanged:: 3.5
A list of :term:`named tuples <named tuple>`
``FrameInfo(frame, filename, lineno, function, code_context, index)``
is returned.
.. function:: getinnerframes(traceback, context=1)
@ -1047,6 +1052,11 @@ line.
list represents *traceback*; the last entry represents where the exception was
raised.
.. versionchanged:: 3.5
A list of :term:`named tuples <named tuple>`
``FrameInfo(frame, filename, lineno, function, code_context, index)``
is returned.
.. function:: currentframe()
@ -1066,6 +1076,11 @@ line.
returned list represents the caller; the last entry represents the outermost
call on the stack.
.. versionchanged:: 3.5
A list of :term:`named tuples <named tuple>`
``FrameInfo(frame, filename, lineno, function, code_context, index)``
is returned.
.. function:: trace(context=1)
@ -1074,6 +1089,11 @@ line.
entry in the list represents the caller; the last entry represents where the
exception was raised.
.. versionchanged:: 3.5
A list of :term:`named tuples <named tuple>`
``FrameInfo(frame, filename, lineno, function, code_context, index)``
is returned.
Fetching attributes statically
------------------------------

View File

@ -122,7 +122,14 @@ Significantly Improved Library Modules:
Security improvements:
* None yet.
* SSLv3 is now disabled throughout the standard library.
It can still be enabled by instantiating a :class:`ssl.SSLContext`
manually. (See :issue:`22638` for more details; this change was
backported to CPython 3.4 and 2.7.)
* HTTP cookie parsing is now stricter, in order to protect
against potential injection attacks. (Contributed by Antoine Pitrou
in :issue:`22796`.)
Windows improvements:
@ -606,6 +613,13 @@ argparse
:ref:`allow_abbrev` to ``False``.
(Contributed by Jonathan Paugh, Steven Bethard, paul j3 and Daniel Eriksson.)
bz2
---
* New option *max_length* for :meth:`~bz2.BZ2Decompressor.decompress`
to limit the maximum size of decompressed data.
(Contributed by Nikolaus Rath in :issue:`15955`.)
cgi
---
@ -645,6 +659,20 @@ compileall
can now do parallel bytecode compilation.
(Contributed by Claudiu Popa in :issue:`16104`.)
* *quiet* parameter of :func:`compileall.compile_dir`,
:func:`compileall.compile_file`, and :func:`compileall.compile_path`
functions now has a multilevel value. New ``-qq`` command line option
is available for suppressing the output.
(Contributed by Thomas Kluyver in :issue:`21338`.)
concurrent.futures
------------------
* :meth:`~concurrent.futures.Executor.map` now takes a *chunksize*
argument to allow batching of tasks in child processes and improve
performance of ProcessPoolExecutor.
(Contributed by Dan O'Reilly in :issue:`11271`.)
contextlib
----------
@ -714,6 +742,12 @@ glob
subdirectories using the "``**``" pattern.
(Contributed by Serhiy Storchaka in :issue:`13968`.)
heapq
-----
* :func:`~heapq.merge` has two new optional parameters ``reverse`` and
``key``. (Contributed by Raymond Hettinger in :issue:`13742`.)
idlelib and IDLE
----------------
@ -746,7 +780,9 @@ imghdr
------
* :func:`~imghdr.what` now recognizes the `OpenEXR <http://www.openexr.com>`_
format. (Contributed by Martin Vignali and Claudiu Popa in :issue:`20295`.)
format (contributed by Martin Vignali and Claudiu Popa in :issue:`20295`),
and the `WebP <https://en.wikipedia.org/wiki/WebP>`_ format (contributed
by Fabrice Aneche and Claudiu Popa in :issue:`20197`.)
importlib
---------
@ -763,6 +799,7 @@ importlib
* :func:`importlib.util.module_from_spec` is now the preferred way to create a
new module. Compared to :class:`types.ModuleType`, this new function will set
the various import-controlled attributes based on the passed-in spec object.
(Contributed by Brett Cannon in :issue:`20383`.)
inspect
-------
@ -788,6 +825,10 @@ inspect
* New :func:`~inspect.getcoroutinelocals` and :func:`~inspect.getcoroutinestate`
functions. (Contributed by Yury Selivanov in :issue:`24400`.)
* :func:`~inspect.stack`, :func:`~inspect.trace`, :func:`~inspect.getouterframes`,
and :func:`~inspect.getinnerframes` now return a list of named tuples.
(Contributed by Daniel Shahaf in :issue:`16808`.)
ipaddress
---------
@ -807,6 +848,35 @@ json
* JSON decoder now raises :exc:`json.JSONDecodeError` instead of
:exc:`ValueError`. (Contributed by Serhiy Storchaka in :issue:`19361`.)
locale
------
* New :func:`~locale.delocalize` function to convert a string into a
normalized number string, following the ``LC_NUMERIC`` settings.
(Contributed by Cédric Krier in :issue:`13918`.)
logging
-------
* All logging methods :meth:`~logging.Logger.log`, :meth:`~logging.Logger.exception`,
:meth:`~logging.Logger.critical`, :meth:`~logging.Logger.debug`, etc,
now accept exception instances for ``exc_info`` parameter, in addition
to boolean values and exception tuples.
(Contributed by Yury Selivanov in :issue:`20537`.)
* :class:`~logging.handlers.HTTPHandler` now accepts optional
:class:`ssl.SSLContext` instance to configure the SSL settings used
for HTTP connection.
(Contributed by Alex Gaynor in :issue:`22788`.)
lzma
----
* New option *max_length* for :meth:`~lzma.LZMADecompressor.decompress`
to limit the maximum size of decompressed data.
(Contributed by Martin Panter in :issue:`15955`.)
math
----
@ -832,6 +902,10 @@ os
function is now used. These functions avoid the usage of an internal file
descriptor.
* New :func:`os.get_blocking` and :func:`os.set_blocking` functions to
get and set the blocking mode of file descriptors.
(Contributed by Victor Stinner in :issue:`22054`.)
os.path
-------
@ -839,6 +913,25 @@ os.path
Unlike the :func:`~os.path.commonprefix` function, it always returns a valid
path. (Contributed by Rafik Draoui and Serhiy Storchaka in :issue:`10395`.)
pathlib
-------
* New :meth:`~pathlib.Path.samefile` method to check if other path object
points to the same file. (Contributed by Vajrasky Kok and Antoine Pitrou
in :issue:`19775`.)
* :meth:`~pathlib.Path.mkdir` has a new optional parameter ``exist_ok``
to mimic ``mkdir -p`` and :func:`os.makrdirs` functionality.
(Contributed by Berker Peksag in :issue:`21539`.)
* New :meth:`~pathlib.Path.expanduser` to expand ``~`` and ``~user``
constructs.
(Contributed by Serhiy Storchaka and Claudiu Popa in :issue:`19776`.)
* New class method :meth:`~pathlib.Path.home` to get an instance of
:class:`~pathlib.Path` object representing the users home directory.
(Contributed by Victor Salgado and Mayank Tripathi in :issue:`19777`.)
pickle
------
@ -862,6 +955,12 @@ re
* Now unmatched groups are replaced with empty strings in :func:`re.sub`
and :func:`re.subn`. (Contributed by Serhiy Storchaka in :issue:`1519638`.)
readline
--------
* New :func:`~readline.append_history_file` function.
(Contributed by Bruno Cauet in :issue:`22940`.)
shutil
------
@ -870,6 +969,9 @@ shutil
:func:`~shutil.copy2` if there is a need to ignore metadata. (Contributed by
Claudiu Popa in :issue:`19840`.)
* :func:`~shutil.make_archive` now supports *xztar* format.
(Contributed by Serhiy Storchaka in :issue:`5411`.)
signal
------
@ -948,6 +1050,14 @@ ssl
:meth:`SSLContext.wrap_bio <ssl.SSLContext.wrap_bio>` method.
(Contributed by Geert Jansen in :issue:`21965`.)
* New :meth:`~ssl.SSLSocket.version` to query the actual protocol version
in use. (Contributed by Antoine Pitrou in :issue:`20421`.)
* New :meth:`~ssl.SSLObject.shared_ciphers` and
:meth:`~ssl.SSLSocket.shared_ciphers` methods to fetch the client's
list of ciphers sent at handshake.
(Contributed by Benjamin Peterson in :issue:`23186`.)
socket
------
@ -961,6 +1071,9 @@ socket
anymore each time bytes are received or sent. The socket timeout is now the
maximum total duration to send all data.
* Functions with timeouts now use a monotonic clock, instead of a
system clock. (Contributed by Victor Stinner in :issue:`22043`.)
subprocess
----------
@ -975,6 +1088,9 @@ sys
* New :func:`~sys.set_coroutine_wrapper` and :func:`~sys.get_coroutine_wrapper`
functions. (Contributed by Yury Selivanov in :issue:`24017`.)
* New :func:`~sys.is_finalizing` to check for :term:`interpreter shutdown`.
(Contributed by Antoine Pitrou in :issue:`22696`.)
sysconfig
---------
@ -994,6 +1110,13 @@ tarfile
versions prior to 3.5), they will be owned by the named user and group in the
tarfile. (Contributed by Michael Vogt and Eric Smith in :issue:`23193`.)
threading
---------
* :meth:`~threading.Lock.acquire` and :meth:`~threading.RLock.acquire`
now use a monotonic clock for managing timeouts.
(Contributed by Victor Stinner in :issue:`22043`.)
time
----
@ -1008,6 +1131,17 @@ tkinter
module which makes no permanent changes to environment variables.
(Contributed by Zachary Ware in :issue:`20035`.)
traceback
---------
* New :func:`~traceback.walk_stack` and :func:`~traceback.walk_tb`
functions to conveniently traverse frame and traceback objects.
(Contributed by Robert Collins in :issue:`17911`.)
* New lightweight classes: :class:`~traceback.TracebackException`,
:class:`~traceback.StackSummary`, and :class:`traceback.FrameSummary`.
(Contributed by Robert Collins in :issue:`17911`.)
types
-----
@ -1032,6 +1166,10 @@ urllib
control the encoding of query parts if needed. (Contributed by Samwyse and
Arnon Yaari in :issue:`13866`.)
* :func:`~urllib.request.urlopen` accepts an :class:`ssl.SSLContext`
object as a *context* argument, which will be used for the HTTPS
connection. (Contributed by Alex Gaynor in :issue:`22366`.)
unicodedata
-----------
@ -1051,6 +1189,10 @@ xmlrpc
* :class:`xmlrpc.client.ServerProxy` is now a :term:`context manager`.
(Contributed by Claudiu Popa in :issue:`20627`.)
* :class:`~xmlrpc.client.ServerProxy` constructor now accepts an optional
:class:`ssl.SSLContext` instance.
(Contributed by Alex Gaynor in :issue:`22960`.)
xml.sax
-------
@ -1096,7 +1238,10 @@ The following performance enhancements have been added:
:meth:`~ipaddress.IPv4Network.subnets`, :meth:`~ipaddress.IPv4Network.supernet`,
:func:`~ipaddress.summarize_address_range`, :func:`~ipaddress.collapse_addresses`.
The speed up can range from 3x to 15x.
(:issue:`21486`, :issue:`21487`, :issue:`20826`)
(See :issue:`21486`, :issue:`21487`, :issue:`20826`, :issue:`23266`.)
* Pickling of :mod:`ipaddress` classes was optimized to produce significantly
smaller output. (Contributed by Serhiy Storchaka in :issue:`23133`.)
* Many operations on :class:`io.BytesIO` are now 50% to 100% faster.
(Contributed by Serhiy Storchaka in :issue:`15381` and David Wilson in
@ -1109,6 +1254,13 @@ The following performance enhancements have been added:
* The UTF-32 encoder is now 3x to 7x faster. (Contributed by Serhiy Storchaka
in :issue:`15027`.)
* Regular expressions are now parsed up to 10% faster.
(Contributed by Serhiy Storchaka in :issue:`19380`.)
* :func:`json.dumps` was optimized to run with ``ensure_ascii=False``
as fast as with ``ensure_ascii=True``.
(Contributed by Naoki Inada in :issue:`23206`.)
Build and C API Changes
=======================
@ -1185,6 +1337,9 @@ Deprecated Python modules, functions and methods
deprecated in favor of :func:`inspect.signature` API. (See :issue:`20438`
for details.)
* Use of ``re.LOCALE`` flag with str patterns or ``re.ASCII`` is now
deprecated. (Contributed by Serhiy Storchaka in :issue:`22407`.)
Deprecated functions and types of the C API
-------------------------------------------