mirror of
https://github.com/python/cpython.git
synced 2026-01-05 15:02:33 +00:00
GH-123299: Copyedit 3.14 What's New: Removed (#137794)
Co-authored-by: Hugo van Kemenade <1324225+hugovk@users.noreply.github.com>
This commit is contained in:
Adam Turner
GitHub
parent
31bbea1477
commit
dc53a3e52a
1 changed files with 294 additions and 269 deletions
|
|
@ -1204,6 +1204,17 @@ Other language changes
|
|||
|
||||
.. _Jython: https://www.jython.org/
|
||||
|
||||
* The :func:`int` built-in no longer delegates to :meth:`~object.__trunc__`.
|
||||
Classes that want to support conversion to :func:`!int` must implement
|
||||
either :meth:`~object.__int__` or :meth:`~object.__index__`.
|
||||
(Contributed by Mark Dickinson in :gh:`119743`.)
|
||||
|
||||
* Using :data:`NotImplemented` in a boolean context
|
||||
will now raise a :exc:`TypeError`.
|
||||
This has raised a :exc:`DeprecationWarning` since Python 3.9.
|
||||
(Contributed by Jelle Zijlstra in :gh:`118767`.)
|
||||
|
||||
|
||||
.. _whatsnew314-pep765:
|
||||
|
||||
PEP 765: Disallow ``return``/``break``/``continue`` that exit a ``finally`` block
|
||||
|
|
@ -2379,6 +2390,289 @@ zlib
|
|||
(Contributed by Steve Dower in :gh:`91349`.)
|
||||
|
||||
|
||||
Removed
|
||||
=======
|
||||
|
||||
argparse
|
||||
--------
|
||||
|
||||
* Remove the *type*, *choices*, and *metavar* parameters
|
||||
of :class:`!BooleanOptionalAction`.
|
||||
These have been deprecated since Python 3.12.
|
||||
(Contributed by Nikita Sobolev in :gh:`118805`.)
|
||||
|
||||
* Calling :meth:`~argparse.ArgumentParser.add_argument_group`
|
||||
on an argument group now raises a :exc:`ValueError`.
|
||||
Similarly, :meth:`~argparse.ArgumentParser.add_argument_group`
|
||||
or :meth:`~argparse.ArgumentParser.add_mutually_exclusive_group`
|
||||
on a mutually exclusive group now both raise :exc:`ValueError`\ s.
|
||||
This 'nesting' was never supported, often failed to work correctly,
|
||||
and was unintentionally exposed through inheritance.
|
||||
This functionality has been deprecated since Python 3.11.
|
||||
(Contributed by Savannah Ostrowski in :gh:`127186`.)
|
||||
|
||||
|
||||
ast
|
||||
---
|
||||
|
||||
* Remove the following classes, which have been deprecated aliases of
|
||||
:class:`~ast.Constant` since Python 3.8 and have emitted
|
||||
deprecation warnings since Python 3.12:
|
||||
|
||||
* :class:`!Bytes`
|
||||
* :class:`!Ellipsis`
|
||||
* :class:`!NameConstant`
|
||||
* :class:`!Num`
|
||||
* :class:`!Str`
|
||||
|
||||
As a consequence of these removals, user-defined ``visit_Num``, ``visit_Str``,
|
||||
``visit_Bytes``, ``visit_NameConstant`` and ``visit_Ellipsis`` methods
|
||||
on custom :class:`~ast.NodeVisitor` subclasses will no longer be called
|
||||
when the :class:`!NodeVisitor` subclass is visiting an AST.
|
||||
Define a ``visit_Constant`` method instead.
|
||||
|
||||
(Contributed by Alex Waygood in :gh:`119562`.)
|
||||
|
||||
* Remove the following deprecated properties on :class:`ast.Constant`,
|
||||
which were present for compatibility with the now-removed AST classes:
|
||||
|
||||
* :attr:`!Constant.n`
|
||||
* :attr:`!Constant.s`
|
||||
|
||||
Use :attr:`!Constant.value` instead.
|
||||
(Contributed by Alex Waygood in :gh:`119562`.)
|
||||
|
||||
|
||||
asyncio
|
||||
-------
|
||||
|
||||
* Remove the following classes, methods, and functions,
|
||||
which have been deprecated since Python 3.12:
|
||||
|
||||
* :class:`!AbstractChildWatcher`
|
||||
* :class:`!FastChildWatcher`
|
||||
* :class:`!MultiLoopChildWatcher`
|
||||
* :class:`!PidfdChildWatcher`
|
||||
* :class:`!SafeChildWatcher`
|
||||
* :class:`!ThreadedChildWatcher`
|
||||
* :meth:`!AbstractEventLoopPolicy.get_child_watcher`
|
||||
* :meth:`!AbstractEventLoopPolicy.set_child_watcher`
|
||||
* :func:`!get_child_watcher`
|
||||
* :func:`!set_child_watcher`
|
||||
|
||||
(Contributed by Kumar Aditya in :gh:`120804`.)
|
||||
|
||||
* :func:`asyncio.get_event_loop` now raises a :exc:`RuntimeError`
|
||||
if there is no current event loop,
|
||||
and no longer implicitly creates an event loop.
|
||||
|
||||
(Contributed by Kumar Aditya in :gh:`126353`.)
|
||||
|
||||
.. TODO: move these patterns to the asyncio docs?
|
||||
quite long for What's New
|
||||
|
||||
There's a few patterns that use :func:`asyncio.get_event_loop`, most
|
||||
of them can be replaced with :func:`asyncio.run`.
|
||||
|
||||
If you're running an async function, simply use :func:`asyncio.run`.
|
||||
|
||||
Before:
|
||||
|
||||
.. code:: python
|
||||
|
||||
async def main():
|
||||
...
|
||||
|
||||
|
||||
loop = asyncio.get_event_loop()
|
||||
try:
|
||||
loop.run_until_complete(main())
|
||||
finally:
|
||||
loop.close()
|
||||
|
||||
After:
|
||||
|
||||
.. code:: python
|
||||
|
||||
async def main():
|
||||
...
|
||||
|
||||
asyncio.run(main())
|
||||
|
||||
If you need to start something, for example, a server listening on a socket
|
||||
and then run forever, use :func:`asyncio.run` and an
|
||||
:class:`asyncio.Event`.
|
||||
|
||||
Before:
|
||||
|
||||
.. code:: python
|
||||
|
||||
def start_server(loop): ...
|
||||
|
||||
loop = asyncio.get_event_loop()
|
||||
try:
|
||||
start_server(loop)
|
||||
loop.run_forever()
|
||||
finally:
|
||||
loop.close()
|
||||
|
||||
After:
|
||||
|
||||
.. code:: python
|
||||
|
||||
def start_server(loop): ...
|
||||
|
||||
async def main():
|
||||
start_server(asyncio.get_running_loop())
|
||||
await asyncio.Event().wait()
|
||||
|
||||
asyncio.run(main())
|
||||
|
||||
If you need to run something in an event loop, then run some blocking
|
||||
code around it, use :class:`asyncio.Runner`.
|
||||
|
||||
Before:
|
||||
|
||||
.. code:: python
|
||||
|
||||
async def operation_one(): ...
|
||||
def blocking_code(): ...
|
||||
async def operation_two(): ...
|
||||
|
||||
loop = asyncio.get_event_loop()
|
||||
try:
|
||||
loop.run_until_complete(operation_one())
|
||||
blocking_code()
|
||||
loop.run_until_complete(operation_two())
|
||||
finally:
|
||||
loop.close()
|
||||
|
||||
After:
|
||||
|
||||
.. code:: python
|
||||
|
||||
async def operation_one(): ...
|
||||
def blocking_code(): ...
|
||||
async def operation_two(): ...
|
||||
|
||||
with asyncio.Runner() as runner:
|
||||
runner.run(operation_one())
|
||||
blocking_code()
|
||||
runner.run(operation_two())
|
||||
|
||||
|
||||
collections.abc
|
||||
---------------
|
||||
|
||||
* Remove :class:`!ByteString`, which has been deprecated since Python 3.12.
|
||||
(Contributed by Nikita Sobolev in :gh:`118803`.)
|
||||
|
||||
|
||||
|
||||
email
|
||||
-----
|
||||
|
||||
* Remove :func:`email.utils.localtime`'s *isdst* parameter,
|
||||
which was deprecated in and has been ignored since Python 3.12.
|
||||
(Contributed by Hugo van Kemenade in :gh:`118798`.)
|
||||
|
||||
|
||||
importlib.abc
|
||||
-------------
|
||||
|
||||
* Remove deprecated :mod:`importlib.abc` classes:
|
||||
|
||||
* :class:`!ResourceReader`
|
||||
(use :class:`~importlib.resources.abc.TraversableResources`)
|
||||
* :class:`!Traversable`
|
||||
(use :class:`~importlib.resources.abc.Traversable`)
|
||||
* :class:`!TraversableResources`
|
||||
(use :class:`~importlib.resources.abc.TraversableResources`)
|
||||
|
||||
(Contributed by Jason R. Coombs and Hugo van Kemenade in :gh:`93963`.)
|
||||
|
||||
|
||||
itertools
|
||||
---------
|
||||
|
||||
* Remove support for copy, deepcopy, and pickle operations
|
||||
from :mod:`itertools` iterators.
|
||||
These have emitted a :exc:`DeprecationWarning` since Python 3.12.
|
||||
(Contributed by Raymond Hettinger in :gh:`101588`.)
|
||||
|
||||
|
||||
pathlib
|
||||
-------
|
||||
|
||||
* Remove support for passing additional keyword arguments
|
||||
to :class:`~pathlib.Path`.
|
||||
In previous versions, any such arguments are ignored.
|
||||
(Contributed by Barney Gale in :gh:`74033`.)
|
||||
|
||||
* Remove support for passing additional positional arguments to
|
||||
:meth:`.PurePath.relative_to` and :meth:`~pathlib.PurePath.is_relative_to`.
|
||||
In previous versions, any such arguments are joined onto *other*.
|
||||
(Contributed by Barney Gale in :gh:`78707`.)
|
||||
|
||||
|
||||
pkgutil
|
||||
-------
|
||||
|
||||
* Remove the :func:`!get_loader` and :func:`!find_loader` functions,
|
||||
which have been deprecated since Python 3.12.
|
||||
(Contributed by Bénédikt Tran in :gh:`97850`.)
|
||||
|
||||
|
||||
pty
|
||||
---
|
||||
|
||||
* Remove the :func:`!master_open` and :func:`!slave_open` functions,
|
||||
which have been deprecated since Python 3.12.
|
||||
Use :func:`pty.openpty` instead.
|
||||
(Contributed by Nikita Sobolev in :gh:`118824`.)
|
||||
|
||||
|
||||
sqlite3
|
||||
-------
|
||||
|
||||
* Remove :data:`!version` and :data:`!version_info` from
|
||||
the :mod:`sqlite3` module;
|
||||
use :data:`~sqlite3.sqlite_version` and :data:`~sqlite3.sqlite_version_info`
|
||||
for the actual version number of the runtime SQLite library.
|
||||
(Contributed by Hugo van Kemenade in :gh:`118924`.)
|
||||
|
||||
* Using a sequence of parameters with named placeholders now
|
||||
raises a :exc:`~sqlite3.ProgrammingError`,
|
||||
having been deprecated since Python 3.12.
|
||||
(Contributed by Erlend E. Aasland in :gh:`118928` and :gh:`101693`.)
|
||||
|
||||
|
||||
typing
|
||||
------
|
||||
|
||||
* Remove :class:`!ByteString`, which has been deprecated since Python 3.12.
|
||||
(Contributed by Nikita Sobolev in :gh:`118803`.)
|
||||
|
||||
|
||||
urllib
|
||||
------
|
||||
|
||||
* Remove the :class:`!Quoter` class from :mod:`urllib.parse`,
|
||||
which has been deprecated since Python 3.11.
|
||||
(Contributed by Nikita Sobolev in :gh:`118827`.)
|
||||
|
||||
* Remove the :class:`!URLopener` and :class:`!FancyURLopener` classes
|
||||
from :mod:`urllib.request`,
|
||||
which have been deprecated since Python 3.3.
|
||||
|
||||
``myopener.open()`` can be replaced with :func:`~urllib.request.urlopen`.
|
||||
``myopener.retrieve()`` can be replaced with
|
||||
:func:`~urllib.request.urlretrieve`.
|
||||
Customisations to the opener classes can be replaced by passing
|
||||
customized handlers to :func:`~urllib.request.build_opener`.
|
||||
(Contributed by Barney Gale in :gh:`84850`.)
|
||||
|
||||
|
||||
Deprecated
|
||||
==========
|
||||
|
||||
|
|
@ -2518,275 +2812,6 @@ Deprecated
|
|||
|
||||
.. include:: ../deprecations/pending-removal-in-future.rst
|
||||
|
||||
Removed
|
||||
=======
|
||||
|
||||
argparse
|
||||
--------
|
||||
|
||||
* Remove the *type*, *choices*, and *metavar* parameters
|
||||
of :class:`!argparse.BooleanOptionalAction`.
|
||||
They were deprecated since 3.12.
|
||||
|
||||
* Calling :meth:`~argparse.ArgumentParser.add_argument_group` on an argument
|
||||
group, and calling :meth:`~argparse.ArgumentParser.add_argument_group` or
|
||||
:meth:`~argparse.ArgumentParser.add_mutually_exclusive_group` on a mutually
|
||||
exclusive group now raise exceptions. This nesting was never supported,
|
||||
often failed to work correctly, and was unintentionally exposed through
|
||||
inheritance. This functionality has been deprecated since Python 3.11.
|
||||
(Contributed by Savannah Ostrowski in :gh:`127186`.)
|
||||
|
||||
ast
|
||||
---
|
||||
|
||||
* Remove the following classes. They were all deprecated since Python 3.8,
|
||||
and have emitted deprecation warnings since Python 3.12:
|
||||
|
||||
* :class:`!ast.Bytes`
|
||||
* :class:`!ast.Ellipsis`
|
||||
* :class:`!ast.NameConstant`
|
||||
* :class:`!ast.Num`
|
||||
* :class:`!ast.Str`
|
||||
|
||||
Use :class:`ast.Constant` instead. As a consequence of these removals,
|
||||
user-defined ``visit_Num``, ``visit_Str``, ``visit_Bytes``,
|
||||
``visit_NameConstant`` and ``visit_Ellipsis`` methods on custom
|
||||
:class:`ast.NodeVisitor` subclasses will no longer be called when the
|
||||
:class:`!NodeVisitor` subclass is visiting an AST. Define a ``visit_Constant``
|
||||
method instead.
|
||||
|
||||
Also, remove the following deprecated properties on :class:`ast.Constant`,
|
||||
which were present for compatibility with the now-removed AST classes:
|
||||
|
||||
* :attr:`!ast.Constant.n`
|
||||
* :attr:`!ast.Constant.s`
|
||||
|
||||
Use :attr:`!ast.Constant.value` instead.
|
||||
(Contributed by Alex Waygood in :gh:`119562`.)
|
||||
|
||||
asyncio
|
||||
-------
|
||||
|
||||
* Remove the following classes and functions. They were all deprecated and
|
||||
emitted deprecation warnings since Python 3.12:
|
||||
|
||||
* :func:`!asyncio.get_child_watcher`
|
||||
* :func:`!asyncio.set_child_watcher`
|
||||
* :meth:`!asyncio.AbstractEventLoopPolicy.get_child_watcher`
|
||||
* :meth:`!asyncio.AbstractEventLoopPolicy.set_child_watcher`
|
||||
* :class:`!asyncio.AbstractChildWatcher`
|
||||
* :class:`!asyncio.FastChildWatcher`
|
||||
* :class:`!asyncio.MultiLoopChildWatcher`
|
||||
* :class:`!asyncio.PidfdChildWatcher`
|
||||
* :class:`!asyncio.SafeChildWatcher`
|
||||
* :class:`!asyncio.ThreadedChildWatcher`
|
||||
|
||||
(Contributed by Kumar Aditya in :gh:`120804`.)
|
||||
|
||||
* Removed implicit creation of event loop by :func:`asyncio.get_event_loop`.
|
||||
It now raises a :exc:`RuntimeError` if there is no current event loop.
|
||||
(Contributed by Kumar Aditya in :gh:`126353`.)
|
||||
|
||||
There's a few patterns that use :func:`asyncio.get_event_loop`, most
|
||||
of them can be replaced with :func:`asyncio.run`.
|
||||
|
||||
If you're running an async function, simply use :func:`asyncio.run`.
|
||||
|
||||
Before::
|
||||
|
||||
async def main():
|
||||
...
|
||||
|
||||
|
||||
loop = asyncio.get_event_loop()
|
||||
try:
|
||||
loop.run_until_complete(main())
|
||||
finally:
|
||||
loop.close()
|
||||
|
||||
After::
|
||||
|
||||
async def main():
|
||||
...
|
||||
|
||||
asyncio.run(main())
|
||||
|
||||
If you need to start something, for example, a server listening on a socket
|
||||
and then run forever, use :func:`asyncio.run` and an
|
||||
:class:`asyncio.Event`.
|
||||
|
||||
Before::
|
||||
|
||||
def start_server(loop):
|
||||
...
|
||||
|
||||
loop = asyncio.get_event_loop()
|
||||
try:
|
||||
start_server(loop)
|
||||
loop.run_forever()
|
||||
finally:
|
||||
loop.close()
|
||||
|
||||
After::
|
||||
|
||||
def start_server(loop):
|
||||
...
|
||||
|
||||
async def main():
|
||||
start_server(asyncio.get_running_loop())
|
||||
await asyncio.Event().wait()
|
||||
|
||||
asyncio.run(main())
|
||||
|
||||
If you need to run something in an event loop, then run some blocking
|
||||
code around it, use :class:`asyncio.Runner`.
|
||||
|
||||
Before::
|
||||
|
||||
async def operation_one():
|
||||
...
|
||||
|
||||
def blocking_code():
|
||||
...
|
||||
|
||||
async def operation_two():
|
||||
...
|
||||
|
||||
loop = asyncio.get_event_loop()
|
||||
try:
|
||||
loop.run_until_complete(operation_one())
|
||||
blocking_code()
|
||||
loop.run_until_complete(operation_two())
|
||||
finally:
|
||||
loop.close()
|
||||
|
||||
After::
|
||||
|
||||
async def operation_one():
|
||||
...
|
||||
|
||||
def blocking_code():
|
||||
...
|
||||
|
||||
async def operation_two():
|
||||
...
|
||||
|
||||
with asyncio.Runner() as runner:
|
||||
runner.run(operation_one())
|
||||
blocking_code()
|
||||
runner.run(operation_two())
|
||||
|
||||
|
||||
|
||||
collections.abc
|
||||
---------------
|
||||
|
||||
* Remove :class:`!collections.abc.ByteString`. It had previously raised a
|
||||
:exc:`DeprecationWarning` since Python 3.12.
|
||||
|
||||
email
|
||||
-----
|
||||
|
||||
* Remove the *isdst* parameter from :func:`email.utils.localtime`.
|
||||
(Contributed by Hugo van Kemenade in :gh:`118798`.)
|
||||
|
||||
importlib
|
||||
---------
|
||||
|
||||
* Remove deprecated :mod:`importlib.abc` classes:
|
||||
|
||||
* :class:`!importlib.abc.ResourceReader`
|
||||
* :class:`!importlib.abc.Traversable`
|
||||
* :class:`!importlib.abc.TraversableResources`
|
||||
|
||||
Use :mod:`importlib.resources.abc` classes instead:
|
||||
|
||||
* :class:`importlib.resources.abc.Traversable`
|
||||
* :class:`importlib.resources.abc.TraversableResources`
|
||||
|
||||
(Contributed by Jason R. Coombs and Hugo van Kemenade in :gh:`93963`.)
|
||||
|
||||
itertools
|
||||
---------
|
||||
|
||||
* Remove :mod:`itertools` support for copy, deepcopy, and pickle operations.
|
||||
These had previously raised a :exc:`DeprecationWarning` since Python 3.12.
|
||||
(Contributed by Raymond Hettinger in :gh:`101588`.)
|
||||
|
||||
pathlib
|
||||
-------
|
||||
|
||||
* Remove support for passing additional keyword arguments to
|
||||
:class:`pathlib.Path`. In previous versions, any such arguments are ignored.
|
||||
* Remove support for passing additional positional arguments to
|
||||
:meth:`pathlib.PurePath.relative_to` and
|
||||
:meth:`~pathlib.PurePath.is_relative_to`. In previous versions, any such
|
||||
arguments are joined onto *other*.
|
||||
|
||||
pkgutil
|
||||
-------
|
||||
|
||||
* Remove deprecated :func:`!pkgutil.get_loader` and :func:`!pkgutil.find_loader`.
|
||||
These had previously raised a :exc:`DeprecationWarning` since Python 3.12.
|
||||
(Contributed by Bénédikt Tran in :gh:`97850`.)
|
||||
|
||||
pty
|
||||
---
|
||||
|
||||
* Remove deprecated :func:`!pty.master_open` and :func:`!pty.slave_open`.
|
||||
They had previously raised a :exc:`DeprecationWarning` since Python 3.12.
|
||||
Use :func:`pty.openpty` instead.
|
||||
(Contributed by Nikita Sobolev in :gh:`118824`.)
|
||||
|
||||
sqlite3
|
||||
-------
|
||||
|
||||
* Remove :data:`!version` and :data:`!version_info` from :mod:`sqlite3`;
|
||||
use :data:`~sqlite3.sqlite_version` and :data:`~sqlite3.sqlite_version_info`
|
||||
for the actual version number of the runtime SQLite library.
|
||||
(Contributed by Hugo van Kemenade in :gh:`118924`.)
|
||||
|
||||
* Disallow using a sequence of parameters with named placeholders.
|
||||
This had previously raised a :exc:`DeprecationWarning` since Python 3.12;
|
||||
it will now raise a :exc:`sqlite3.ProgrammingError`.
|
||||
(Contributed by Erlend E. Aasland in :gh:`118928` and :gh:`101693`.)
|
||||
|
||||
typing
|
||||
------
|
||||
|
||||
* Remove :class:`!typing.ByteString`. It had previously raised a
|
||||
:exc:`DeprecationWarning` since Python 3.12.
|
||||
|
||||
|
||||
urllib
|
||||
------
|
||||
|
||||
* Remove deprecated :class:`!Quoter` class from :mod:`urllib.parse`.
|
||||
It had previously raised a :exc:`DeprecationWarning` since Python 3.11.
|
||||
(Contributed by Nikita Sobolev in :gh:`118827`.)
|
||||
* Remove deprecated :class:`!URLopener` and :class:`!FancyURLopener` classes
|
||||
from :mod:`urllib.request`. They had previously raised a
|
||||
:exc:`DeprecationWarning` since Python 3.3.
|
||||
|
||||
``myopener.open()`` can be replaced with :func:`~urllib.request.urlopen`,
|
||||
and ``myopener.retrieve()`` can be replaced with
|
||||
:func:`~urllib.request.urlretrieve`. Customizations to the opener
|
||||
classes can be replaced by passing customized handlers to
|
||||
:func:`~urllib.request.build_opener`.
|
||||
(Contributed by Barney Gale in :gh:`84850`.)
|
||||
|
||||
Others
|
||||
------
|
||||
|
||||
* Using :data:`NotImplemented` in a boolean context will now raise a :exc:`TypeError`.
|
||||
It had previously raised a :exc:`DeprecationWarning` since Python 3.9. (Contributed
|
||||
by Jelle Zijlstra in :gh:`118767`.)
|
||||
|
||||
* The :func:`int` built-in no longer delegates to
|
||||
:meth:`~object.__trunc__`. Classes that want to support conversion to
|
||||
integer must implement either :meth:`~object.__int__` or
|
||||
:meth:`~object.__index__`. (Contributed by Mark Dickinson in :gh:`119743`.)
|
||||
|
||||
|
||||
CPython bytecode changes
|
||||
========================
|
||||
|
|
|
|||
Loading…
Add table
Add a link
Reference in a new issue