mirrors/cpython
1
0
Fork 0
mirror of https://github.com/python/cpython.git synced 2025-09-10 02:36:56 +00:00
Code Issues Projects Releases Packages Wiki Activity Actions 9

[3.10] bpo-47022: Document asynchat, asyncore and smtpd removals in 3.12 (GH-31891) (#31997)

Browse source 
Document the deprecation of asyncore, asynchat, and smtpd with a slated removal in Python 3.12 thanks to PEP 594..
(cherry picked from commit 7747384643)

Co-authored-by: Hugo van Kemenade <hugovk@users.noreply.github.com>
This commit is contained in:
Hugo van Kemenade 2022-03-20 22:38:01 +02:00 • committed by GitHub
parent 4352ca234e
commit 94f038cbb2
No known key found for this signature in database
GPG key ID: 4AEE18F83AFDEB23
8 changed files with 18 additions and 4 deletions
Download patch file Download diff file Expand all files Collapse all files

2
Doc/library/asynchat.rst
View file

@ -3,6 +3,7 @@
.. module:: asynchat .. module:: asynchat
:synopsis: Support for asynchronous command/response protocols. :synopsis: Support for asynchronous command/response protocols.
:deprecated:
.. moduleauthor:: Sam Rushing <rushing@nightmare.com> .. moduleauthor:: Sam Rushing <rushing@nightmare.com>
.. sectionauthor:: Steve Holden <sholden@holdenweb.com> .. sectionauthor:: Steve Holden <sholden@holdenweb.com>
@ -10,6 +11,7 @@
**Source code:** :source:`Lib/asynchat.py` **Source code:** :source:`Lib/asynchat.py`
.. deprecated:: 3.6 .. deprecated:: 3.6
:mod:`asynchat` will be removed in Python 3.12 (:pep:`594`).
Please use :mod:`asyncio` instead. Please use :mod:`asyncio` instead.
-------------- --------------

2
Doc/library/asyncore.rst
View file

@ -4,6 +4,7 @@
.. module:: asyncore .. module:: asyncore
:synopsis: A base class for developing asynchronous socket handling :synopsis: A base class for developing asynchronous socket handling
services. services.
:deprecated:
.. moduleauthor:: Sam Rushing <rushing@nightmare.com> .. moduleauthor:: Sam Rushing <rushing@nightmare.com>
.. sectionauthor:: Christopher Petrilli <petrilli@amber.org> .. sectionauthor:: Christopher Petrilli <petrilli@amber.org>
@ -13,6 +14,7 @@
**Source code:** :source:`Lib/asyncore.py` **Source code:** :source:`Lib/asyncore.py`
.. deprecated:: 3.6 .. deprecated:: 3.6
:mod:`asyncore` will be removed in Python 3.12 (:pep:`594`).
Please use :mod:`asyncio` instead. Please use :mod:`asyncio` instead.
-------------- --------------

2
Doc/library/smtpd.rst
View file

@ -3,6 +3,7 @@
.. module:: smtpd .. module:: smtpd
:synopsis: A SMTP server implementation in Python. :synopsis: A SMTP server implementation in Python.
:deprecated:
.. moduleauthor:: Barry Warsaw <barry@python.org> .. moduleauthor:: Barry Warsaw <barry@python.org>
.. sectionauthor:: Moshe Zadka <moshez@moshez.org> .. sectionauthor:: Moshe Zadka <moshez@moshez.org>
@ -14,6 +15,7 @@
This module offers several classes to implement SMTP (email) servers. This module offers several classes to implement SMTP (email) servers.
.. deprecated:: 3.6 .. deprecated:: 3.6
:mod:`smtpd` will be removed in Python 3.12 (:pep:`594`).
The `aiosmtpd <https://aiosmtpd.readthedocs.io/>`_ package is a recommended The `aiosmtpd <https://aiosmtpd.readthedocs.io/>`_ package is a recommended
replacement for this module. It is based on :mod:`asyncio` and provides a replacement for this module. It is based on :mod:`asyncio` and provides a
more straightforward API. more straightforward API.

5
Doc/library/superseded.rst
View file

@ -10,5 +10,8 @@ backwards compatibility. They have been superseded by other modules.
.. toctree:: .. toctree::
optparse.rst asynchat.rst
asyncore.rst
smtpd.rst
imp.rst imp.rst
optparse.rst

2
Lib/asynchat.py
View file

@ -50,7 +50,7 @@ from collections import deque
from warnings import warn from warnings import warn
warn( warn(
'The asynchat module is deprecated. ' 'The asynchat module is deprecated and will be removed in Python 3.12. '
'The recommended replacement is asyncio', 'The recommended replacement is asyncio',
DeprecationWarning, DeprecationWarning,
stacklevel=2) stacklevel=2)

2
Lib/asyncore.py
View file

@ -58,7 +58,7 @@ from errno import EALREADY, EINPROGRESS, EWOULDBLOCK, ECONNRESET, EINVAL, \
errorcode errorcode
warnings.warn( warnings.warn(
'The asyncore module is deprecated. ' 'The asyncore module is deprecated and will be removed in Python 3.12. '
'The recommended replacement is asyncio', 'The recommended replacement is asyncio',
DeprecationWarning, DeprecationWarning,
stacklevel=2) stacklevel=2)

3
Lib/smtpd.py
View file

@ -93,7 +93,8 @@ __all__ = [
] ]
warn( warn(
'The smtpd module is deprecated and unmaintained. Please see aiosmtpd ' 'The smtpd module is deprecated and unmaintained and will be removed '
'in Python 3.12. Please see aiosmtpd '
'(https://aiosmtpd.readthedocs.io/) for the recommended replacement.', '(https://aiosmtpd.readthedocs.io/) for the recommended replacement.',
DeprecationWarning, DeprecationWarning,
stacklevel=2) stacklevel=2)

4
Misc/NEWS.d/next/Library/2022-03-15-09-29-52.bpo-47022.uaEDcI.rst Normal file
View file

@ -0,0 +1,4 @@
The :mod:`asynchat`, :mod:`asyncore` and :mod:`smtpd` modules have been
deprecated since at least Python 3.6. Their documentation and deprecation
warnings and have now been updated to note they will removed in Python 3.12
(:pep:`594`).