.. image:: https://github.com/zopefoundation/Products.MailHost/actions/workflows/tests.yml/badge.svg
:target: https://github.com/zopefoundation/Products.MailHost/actions/workflows/tests.yml
.. image:: https://coveralls.io/repos/github/zopefoundation/Products.MailHost/badge.svg?branch=master
:target: https://coveralls.io/github/zopefoundation/Products.MailHost?branch=master
.. image:: https://img.shields.io/pypi/v/Products.MailHost.svg
:target: https://pypi.org/project/Products.MailHost/
:alt: Latest stable release on PyPI
.. image:: https://img.shields.io/pypi/pyversions/Products.MailHost.svg
:target: https://pypi.org/project/Products.MailHost/
:alt: Stable release supported Python versions
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.2 (2024-02-08)
----------------
- Use SMTP compatible line separators in generated messages.
- Remove doc string from the MailHost ``sendTemplate`` method
to prevent publishing.
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 <https://github.com/zopefoundation/Products.MailHost/issues/35>`_).
4.10 (2020-07-31)
-----------------
- We depend on ``zope.sendmail >= 5.1``.
- Support messages with explicit ``Content-Transfer-Encoding: 8bit``
(`#30 <https://github.com/zopefoundation/Products.MailHost/issues/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 <https://github.com/zopefoundation/Products.MailHost/issues/25>`_)
- Improve the asynchronous delivery information on the ZMI Edit tab
(`#24 <https://github.com/zopefoundation/Products.MailHost/issues/24>`_)
- Fix queued mail delivery with just a single string receiver email
(`#26 <https://github.com/zopefoundation/Products.MailHost/issues/26>`_)
- Fix Flake8 issues.
(`#22 <https://github.com/zopefoundation/Products.MailHost/issues/22>`_)
4.7 (2019-06-03)
----------------
- Do not start QueueProcessorThread on configuration update.
(`#14 <https://github.com/zopefoundation/Products.MailHost/issues/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 <https://github.com/zopefoundation/Products.MailHost/issues/2>`_)
- Changed ZMI forms for Zope 4 ZMI compliance
(`#17 <https://github.com/zopefoundation/Products.MailHost/issues/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 <https://github.com/zopefoundation/Products.MailHost/issues/14>`_)
4.3 (2019-03-08)
----------------
- silence deprecation warning due to non-raw regex
(`#13 <https://github.com/zopefoundation/Products.MailHost/issues/13>`_)
- Specify supported Python versions using ``python_requires`` in setup.py
(`Zope#481 <https://github.com/zopefoundation/Zope/issues/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 <https://github.com/zopefoundation/Products.MailHost/issues/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.
Raw data
{
"_id": null,
"home_page": "https://github.com/zopefoundation/Products.MailHost",
"name": "Products.MailHost",
"maintainer": "",
"docs_url": null,
"requires_python": ">=3.7",
"maintainer_email": "",
"keywords": "",
"author": "Zope Foundation and Contributors",
"author_email": "zope-dev@zope.dev",
"download_url": "https://files.pythonhosted.org/packages/ce/ca/b140d48db0ec4b251ee4b947b0667f99302945e8ac49bd37a14cab9f74b1/Products.MailHost-5.2.tar.gz",
"platform": null,
"description": ".. image:: https://github.com/zopefoundation/Products.MailHost/actions/workflows/tests.yml/badge.svg\n :target: https://github.com/zopefoundation/Products.MailHost/actions/workflows/tests.yml\n\n.. image:: https://coveralls.io/repos/github/zopefoundation/Products.MailHost/badge.svg?branch=master\n :target: https://coveralls.io/github/zopefoundation/Products.MailHost?branch=master\n\n.. image:: https://img.shields.io/pypi/v/Products.MailHost.svg\n :target: https://pypi.org/project/Products.MailHost/\n :alt: Latest stable release on PyPI\n\n.. image:: https://img.shields.io/pypi/pyversions/Products.MailHost.svg\n :target: https://pypi.org/project/Products.MailHost/\n :alt: Stable release supported Python versions\n\nProducts.MailHost\n=================\n\nThe MailHost product provides support for sending email from within the Zope\nenvironment using MailHost objects.\n\nAn optional character set can be specified to automatically encode unicode\ninput, and perform appropriate RFC 2822 header and body encoding for the\nspecified character set. Full python email.Message.Message objects may be sent.\n\nEmail can optionally be encoded using Base64 or Quoted-Printable encoding\n(though automatic body encoding will be applied if a character set is\nspecified).\n\nUsage\n-----\n\nMailHost provides integration with the Zope transaction system and optional\nsupport for asynchronous mail delivery. Asynchronous mail delivery is\nimplemented using a queue and a dedicated thread processing the queue. The\nthread is (re)-started automatically when sending an email. The thread can be\nstarted manually (in case of restart) by calling its\nmanage_restartQueueThread?action=start method through HTTP. There is currently\nno possibility to start the thread at Zope startup time.\n\nSupports TLS/SSL encryption (requires Python compiled with SSL support).\n\nConfiguration\n-------------\n\nTo force MailHost to only queue mails without sending them, activate queuing\nin the ZMI and set the environment variable ``MAILHOST_QUEUE_ONLY=1``.\nThis could be helpful in a staging environment where mails should not be sent.\n\nChangelog\n=========\n\n5.2 (2024-02-08)\n----------------\n\n- Use SMTP compatible line separators in generated messages.\n\n- Remove doc string from the MailHost ``sendTemplate`` method\n to prevent publishing.\n\n\n\n5.1 (2024-02-07)\n----------------\n\n- Remove doc string from the MailHost ``send`` method to prevent publishing.\n\n- Add support for Python 3.12.\n\n\n5.0 (2023-02-01)\n----------------\n\n- Drop support for Python 2.7, 3.5, 3.6.\n\n\n4.13 (2022-12-16)\n-----------------\n\n- Fix insidious buildout configuration bug for tests against Zope 4.\n\n- Add support for Python 3.11.\n\n\n4.12 (2022-03-30)\n-----------------\n\n- Add support for Python 3.9 and 3.10.\n\n\n4.11 (2021-01-21)\n-----------------\n\n- Use standard conforming ``\\r\\n`` line endings.\n This may require adaptations in testsSupport messages with line separation ``\\r\\n``\n (`#35 <https://github.com/zopefoundation/Products.MailHost/issues/35>`_).\n\n\n4.10 (2020-07-31)\n-----------------\n\n- We depend on ``zope.sendmail >= 5.1``.\n\n- Support messages with explicit ``Content-Transfer-Encoding: 8bit``\n (`#30 <https://github.com/zopefoundation/Products.MailHost/issues/30>`_).\n\n\n4.9 (2020-02-12)\n----------------\n\n- Fix DeprecationWarnings from ``DocumentTemplate`` with import changes\n\n\n4.8 (2020-01-06)\n----------------\n\n- Show a hint in the ZMI if the delivery queue is forced to queue-only mode\n (`#25 <https://github.com/zopefoundation/Products.MailHost/issues/25>`_)\n\n- Improve the asynchronous delivery information on the ZMI Edit tab\n (`#24 <https://github.com/zopefoundation/Products.MailHost/issues/24>`_)\n\n- Fix queued mail delivery with just a single string receiver email\n (`#26 <https://github.com/zopefoundation/Products.MailHost/issues/26>`_)\n\n- Fix Flake8 issues.\n (`#22 <https://github.com/zopefoundation/Products.MailHost/issues/22>`_)\n\n\n4.7 (2019-06-03)\n----------------\n\n- Do not start QueueProcessorThread on configuration update.\n (`#14 <https://github.com/zopefoundation/Products.MailHost/issues/14>`_)\n\n\n4.6 (2019-05-16)\n----------------\n\n- Fix breaking sendmail tag rendering with DocumentTemplate > 3\n\n\n4.5 (2019-04-07)\n----------------\n\n- Prevent ZMI blowups when pointing to a non-Maildir queue folder\n (`#2 <https://github.com/zopefoundation/Products.MailHost/issues/2>`_)\n\n- Changed ZMI forms for Zope 4 ZMI compliance\n (`#17 <https://github.com/zopefoundation/Products.MailHost/issues/17>`_)\n\n- Packaging and test configuration cleanup\n\n- Add badges to the README\n\n\n4.4 (2019-04-03)\n----------------\n\n- Add ability to disable sending of queued mails. Details see README.rst.\n (`#14 <https://github.com/zopefoundation/Products.MailHost/issues/14>`_)\n\n\n4.3 (2019-03-08)\n----------------\n\n- silence deprecation warning due to non-raw regex\n (`#13 <https://github.com/zopefoundation/Products.MailHost/issues/13>`_)\n\n- Specify supported Python versions using ``python_requires`` in setup.py\n (`Zope#481 <https://github.com/zopefoundation/Zope/issues/481>`_)\n\n- Add support for Python 3.8\n\n\n4.2 (2018-10-05)\n----------------\n\n- Add icon for Bootstrap ZMI.\n\n- Fix start-up in case ``Products.GenericSetup`` is not installed.\n (`#9 <https://github.com/zopefoundation/Products.MailHost/issues/9>`_)\n\n- Add support for Python 3.7.\n\n\n4.1 (2018-05-20)\n----------------\n\n- Fix GenericSetup support for GenericSetup 2.x\n\n- Fix DeprecationWarnings\n\n- PEP-8 code style compliance\n\n- Drop support for Python 3.4\n\n\n4.0 (2017-09-14)\n----------------\n\n- Move GenericSetup export/import support from the GenericSetup package\n to MailHost as a setuptools extra.\n\n- Python 3 compatibility\n\n- Require Zope 4, aka drop Zope 2.13 support.\n\n- add test coverage reporting\n\n- Use `@implementer` class decorator.\n\n- Drop long-deprecated support for uuencoded emails.\n\n3.0 (2016-07-18)\n----------------\n\n- Remove HelpSys support.\n\n2.13.2 (2014-11-02)\n-------------------\n\n- Adjust tests to pass with latest zope.sendmail versions.\n\n- Specify detailed distribution dependencies.\n\n2.13.1 (2010-09-25)\n-------------------\n\n- LP #642728: Fixed TypeError on nested multi part messages in MailHost.\n\n2.13.0 (2010-07-13)\n-------------------\n\n- Released as separate package.\n",
"bugtrack_url": null,
"license": "ZPL 2.1",
"summary": "zope.sendmail integration for Zope.",
"version": "5.2",
"project_urls": {
"Homepage": "https://github.com/zopefoundation/Products.MailHost",
"Issue Tracker": "https://github.com/zopefoundation/Products.MailHost/issues",
"Sources": "https://github.com/zopefoundation/Products.MailHost"
},
"split_keywords": [],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "a18370612a80ddef47ec96355d68babedbbc9b74ee4ae9f68988515b7a5309c6",
"md5": "c55e15a815aa19fe2692986449a57443",
"sha256": "5c2399b947f46b3a96202c9ca79ad79f512c6976b341b70d2359e24588794c6b"
},
"downloads": -1,
"filename": "Products.MailHost-5.2-py3-none-any.whl",
"has_sig": false,
"md5_digest": "c55e15a815aa19fe2692986449a57443",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.7",
"size": 29556,
"upload_time": "2024-02-08T12:22:26",
"upload_time_iso_8601": "2024-02-08T12:22:26.106957Z",
"url": "https://files.pythonhosted.org/packages/a1/83/70612a80ddef47ec96355d68babedbbc9b74ee4ae9f68988515b7a5309c6/Products.MailHost-5.2-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "cecab140d48db0ec4b251ee4b947b0667f99302945e8ac49bd37a14cab9f74b1",
"md5": "cbffccd69ead1cce922a7eb929250ee3",
"sha256": "4b88bf329e6ac9e3fad37245534b6aa99878624680d7ae350ee22c028c150bfc"
},
"downloads": -1,
"filename": "Products.MailHost-5.2.tar.gz",
"has_sig": false,
"md5_digest": "cbffccd69ead1cce922a7eb929250ee3",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.7",
"size": 26523,
"upload_time": "2024-02-08T12:22:27",
"upload_time_iso_8601": "2024-02-08T12:22:27.552004Z",
"url": "https://files.pythonhosted.org/packages/ce/ca/b140d48db0ec4b251ee4b947b0667f99302945e8ac49bd37a14cab9f74b1/Products.MailHost-5.2.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2024-02-08 12:22:27",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "zopefoundation",
"github_project": "Products.MailHost",
"travis_ci": false,
"coveralls": false,
"github_actions": true,
"tox": true,
"lcname": "products.mailhost"
}
JSON
