From 881b4842ff00a7e33c9bab6485c342884c27ea56 Mon Sep 17 00:00:00 2001 From: medmunds Date: Sun, 12 Jan 2014 11:14:33 -0800 Subject: [PATCH] Prep for 0.8 release --- AUTHORS.txt | 1 + docs/history.rst | 2 ++ docs/usage/sending_mail.rst | 9 +++++++-- 3 files changed, 10 insertions(+), 2 deletions(-) diff --git a/AUTHORS.txt b/AUTHORS.txt index 7949e62..411b114 100644 --- a/AUTHORS.txt +++ b/AUTHORS.txt @@ -11,3 +11,4 @@ Jared Morse peillis José Padilla Jens Alm +Eric Hennings diff --git a/docs/history.rst b/docs/history.rst index 1dfa8cf..1a12012 100644 --- a/docs/history.rst +++ b/docs/history.rst @@ -3,6 +3,8 @@ Release Notes Version 0.8 (development): +* Expose :ref:`mandrill_response` on sent messages + Version 0.7: diff --git a/docs/usage/sending_mail.rst b/docs/usage/sending_mail.rst index 3909ff7..1a238c5 100644 --- a/docs/usage/sending_mail.rst +++ b/docs/usage/sending_mail.rst @@ -276,13 +276,14 @@ see :class:`DjrillMandrillFeatureTests` in :file:`tests/test_mandrill_send.py` f .. _mandrill-response: Mandrill Response ---------------------------------- +----------------- + A ``mandrill_response`` property is added to each :class:`~django.core.mail.EmailMessage` that you send. This allows you to retrieve message ids, initial status information and more. For an EmailMessage that is successfully sent to one or more email addresses, ``mandrill_response`` will be set to a ``list`` of ``dict``, where each entry has info for one email address. See the Mandrill docs for the -/messages/send api for full details. +`messages/send API `_ for full details. For example, to get the Mandrill message id for a sent email you might do this:: @@ -304,6 +305,10 @@ For this example, msg.mandrill_response might look like this:: If an error is returned by Mandrill while sending the message then ``mandrill_response`` will be set to None. +.. versionadded:: 0.8 + mandrill_response available for sent messages + + .. _djrill-exceptions: Exceptions