aiosmtpd

Changes From 1.4.3

• No longer expect an implicit creation of the event loop through get_event_loop() (Issue #353)

Changes from 1.4.2:

• FIX: Compatibility with CPython 3.10 and 3.11
• FIX: Compatibility with uvloop
• NEW: UnthreadedController
• IMPROVED: aiosmtpd.controller has been rewritten
• IMPROVED: Some improvements on setup.cfg to prevent potential setuptools problems
• IMPROVED: General code hygiene
• IMPROVED: Documentation fixes & improvements
• IMPROVED: Enhanced GitHub CI workflow

Mostly introduce testing compatibility with Python 3.10 and Python 3.11

Let's try releasing as RC first, if nothing breaks, we will re-release as 1.4.3 without any changes.

Because I've forgotten how to package this thing xD

Changes since 1.4.1:

• Controller ready_timeout defaults to 5.0
• More detailed message in TimeoutError during Controller.start()
• IMPORTANT: No more leak of sensitive info during smtp_AUTH

Changes from 1.4.0:

• local_part_limit (max length of email address local part) is now customizable, defaults to 0 (no limit) (#257)

Notable Changes from 1.3.2:

• PROXY Protocol support (#246)
• SMTPS/STARTTLS support from CLI (#172)
• UnixSocketController (#247)
• Improvement on tox+pytest to enable stable run for pypy3-on-Windows, MacOS, and Cygwin
• Example on how to implement SMTP AUTH

This is a bugfix release for 1.3.1

Fixed:

• Documentation issues that causes some automated build systems to fail
• Improper IPv6 detection on systems whose kernel does not support IPv6

Also:

• Add info about GPG Signing key to README and PyPI
• A 'hidden' testenv named static to run pytype

This is a bugfix to 1.3.0

Notable changes:

• Smarter localhost determination (fixes #244)
• No longer failing on hostname="" (fixes #244)

Notable Changes from 1.2.4:

• "AUTH LOGIN <username-b64>" support (#219)
• Command Call Limit to stop misbehaving clients (#145)
• "authenticator" system to replace "auth_callback" (#218)
• "handle_EHLO" can modify return values (#157)
• (Almost) transparant passing of keyword args given to Controller to SMTP (#194)
• Now uses TLS Context as-is (#179)
• Complete conversion of test cases from unittest/nose2 to pytest (#202)
• Improve compatibility with setuptools<=46.4.0 (#242)

This is a bugfix to 1.2.3

The fixes are:

• Now no longer has special handling for lone = sent by client in response to 334
• Commands sent from client are now sanitized, (base64-encoded) auth credentials no longer appear in logs

This release introduces a Major Feature: SMTP AUTH with extension support. Two AUTH mechanisms are internally implemented: LOGIN and PLAIN, and the 'handler' mechanism has been adapted to cater for additional AUTH mechanisms, if needed. More details available in the 'Handlers' documentation page.

In addition, starting 1.2.2 Python 3.5 support has been dropped; minimum required Python version is 3.6 (or its analogue with other implementations such as PyPy).

Other changes:

• BUGFIX: Don't strip last \r\n prior to terminating dot
• LICENSE: Actually include the license text file for Apache License v2.0
• COMPATIBILITY: Verified compatibility with the latest versions of Python 3.8 and 3.9

• Improve the documentation on enabling STARTTLS. (Closes #125)

• Add customizable ident field to SMTP class constructor. (Closes #131)

• Remove asyncio.coroutine decorator as it was introduced in Python 3.5.

• Add Controller docstring, explain dual-stack binding. (Closes #140)

• Gracefully handle ASCII decoding exceptions. (Closes #142)

• Fix typo.

• Improve Controller ssl_context documentation.

• Add timeout feature. (Partial fix for #145)

• Drop support for Python 3.4.

• As per RFC 5321, §4.1.4, multiple HELO / EHLO commands in the same session are semantically equivalent to RSET. (Closes #78)

• As per RFC 5321, $4.1.1.9, NOOP takes an optional argument, which is ignored. API BREAK If you have a handler that implements handle_NOOP(), it previously took zero arguments but now requires a single argument. (Closes #107)

• The command line options --version / -v has been added to print the package's current version number. (Closes #111)

• General improvements in the Controller class. (Closes #104)

• When aiosmtpd handles a STARTTLS it must arrange for the original transport to be closed when the wrapped transport is closed. This fixes a hidden exception which occurs when an EOF is received on the original tranport after the connection is lost. (Closes #83)

• Widen the catch of ConnectionResetError and CancelledError to also catch such errors from handler methods. (Closes #110)

• Added a manpage for the aiosmtpd command line script. (Closes #116)

• Added much better support for the HELP. There's a new decorator called @syntax() which you can use in derived classes to decorate smtp_*() methods. These then show up in HELP responses. This also fixes HELP responses for the LMTP subclass. (Closes #113)

• The Controller class now takes an optional keyword argument ssl_context which is passed directly to the asyncio create_server() call.

• Release.

• Improved documentation.

• The connection peer is displayed in all INFO level logging.

• When running the test suite, you can include a -E option after the -- separator to boost the debugging output.

• The main SMTP readline loops are now more robust against connection resets and mid-read EOFs. (Closes #62)

• Proxy handlers work with SMTP servers regardless of the value of the decode_data argument.

• The command line script is now installed as aiosmtpd instead of smtpd.

• The SMTP class now does a better job of handling Unicode, when the client does not claim to support SMTPUTF8 but sends non-ASCII anyway. The server forces ASCII-only handling when enable_SMTPUTF8=False (the default) is passed to the constructor. The command line arguments decode_data=True and enable_SMTPUTF8=True are no longer mutually exclusive.

• Officially support Windows. (Closes #76)

• A new handler hook API has been added which provides more flexibility but requires more responsibility (e.g. hooks must return a string status). Deprecate SMTP.ehlo_hook() and SMTP.rset_hook().

• Deprecate handler process_message() methods. Use the new asynchronous handle_DATA() methods, which take a session and an envelope object.

• Added the STARTTLS extension. Given by Konstantin Volkov.

• Minor changes to the way the Debugging handler prints mail_options and rcpt_options (although the latter is still not support in SMTP).

• DATA method now respects original line endings, and passing size limits is now handled better. Given by Konstantin Volkov.

• The Controller class has two new optional keyword arguments.

  • ready_timeout specifies a timeout in seconds that can be used to limit the amount of time it waits for the server to become ready. This can also be overridden with the environment variable AIOSMTPD_CONTROLLER_TIMEOUT. (Closes #35)

  • enable_SMTPUTF8 is passed through to the SMTP constructor in the default factory. If you override Controller.factory() you can pass self.enable_SMTPUTF8 yourself.

• Handlers can define a handle_tls_handshake() method, which takes a session object, and is called if SSL is enabled during the making of the connection. (Closes #48)

• Better Windows compatibility.

• Better Python 3.4 compatibility.

• Use flufl.testing package for nose2 and flake8 plugins.

• The test suite has achieved 100% code coverage. (Closes #2)

• The SMTP server connection identifier can be changed by setting the __ident__ attribute on the SMTP instance. (Closes #20)

• Fixed a new incompatibility with the atpublic library.

• Fix typo in Message.prepare_message() handler. The crafted X-RcptTos header is renamed to X-RcptTo for backward compatibility with older libraries.

• Add a few hooks to make subclassing easier:

  • SMTP.ehlo_hook() is called just before the final, non-continuing 250 response to allow subclasses to add additional EHLO sub-responses.

  • SMTP.rset_hook() is called just before the final 250 command to allow subclasses to provide additional RSET functionality.

  • Controller.make_socket() allows subclasses to customize the creation of the socket before binding.

• Officially support Python 3.6.

• Fix support for both IPv4 and IPv6 based on the --listen option. Given by Jason Coombs. (Closes #3)

• Correctly handle client disconnects. Given by Konstantin vz'One Enchant.

• The SMTP class now takes an optional hostname argument. Use this if you want to avoid the use of socket.getfqdn(). Given by Konstantin vz'One Enchant.

• Close the transport and thus the connection on SMTP QUIT. (Closes #11)

• Added an AsyncMessage handler. Given by Konstantin vz'One Enchant.

• Add an examples/ directory.

• Flake8 clean.

• Initial release.