#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.

diff --git a/Doc/library/smtpd.rst b/Doc/library/smtpd.rst
index 575dcec9946211510bbeeffda976ac61f5b2bfb1..2682ee0c57308748e57daff5caea0ae27f0e18c8 100644 (file)
--- 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.