From 8d6f28f1a0718c0c81b3fc15e81eccdf07e42b90 Mon Sep 17 00:00:00 2001 From: Barry Warsaw Date: Fri, 24 Feb 2017 14:05:59 -0500 Subject: [PATCH] bpo-25008: Deprecate smtpd and point to aiosmtpd (#274) --- Doc/library/smtpd.rst | 6 ++++++ Misc/NEWS | 6 ++++++ 2 files changed, 12 insertions(+) diff --git a/Doc/library/smtpd.rst b/Doc/library/smtpd.rst index 3ebed06260945c..78f9d7feec4953 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 7acaf2fd50e20e..d9e691b2496bd1 100644 --- a/Misc/NEWS +++ b/Misc/NEWS @@ -10,6 +10,12 @@ Release date: XXXX-XX-XX Core and Builtins ----------------- +Documentation +------------- + +- bpo-25008: Document smtpd.py as effectively deprecated and add a pointer to + aiosmtpd, a third-party asyncio-based replacement. + Library -------