From 311376588388647477db55092b61c1c61ecd3f85 Mon Sep 17 00:00:00 2001 From: R David Murray Date: Sat, 16 May 2015 14:16:33 -0400 Subject: #19662: Make requirement to support arbitrary keywords explicit. When not using decode_data=True, smtpd may provide keyword arguments to the process_message user-implemented method. This doc update is intended to make it clear that arbitrary keywords must be supported, so that we can add additional features in the future by just adding keywords to the process_message call. --- Doc/library/smtpd.rst | 4 ++++ 1 file changed, 4 insertions(+) diff --git a/Doc/library/smtpd.rst b/Doc/library/smtpd.rst index 575dcec..2682ee0 100644 --- a/Doc/library/smtpd.rst +++ b/Doc/library/smtpd.rst @@ -89,6 +89,10 @@ SMTPServer Objects Currently no ``RCPT TO`` options are supported, so for now this will always be an empty list. + Implementations of ``process_message`` should use the ``**kwargs`` + signature to accept arbitrary keword arguments, since future feature + enhancements may add keys to the kwargs dictionary. + Return ``None`` to request a normal ``250 Ok`` response; otherwise return the desired response string in :RFC:`5321` format. -- cgit v0.12