From: Barry Warsaw Date: Fri, 24 Feb 2017 21:15:17 +0000 (-0500) Subject: bpo-25008: Deprecate smtpd and point to aiosmtpd (#274) (#279) X-Git-Tag: v3.5.4rc1~328 X-Git-Url: https://granicus.if.org/sourcecode?a=commitdiff_plain;h=66b5092fac4264efdc9c508a7dd425fa9833e147;p=python bpo-25008: Deprecate smtpd and point to aiosmtpd (#274) (#279) --- diff --git a/Doc/library/smtpd.rst b/Doc/library/smtpd.rst index a096de006e..4d5a0cebf6 100644 --- a/Doc/library/smtpd.rst +++ b/Doc/library/smtpd.rst @@ -13,6 +13,12 @@ This module offers several classes to implement SMTP (email) servers. +.. seealso:: + + The `aiosmtpd `_ package is a recommended + replacement for this module. It is based on :mod:`asyncio` and provides a + more straightforward API. :mod:`smtpd` should be considered deprecated. + Several server implementations are present; one is a generic do-nothing implementation, which can be overridden, while the other two offer specific mail-sending strategies. diff --git a/Misc/NEWS b/Misc/NEWS index a01d454ab7..e680b90ca8 100644 --- a/Misc/NEWS +++ b/Misc/NEWS @@ -92,6 +92,9 @@ C API Documentation ------------- +- bpo-25008: Document smtpd.py as effectively deprecated and add a pointer to + aiosmtpd, a third-party asyncio-based replacement. + - Issue #26355: Add canonical header link on each page to corresponding major version of the documentation. Patch by Matthias Bussonnier.