mirror of
https://github.com/pacnpal/django-anymail.git
synced 2025-12-20 11:51:05 -05:00
147 lines
4.5 KiB
ReStructuredText
147 lines
4.5 KiB
ReStructuredText
.. _history:
|
|
|
|
Release Notes
|
|
=============
|
|
|
|
Djrill practices `semantic versioning <semver>`_.
|
|
Among other things, this means that minor updates
|
|
(1.x to 1.y) should always be backwards-compatible,
|
|
and breaking changes will always increment the
|
|
major version number (1.x to 2.0).
|
|
|
|
|
|
Djrill 2.x
|
|
----------
|
|
|
|
Version 2.1 (in development):
|
|
|
|
* Handle Mandrill rejection whitelist/blacklist sync event webhooks
|
|
|
|
|
|
Version 2.0:
|
|
|
|
* **Breaking Changes:** please see the :ref:`upgrade guide <upgrading>`.
|
|
* Add Django 1.9 support; drop Django 1.3, Python 2.6, and Python 3.2 support
|
|
* Add global :setting:`MANDRILL_SETTINGS` dict that can provide defaults
|
|
for most Djrill message options
|
|
* Add :exc:`djrill.NotSerializableForMandrillError`
|
|
* Use a single HTTP connection to the Mandrill API to improve performance
|
|
when sending multiple messages at once using :func:`~django.core.mail.send_mass_mail`.
|
|
(You can also directly manage your own long-lived Djrill connection across multiple sends,
|
|
by calling open and close on :ref:`Django's email backend <django:topic-email-backends>`.)
|
|
* Add Djrill version to user-agent header when calling Mandrill API
|
|
* Improve diagnostics in exceptions from Djrill
|
|
* Remove DjrillAdminSite
|
|
* Remove unintended date-to-string conversion in JSON encoding
|
|
* Remove obsolete DjrillMessage class and DjrillBackendHTTPError
|
|
* Refactor Djrill backend and exceptions
|
|
|
|
|
|
Djrill 1.x and Earlier
|
|
----------------------
|
|
|
|
Version 1.4:
|
|
|
|
* Django 1.8 support
|
|
* Support new Django 1.8 EmailMessage reply_to param.
|
|
(Specifying a :ref:`Reply-To header <message-headers>`
|
|
still works, with any version of Django,
|
|
and will override the reply_to param if you use both.)
|
|
* Include Mandrill error response in str(MandrillAPIError),
|
|
to make errors easier to understand.
|
|
* More-helpful exception when using a non-JSON-serializable
|
|
type in merge_vars and other Djrill message attributes
|
|
* Deprecation warnings for upcoming 2.0 changes (see above)
|
|
|
|
|
|
Version 1.3:
|
|
|
|
* Use Mandrill secure https API endpoint (rather than http).
|
|
* Support :attr:`merge_language` option (for choosing between
|
|
Handlebars and Mailchimp templates).
|
|
|
|
|
|
Version 1.2:
|
|
|
|
* Support Django 1.7; add testing on Python 3.3, 3.4, and PyPy
|
|
* Bug fixes
|
|
|
|
|
|
Version 1.1:
|
|
|
|
* Allow use of Mandrill template default "from" and "subject" fields,
|
|
via :attr:`use_template_from` and :attr:`use_template_subject`.
|
|
* Fix `UnicodeEncodeError` with unicode attachments
|
|
|
|
|
|
Version 1.0:
|
|
|
|
* Global :setting:`MANDRILL_SUBACCOUNT` setting
|
|
|
|
|
|
Version 0.9:
|
|
|
|
* Better handling for "cc" and "bcc" recipients.
|
|
* Allow all extra message headers in send.
|
|
(Mandrill has relaxed previous API restrictions on headers.)
|
|
|
|
|
|
Version 0.8:
|
|
|
|
* Expose :ref:`mandrill-response` on sent messages
|
|
|
|
|
|
Version 0.7:
|
|
|
|
* Support for Mandrill send options :attr:`async`, :attr:`important`,
|
|
:attr:`ip_pool`, :attr:`return_path_domain`, :attr:`send_at`,
|
|
:attr:`subaccount`, and :attr:`view_content_link`
|
|
|
|
|
|
Version 0.6:
|
|
|
|
* Support for signed webhooks
|
|
|
|
|
|
Version 0.5:
|
|
|
|
* Support for incoming mail and other Mandrill webhooks
|
|
* Support for Mandrill send options :attr:`auto_html`, :attr:`tracking_domain`
|
|
and :attr:`signing_domain`.
|
|
|
|
|
|
Version 0.4:
|
|
|
|
* Attachments with a Content-ID are now treated as
|
|
:ref:`embedded images <sending-attachments>`
|
|
* New Mandrill :attr:`inline_css` option is supported
|
|
* Remove limitations on attachment types, to track Mandrill change
|
|
* Documentation is now available on
|
|
`djrill.readthedocs.org <https://djrill.readthedocs.org>`_
|
|
|
|
|
|
Version 0.3:
|
|
|
|
* :ref:`Attachments <sending-attachments>` are now supported
|
|
* :ref:`Mandrill templates <mandrill-templates>` are now supported
|
|
* A bcc address is now passed to Mandrill as bcc, rather than being lumped in
|
|
with the "to" recipients. Multiple bcc recipients will now raise an exception,
|
|
as Mandrill only allows one.
|
|
* Python 3 support (with Django 1.5)
|
|
* Exceptions should be more useful:
|
|
:exc:`djrill.NotSupportedByMandrillError` replaces generic ValueError;
|
|
:exc:`djrill.MandrillAPIError` replaces DjrillBackendHTTPError, and is now
|
|
derived from requests.HTTPError.
|
|
(New exceptions are backwards compatible with old ones for existing code.)
|
|
|
|
|
|
Version 0.2:
|
|
|
|
* ``MANDRILL_API_URL`` is no longer required in settings.py
|
|
* Earlier versions of Djrill required use of a ``DjrillMessage`` class to
|
|
specify Mandrill-specific options. This is no longer needed -- Mandrill
|
|
options can now be set directly on a Django ``EmailMessage`` object or any
|
|
subclass. (Existing code can continue to use ``DjrillMessage``.)
|
|
|
|
.. _semver: http://semver.org
|