Products.MailHost 5.1

zope.sendmail integration for Zope.

Products.MailHost

The MailHost product provides support for sending email from within the Zope environment using MailHost objects.

An optional character set can be specified to automatically encode unicode input, and perform appropriate RFC 2822 header and body encoding for the specified character set. Full python email.Message.Message objects may be sent.

Email can optionally be encoded using Base64 or Quoted-Printable encoding (though automatic body encoding will be applied if a character set is specified).

Usage

MailHost provides integration with the Zope transaction system and optional support for asynchronous mail delivery. Asynchronous mail delivery is implemented using a queue and a dedicated thread processing the queue. The thread is (re)-started automatically when sending an email. The thread can be started manually (in case of restart) by calling its manage_restartQueueThread?action=start method through HTTP. There is currently no possibility to start the thread at Zope startup time.

Supports TLS/SSL encryption (requires Python compiled with SSL support).

Configuration

To force MailHost to only queue mails without sending them, activate queuing in the ZMI and set the environment variable MAILHOST_QUEUE_ONLY=1. This could be helpful in a staging environment where mails should not be sent.

Changelog

5.1 (2024-02-07)

• Remove doc string from the MailHost send method to prevent publishing.

• Add support for Python 3.12.

5.0 (2023-02-01)

• Drop support for Python 2.7, 3.5, 3.6.

4.13 (2022-12-16)

• Fix insidious buildout configuration bug for tests against Zope 4.

• Add support for Python 3.11.

4.12 (2022-03-30)

• Add support for Python 3.9 and 3.10.

4.11 (2021-01-21)

• Use standard conforming \r\n line endings. This may require adaptations in testsSupport messages with line separation \r\n (#35).

4.10 (2020-07-31)

• We depend on zope.sendmail >= 5.1.

• Support messages with explicit Content-Transfer-Encoding: 8bit (#30).

4.9 (2020-02-12)

• Fix DeprecationWarnings from DocumentTemplate with import changes

4.8 (2020-01-06)

• Show a hint in the ZMI if the delivery queue is forced to queue-only mode (#25)

• Improve the asynchronous delivery information on the ZMI Edit tab (#24)

• Fix queued mail delivery with just a single string receiver email (#26)

• Fix Flake8 issues. (#22)

4.7 (2019-06-03)

• Do not start QueueProcessorThread on configuration update. (#14)

4.6 (2019-05-16)

• Fix breaking sendmail tag rendering with DocumentTemplate > 3

4.5 (2019-04-07)

• Prevent ZMI blowups when pointing to a non-Maildir queue folder (#2)

• Changed ZMI forms for Zope 4 ZMI compliance (#17)

• Packaging and test configuration cleanup

• Add badges to the README

4.4 (2019-04-03)

• Add ability to disable sending of queued mails. Details see README.rst. (#14)

4.3 (2019-03-08)

• silence deprecation warning due to non-raw regex (#13)

• Specify supported Python versions using python_requires in setup.py (Zope#481)

• Add support for Python 3.8

4.2 (2018-10-05)

• Add icon for Bootstrap ZMI.

• Fix start-up in case Products.GenericSetup is not installed. (#9)

• Add support for Python 3.7.

4.1 (2018-05-20)

• Fix GenericSetup support for GenericSetup 2.x

• Fix DeprecationWarnings

• PEP-8 code style compliance

• Drop support for Python 3.4

4.0 (2017-09-14)

• Move GenericSetup export/import support from the GenericSetup package to MailHost as a setuptools extra.

• Python 3 compatibility

• Require Zope 4, aka drop Zope 2.13 support.

• add test coverage reporting

• Use @implementer class decorator.

• Drop long-deprecated support for uuencoded emails.

3.0 (2016-07-18)

• Remove HelpSys support.

2.13.2 (2014-11-02)

• Adjust tests to pass with latest zope.sendmail versions.

• Specify detailed distribution dependencies.

2.13.1 (2010-09-25)

• LP #642728: Fixed TypeError on nested multi part messages in MailHost.

2.13.0 (2010-07-13)

• Released as separate package.