diff options
| author | Hugo van Kemenade <hugovk@users.noreply.github.com> | 2022-03-18 19:45:37 (GMT) |
|---|---|---|
| committer | GitHub <noreply@github.com> | 2022-03-18 19:45:37 (GMT) |
| commit | 77473846439b8a3eae66de1a1cfe931619f38513 (patch) | |
| tree | 3caee09cfda1b27a87da7dcd1df553c3873595fb /Doc | |
| parent | 3a2b89580ded72262fbea0f7ad24096a90c42b9c (diff) | |
| download | cpython-77473846439b8a3eae66de1a1cfe931619f38513.zip cpython-77473846439b8a3eae66de1a1cfe931619f38513.tar.gz cpython-77473846439b8a3eae66de1a1cfe931619f38513.tar.bz2 | |
bpo-47022: Document asynchat, asyncore and smtpd removals in 3.12 (GH-31891)
Document the deprecation of asyncore, asynchat, and smtpd with a slated removal in Python 3.12 thanks to PEP 594.
Diffstat (limited to 'Doc')
| -rw-r--r-- | Doc/library/asynchat.rst | 2 | ||||
| -rw-r--r-- | Doc/library/asyncore.rst | 2 | ||||
| -rw-r--r-- | Doc/library/smtpd.rst | 2 | ||||
| -rw-r--r-- | Doc/library/superseded.rst | 5 | ||||
| -rw-r--r-- | Doc/whatsnew/3.11.rst | 5 |
5 files changed, 15 insertions, 1 deletions
diff --git a/Doc/library/asynchat.rst b/Doc/library/asynchat.rst index 9e51416..4354444 100644 --- a/Doc/library/asynchat.rst +++ b/Doc/library/asynchat.rst @@ -3,6 +3,7 @@ .. module:: asynchat :synopsis: Support for asynchronous command/response protocols. + :deprecated: .. moduleauthor:: Sam Rushing <rushing@nightmare.com> .. sectionauthor:: Steve Holden <sholden@holdenweb.com> @@ -10,6 +11,7 @@ **Source code:** :source:`Lib/asynchat.py` .. deprecated:: 3.6 + :mod:`asynchat` will be removed in Python 3.12 (:pep:`594`). Please use :mod:`asyncio` instead. -------------- diff --git a/Doc/library/asyncore.rst b/Doc/library/asyncore.rst index a86518e..e481e13 100644 --- a/Doc/library/asyncore.rst +++ b/Doc/library/asyncore.rst @@ -4,6 +4,7 @@ .. module:: asyncore :synopsis: A base class for developing asynchronous socket handling services. + :deprecated: .. moduleauthor:: Sam Rushing <rushing@nightmare.com> .. sectionauthor:: Christopher Petrilli <petrilli@amber.org> @@ -13,6 +14,7 @@ **Source code:** :source:`Lib/asyncore.py` .. deprecated:: 3.6 + :mod:`asyncore` will be removed in Python 3.12 (:pep:`594`). Please use :mod:`asyncio` instead. -------------- diff --git a/Doc/library/smtpd.rst b/Doc/library/smtpd.rst index 611411d..6b37a05 100644 --- a/Doc/library/smtpd.rst +++ b/Doc/library/smtpd.rst @@ -3,6 +3,7 @@ .. module:: smtpd :synopsis: A SMTP server implementation in Python. + :deprecated: .. moduleauthor:: Barry Warsaw <barry@python.org> .. sectionauthor:: Moshe Zadka <moshez@moshez.org> @@ -14,6 +15,7 @@ This module offers several classes to implement SMTP (email) servers. .. deprecated:: 3.6 + :mod:`smtpd` will be removed in Python 3.12 (:pep:`594`). The `aiosmtpd <https://aiosmtpd.readthedocs.io/>`_ package is a recommended replacement for this module. It is based on :mod:`asyncio` and provides a more straightforward API. diff --git a/Doc/library/superseded.rst b/Doc/library/superseded.rst index 50a5983..fd23e4d 100644 --- a/Doc/library/superseded.rst +++ b/Doc/library/superseded.rst @@ -10,5 +10,8 @@ backwards compatibility. They have been superseded by other modules. .. toctree:: - optparse.rst + asynchat.rst + asyncore.rst + smtpd.rst imp.rst + optparse.rst diff --git a/Doc/whatsnew/3.11.rst b/Doc/whatsnew/3.11.rst index 2af6638..8b3450e 100644 --- a/Doc/whatsnew/3.11.rst +++ b/Doc/whatsnew/3.11.rst @@ -555,6 +555,11 @@ Deprecated :func:`locale.getlocale` functions instead. (Contributed by Victor Stinner in :issue:`46659`.) +* The :mod:`asynchat`, :mod:`asyncore` and :mod:`smtpd` modules have been + deprecated since at least Python 3.6. Their documentation and deprecation + warnings have now been updated to note they will removed in Python 3.12 + (:pep:`594`). + (Contributed by Hugo van Kemenade in :issue:`47022`.) Removed ======= |