``pyramid_mailer``
==================
.. image:: https://travis-ci.org/Pylons/pyramid_mailer.png?branch=master
:target: https://travis-ci.org/Pylons/pyramid_mailer
.. image:: https://readthedocs.org/projects/pyramid_mailer/badge/?version=latest
:target: http://docs.pylonsproject.org/projects/pyramid_mailer/en/latest/
:alt: Documentation Status
pyramid_mailer is a package for sending email from your Pyramid application.
It is compatible with Python 2.7, 3.3, 3.4, and 3.5, as well as PyPy.
This package includes:
1. Wrapping the low-level Python ``email`` library with an easy-to-use
API, which includes attachments and mulipart content.
2. Send emails immediately or to add to a maildir queue.
3. Managing email sends inside a transaction, to prevent emails being sent
if your code raises an exception.
4. Features to help with unit testing.
``pyramid_mailer`` uses the ``repoze.sendmail`` library for managing email
sending and transacton management, and borrows code (with permission) from
Zed Shaw's `lamson <https://github.com/zedshaw/lamson>`_ for wrapping email
messages. See the ``LICENSE.txt`` file for more information.
Links
-----
- `documentation
<http://docs.pylonsproject.org/projects/pyramid_mailer/en/latest/>`_
- `development version
<https://github.com/Pylons/pyramid_mailer>`_
Changelog
=========
0.15.1 (2016-12-13)
-------------------
- Pull #83: Add the new ``.bind`` method to the ``DebugMailer`` and the
``DummyMailer``. Also ``pyramid_mailer.testing`` and
``pyramid_mailer.debug`` now add the ``request.mailer`` request attribute.
0.15 (2016-12-06)
-----------------
- Pull #49: Support '7bit' and '8bit' transfer-encoding.
- Pull #70: If ``username`` and ``password`` are both set to the empty string,
``Mailer.from_settings``, now interprets them as being set to ``None``.
Previously, setting them to the empty string caused SMTP authentication
to be force with empty username and password.
- Pull #71: Add a ``content_id`` argument to the ``Attachment`` constructor
which allows you to set the Content-ID header so you can reference it from
an HTML body.
- Pull #72: Change file extension to ``.eml`` for mails saved from
``DebugMailer``. ``.eml`` is the standard file format for storing
plaintext MIME (rfc822) emails.
- Pull #77: Drop Python 2.6 and 3.2 support.
- Add Python 3.5 support.
- Pull #78: Support per-request transaction managers if available via
``request.tm`` set by ``pyramid_tm``.
0.14.1 (2015-05-21)
-------------------
- Enable compatibility testing with Pyramid all the way back to 1.2. It may
work earlier but we aren't testing it any longer.
- Fix a bug where the ``mailer.debug`` ini option was not properly being
cast to an ``int``. This did not show up on Python 2 because string
to int comparisons are valid there but it was a latent bug.
See https://github.com/Pylons/pyramid_mailer/pull/68
0.14 (2014-12-10)
-----------------
- Added support for Python3.4, PyPy3.
- Pull #56: Ensure that ``DebugMailer`` emulates ``Mailer`` by generating
a sender if none is passed.
- Pull #52: Add configuration options for ``mail.sendmail_app`` and
``mail.sendmail_template`` to allow use with non-default sendmail
configurations.
- Pull #50: Add ``pyramid_mailer.debug`` shorthand: via one line in
``development.ini``, enables writing emails to a file instead of sending
them.
0.13 (2013-07-13)
-----------------
- Pull #45: Default transfer encoding for mail messages is now
'quoted-printable'.
0.12 (2013-06-26)
-----------------
- Pull #35: aadded support for sendmail binary via repoze.sendmail >= 4.0b2.
- Remove "all_parts" and "attach_all_parts" from MailResponse object (unused by
pyramid_mailer).
- The Attachment class no longer supports reading data from the a file based on
the ``filename`` it is passed. Instead, use the filename argument only as
something that should go in the Content-Disposition header, and pass a
filelike object as ``data``.
- Major code overhaul: nonascii attachment sending now actually works, most of
the code stolen from Lamson was gutted and replaced.
- Requires repoze.sendmail >= 4.1
0.11 (2013-03-28)
-----------------
- Issue #29: Allow setting Content-Transfer-Encoding for body and html
via Attachments.
- Issue #32: Fix handling of messages with both HTML and plain text
bodies that also have attachments.
- Issue #24: ensure that ``pyramid_mailer.response.to_message`` returns
text under Python 3.x.
- Dropped support for Python 2.5.
0.10 (2012-11-22)
-----------------
- Set default transfer encoding for attachments to ``base64`` and allow
an optional ``transfer_encoding`` argument for attachments. This currently
supports ``base64`` or ``quoted-printable``.
- Properly handle ``Mailer.from_settings`` boolean options including ``tls``
and ``ssl``.
- Support ``setup.py dev`` (installs testing dependencies).
- Use ``setup.py dev`` in tox.ini.
0.9 (2012-05-03)
----------------
- Add a test for uncode encoding in multipart messages.
- Depend on ``repoze.sendmail`` >= 3.2 (fixes unicode multipart message
encoding).
0.8 (2012-03-26)
----------------
- Work around a Python 3.2.0 bug in handling emails with empty headers. This
allows cc-only and bcc-only emails to be handled properly on all platforms
(no recipient= required anymore). See
https://github.com/Pylons/pyramid_mailer/issues/14.
0.7 (2012-03-26)
----------------
- Packaging release
0.6 (2012-03-20)
----------------
- Python 2.5, 2.6, 2.7, 3.2, and pypy compatibility.
- Remove explicit Jython support. It may work, but we no longer test it
using automated testing.
- Requires repoze.sendmail 3.0+.
- More descriptive exception raised when attempting to send cc-only or
bcc-only messages. See https://github.com/Pylons/pyramid_mailer/issues/14
0.6 (2012-01-22)
----------------
- Use ',' as an email header field separator rather than ';' when multiple
values are in the same header (as per RFC822).
- Allow lists of recipient emails to be tuples or lists (previously it was
just lists).
- Don't include ``Bcc`` header in mail messages (breaks secrecy of BCC).
See https://github.com/Pylons/pyramid_mailer/pull/10
0.5.1 (2011-11-13)
------------------
- Fixed a bug where the mailer was only sending email to addresses in
the "TO" field.
0.5 (2011-10-24)
----------------
- Drop Lamson dependency by copying Lamson's MailResponse and dependent code
into ``pyramid_mailer.response``.
0.4.X
-----
- ``pyramid_mailer.includeme`` function added for
``config.include('pyramid_mailer')`` support
- ``pyramid_mailer.testing`` module added for
``config.include('pyramid_mailer.testing')`` support.
- ``pyramid_mailer.get_mailer`` API added (see docs).
- ``pyramid_mailer.interfaces`` module readded (with marker IMailer interface
for ZCA registration).
- ``setup.cfg`` added with coverage parameters to allow for ``setup.py
nosetests --with-coverage``.
Raw data
{
"_id": null,
"home_page": "http://docs.pylonsproject.org/projects/pyramid-mailer/en/latest/",
"name": "pyramid_mailer",
"maintainer": "",
"docs_url": "https://pythonhosted.org/pyramid_mailer/",
"requires_python": "",
"maintainer_email": "",
"keywords": "",
"author": "Dan Jacob",
"author_email": "danjac354@gmail.com",
"download_url": "https://files.pythonhosted.org/packages/a0/f2/6febf5459dff4d7e653314d575469ad2e11b9d2af2c3606360e1c67202f2/pyramid_mailer-0.15.1.tar.gz",
"platform": "any",
"description": "``pyramid_mailer``\n==================\n\n.. image:: https://travis-ci.org/Pylons/pyramid_mailer.png?branch=master\n :target: https://travis-ci.org/Pylons/pyramid_mailer\n\n.. image:: https://readthedocs.org/projects/pyramid_mailer/badge/?version=latest\n :target: http://docs.pylonsproject.org/projects/pyramid_mailer/en/latest/\n :alt: Documentation Status\n\npyramid_mailer is a package for sending email from your Pyramid application.\nIt is compatible with Python 2.7, 3.3, 3.4, and 3.5, as well as PyPy.\n\nThis package includes:\n\n1. Wrapping the low-level Python ``email`` library with an easy-to-use\n API, which includes attachments and mulipart content.\n\n2. Send emails immediately or to add to a maildir queue.\n\n3. Managing email sends inside a transaction, to prevent emails being sent\n if your code raises an exception.\n\n4. Features to help with unit testing.\n\n``pyramid_mailer`` uses the ``repoze.sendmail`` library for managing email\nsending and transacton management, and borrows code (with permission) from\nZed Shaw's `lamson <https://github.com/zedshaw/lamson>`_ for wrapping email\nmessages. See the ``LICENSE.txt`` file for more information.\n\nLinks\n-----\n\n- `documentation\n <http://docs.pylonsproject.org/projects/pyramid_mailer/en/latest/>`_\n\n- `development version\n <https://github.com/Pylons/pyramid_mailer>`_\n\n\nChangelog\n=========\n\n0.15.1 (2016-12-13)\n-------------------\n\n- Pull #83: Add the new ``.bind`` method to the ``DebugMailer`` and the\n ``DummyMailer``. Also ``pyramid_mailer.testing`` and\n ``pyramid_mailer.debug`` now add the ``request.mailer`` request attribute.\n\n0.15 (2016-12-06)\n-----------------\n\n- Pull #49: Support '7bit' and '8bit' transfer-encoding.\n\n- Pull #70: If ``username`` and ``password`` are both set to the empty string,\n ``Mailer.from_settings``, now interprets them as being set to ``None``.\n Previously, setting them to the empty string caused SMTP authentication\n to be force with empty username and password.\n\n- Pull #71: Add a ``content_id`` argument to the ``Attachment`` constructor\n which allows you to set the Content-ID header so you can reference it from\n an HTML body.\n\n- Pull #72: Change file extension to ``.eml`` for mails saved from\n ``DebugMailer``. ``.eml`` is the standard file format for storing\n plaintext MIME (rfc822) emails.\n\n- Pull #77: Drop Python 2.6 and 3.2 support.\n\n- Add Python 3.5 support.\n\n- Pull #78: Support per-request transaction managers if available via\n ``request.tm`` set by ``pyramid_tm``.\n\n0.14.1 (2015-05-21)\n-------------------\n\n- Enable compatibility testing with Pyramid all the way back to 1.2. It may\n work earlier but we aren't testing it any longer.\n\n- Fix a bug where the ``mailer.debug`` ini option was not properly being\n cast to an ``int``. This did not show up on Python 2 because string\n to int comparisons are valid there but it was a latent bug.\n See https://github.com/Pylons/pyramid_mailer/pull/68\n\n0.14 (2014-12-10)\n-----------------\n\n- Added support for Python3.4, PyPy3.\n\n- Pull #56: Ensure that ``DebugMailer`` emulates ``Mailer`` by generating\n a sender if none is passed.\n\n- Pull #52: Add configuration options for ``mail.sendmail_app`` and\n ``mail.sendmail_template`` to allow use with non-default sendmail\n configurations.\n\n- Pull #50: Add ``pyramid_mailer.debug`` shorthand: via one line in\n ``development.ini``, enables writing emails to a file instead of sending\n them.\n\n0.13 (2013-07-13)\n-----------------\n\n- Pull #45: Default transfer encoding for mail messages is now\n 'quoted-printable'.\n\n0.12 (2013-06-26)\n-----------------\n\n- Pull #35: aadded support for sendmail binary via repoze.sendmail >= 4.0b2.\n\n- Remove \"all_parts\" and \"attach_all_parts\" from MailResponse object (unused by\n pyramid_mailer).\n\n- The Attachment class no longer supports reading data from the a file based on\n the ``filename`` it is passed. Instead, use the filename argument only as\n something that should go in the Content-Disposition header, and pass a\n filelike object as ``data``.\n\n- Major code overhaul: nonascii attachment sending now actually works, most of\n the code stolen from Lamson was gutted and replaced.\n\n- Requires repoze.sendmail >= 4.1\n\n0.11 (2013-03-28)\n-----------------\n\n- Issue #29: Allow setting Content-Transfer-Encoding for body and html\n via Attachments.\n\n- Issue #32: Fix handling of messages with both HTML and plain text\n bodies that also have attachments.\n\n- Issue #24: ensure that ``pyramid_mailer.response.to_message`` returns\n text under Python 3.x.\n\n- Dropped support for Python 2.5.\n\n0.10 (2012-11-22)\n-----------------\n\n- Set default transfer encoding for attachments to ``base64`` and allow\n an optional ``transfer_encoding`` argument for attachments. This currently\n supports ``base64`` or ``quoted-printable``.\n\n- Properly handle ``Mailer.from_settings`` boolean options including ``tls``\n and ``ssl``.\n\n- Support ``setup.py dev`` (installs testing dependencies).\n\n- Use ``setup.py dev`` in tox.ini.\n\n0.9 (2012-05-03)\n----------------\n\n- Add a test for uncode encoding in multipart messages.\n\n- Depend on ``repoze.sendmail`` >= 3.2 (fixes unicode multipart message\n encoding).\n\n0.8 (2012-03-26)\n----------------\n\n- Work around a Python 3.2.0 bug in handling emails with empty headers. This\n allows cc-only and bcc-only emails to be handled properly on all platforms\n (no recipient= required anymore). See\n https://github.com/Pylons/pyramid_mailer/issues/14.\n\n0.7 (2012-03-26)\n----------------\n\n- Packaging release\n\n0.6 (2012-03-20)\n----------------\n\n- Python 2.5, 2.6, 2.7, 3.2, and pypy compatibility.\n\n- Remove explicit Jython support. It may work, but we no longer test it\n using automated testing.\n\n- Requires repoze.sendmail 3.0+.\n\n- More descriptive exception raised when attempting to send cc-only or\n bcc-only messages. See https://github.com/Pylons/pyramid_mailer/issues/14\n\n0.6 (2012-01-22)\n----------------\n\n- Use ',' as an email header field separator rather than ';' when multiple\n values are in the same header (as per RFC822).\n\n- Allow lists of recipient emails to be tuples or lists (previously it was\n just lists).\n\n- Don't include ``Bcc`` header in mail messages (breaks secrecy of BCC).\n See https://github.com/Pylons/pyramid_mailer/pull/10\n\n0.5.1 (2011-11-13)\n------------------\n\n- Fixed a bug where the mailer was only sending email to addresses in\n the \"TO\" field.\n\n0.5 (2011-10-24)\n----------------\n\n- Drop Lamson dependency by copying Lamson's MailResponse and dependent code\n into ``pyramid_mailer.response``.\n\n0.4.X\n-----\n\n- ``pyramid_mailer.includeme`` function added for\n ``config.include('pyramid_mailer')`` support\n\n- ``pyramid_mailer.testing`` module added for\n ``config.include('pyramid_mailer.testing')`` support.\n\n- ``pyramid_mailer.get_mailer`` API added (see docs).\n\n- ``pyramid_mailer.interfaces`` module readded (with marker IMailer interface\n for ZCA registration).\n\n- ``setup.cfg`` added with coverage parameters to allow for ``setup.py\n nosetests --with-coverage``.\n\n\n",
"bugtrack_url": null,
"license": "BSD",
"summary": "Sendmail package for Pyramid",
"version": "0.15.1",
"project_urls": {
"Homepage": "http://docs.pylonsproject.org/projects/pyramid-mailer/en/latest/"
},
"split_keywords": [],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "eac30ce593179a8da8e1ab7fe178b0ae096a046246bd44a5787f72940d6dd5b2",
"md5": "ca684fabc4d5e89ab29d2d2fde7f0910",
"sha256": "28d4a7829ebc19dd40e712d8cb1998cec03c296ba675b2c112a503539738bdc1"
},
"downloads": -1,
"filename": "pyramid_mailer-0.15.1-py2.py3-none-any.whl",
"has_sig": false,
"md5_digest": "ca684fabc4d5e89ab29d2d2fde7f0910",
"packagetype": "bdist_wheel",
"python_version": "py2.py3",
"requires_python": null,
"size": 19041,
"upload_time": "2016-12-13T20:48:50",
"upload_time_iso_8601": "2016-12-13T20:48:50.069155Z",
"url": "https://files.pythonhosted.org/packages/ea/c3/0ce593179a8da8e1ab7fe178b0ae096a046246bd44a5787f72940d6dd5b2/pyramid_mailer-0.15.1-py2.py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "a0f26febf5459dff4d7e653314d575469ad2e11b9d2af2c3606360e1c67202f2",
"md5": "284d294f62b69f974335627e85ca7ba5",
"sha256": "ec0aff54d9179b2aa2922ff82c2016a4dc8d1da5dc3408d6594f0e2096446f9b"
},
"downloads": -1,
"filename": "pyramid_mailer-0.15.1.tar.gz",
"has_sig": false,
"md5_digest": "284d294f62b69f974335627e85ca7ba5",
"packagetype": "sdist",
"python_version": "source",
"requires_python": null,
"size": 46836,
"upload_time": "2016-12-13T20:49:52",
"upload_time_iso_8601": "2016-12-13T20:49:52.806633Z",
"url": "https://files.pythonhosted.org/packages/a0/f2/6febf5459dff4d7e653314d575469ad2e11b9d2af2c3606360e1c67202f2/pyramid_mailer-0.15.1.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2016-12-13 20:49:52",
"github": false,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"lcname": "pyramid_mailer"
}
JSON