mirrors/django
1
0
Fork 0
mirror of https://github.com/django/django.git synced 2025-01-03 06:55:47 +00:00
Code Issues 30 Releases Wiki Activity

Fixed #35864 -- Documented EmailMessage.connection is ignored when using send_messages().

Browse Source
This commit is contained in:
Mike Edmunds 2024-10-28 12:54:20 -07:00 committed by Sarah Boyce
parent 8f3dee1dfd
commit 17c8ee7e3f
1 changed files with 9 additions and 6 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

15
docs/topics/email.txt
View File

@ -311,9 +311,11 @@ All parameters are optional and can be set at any time prior to calling the
* ``bcc``: A list or tuple of addresses used in the "Bcc" header when * ``bcc``: A list or tuple of addresses used in the "Bcc" header when
sending the email. sending the email.
* ``connection``: An email backend instance. Use this parameter if * ``connection``: An :ref:`email backend <topic-email-backends>` instance. Use
you want to use the same connection for multiple messages. If omitted, a this parameter if you are sending the ``EmailMessage`` via ``send()`` and you
new connection is created when ``send()`` is called. want to use the same connection for multiple messages. If omitted, a new
connection is created when ``send()`` is called. This parameter is ignored
when using :ref:`send_messages() <topics-sending-multiple-emails>`.
* ``attachments``: A list of attachments to put on the message. These can * ``attachments``: A list of attachments to put on the message. These can
be instances of :class:`~email.mime.base.MIMEBase` or be instances of :class:`~email.mime.base.MIMEBase` or
@ -728,9 +730,10 @@ destroying a connection every time you want to send an email.
There are two ways you tell an email backend to reuse a connection. There are two ways you tell an email backend to reuse a connection.
Firstly, you can use the ``send_messages()`` method. ``send_messages()`` takes Firstly, you can use the ``send_messages()`` method on a connection. This takes
a list of :class:`~django.core.mail.EmailMessage` instances (or subclasses), a list of :class:`EmailMessage` (or subclass) instances, and sends them all
and sends them all using a single connection. using that single connection. As a consequence, any :class:`connection
<EmailMessage>` set on an individual message is ignored.
For example, if you have a function called ``get_notification_email()`` that For example, if you have a function called ``get_notification_email()`` that
returns a list of :class:`~django.core.mail.EmailMessage` objects representing returns a list of :class:`~django.core.mail.EmailMessage` objects representing