Testing Django email backend

Question

In my settings.py, I put:

EMAIL_BACKEND = 'mailer.backend.DbBackend'

So even when importing from from django.core.mail import send_mail, the send_mail function still queues up the email in the database instead of sending it immediately.

It works just fine when actually running the website, but when testing the website, and accessing some webpages that trigger emails, emails are no longer queued anymore:

def test_something(self):
    ...
    # Check no emails are actually sent yet
    self.assertEquals(len(mail.outbox), 0) # test fails here -- 2 != 0

    # Check queued emails.
    messages = Message.objects.all()
    self.assertEquals(messages.count(), 2) # test would also fail here -- 0 != 2
    ...

How come it doesn't seem to be using the backend when it is testing? (importing send_mail from mailer itself gets the tests to pass, but I can't really change the imports of other mailing apps like django-templated-email)

@AlexanderAfanasiev yes I have got the backend working when running the website with `runserver`; it's just not working when doing unit tests, for whatever reason. — wrongusername, Apr 24 '13 at 17:45

score 33 · Accepted Answer · edited May 23 '17 at 12:25

33

According to this question django overrides the setting.EMAIL_BACKEND when testing to 'django.core.mail.backends.locmem.EmailBackend'. It's also in the django docs here.

edited May 23 '17 at 12:25

Community

1
1

answered Apr 26 '13 at 12:15

Jacob Harding

631
7
15

4

Got it working with this answer: http://stackoverflow.com/a/15053970/257583. Many thanks!! – wrongusername Apr 26 '13 at 22:42

score 5 · Answer 2 · answered Sep 25 '14 at 15:28

To properly test email with django-mailer, you need to override two settings:

Make the tests to use the django-mailer backend
Make the djano-mailer backend to use the test backend

If you don't set the django-mailer backend (number 2), your tests will try to send the email for real.

You also need to simulate running django-mailer's send_mail management command so that you can check mail.outbox for the correct email.

Here's an example of how to setup a test method:

from mailer.engine import send_all

@override_settings(EMAIL_BACKEND='mailer.backend.DbBackend')
@override_settings(MAILER_EMAIL_BACKEND='django.core.mail.backends.locmem.EmailBackend')
def test_email(self):
    # Code that generates email goes here.

    send_all()  # Simulates running django-mailer's send_mail management command.

    # Code to check the email in mail.outbox goes here.

This strategy makes your tests specific to django-mailer which you don't always want or need. I personally only use this setup when I'm testing specific functionality enabled by django-mailer. Otherwise, I use the default test email backend setup by django.

andilabs · Answer 3 · 2020-05-08T15:33:03.180

3

If you really want have sending of emails (like default) via SMTP in django tests use the decorator:

from django.test.utils import override_settings    

@override_settings(EMAIL_BACKEND='django.core.mail.backends.smtp.EmailBackend')
class TestEmailVerification(TestCase):
   ...

edited May 08 '20 at 15:33

answered Apr 18 '18 at 21:43

andilabs

22,159
14
114
151

score 1 · Answer 4 · edited Oct 18 '20 at 20:07

1

Try the following:

django.core.mail.backends.console.EmailBackend

edited Oct 18 '20 at 20:07

Jeremy Caney

7,102
69
48
77

answered Oct 18 '20 at 11:20

Artem Uk

46
2

What's the benefit to this over `django.core.mail.backends.locmem.EmailBackend`, as articulated in [the accepted answer](https://stackoverflow.com/a/16236241/3025856) from seven years ago? – Jeremy Caney Oct 18 '20 at 20:07

Testing Django email backend

4 Answers4

Linked