Django4.0 测试工具-邮件服务
如果你的任何 Django 视图使用 Django 的邮件功能 发送电子邮件,你可能不想每次使用该视图运行测试时都发送电子邮件。出于这个原因,Django 的测试运行器会自动将所有 Django 发送的邮件重定向到一个虚拟的发件箱。这让你可以测试发送邮件的每一个方面——从发送邮件的数量到每封邮件的内容——而不用实际发送邮件。
测试运行器通过透明的将正常的邮件后端替换为测试后端来实现。
django.core.mail.outbox
在测试运行过程中,每一封发出的邮件都会保存在 django.core.mail.outbox
中。这是所有已经发送的 EmailMessage
实例的列表。 outbox
属性是一个特殊的属性,只有在使用 locmem
邮件后端时才会创建。它通常不作为 django.core.mail
模块的一部分存在,你也不能直接导入它。下面的代码展示了如何正确访问这个属性。
下面是一个检查 django.core.mail.outbox
长度和内容的测试示例:
from django.core import mail
from django.test import TestCase
class EmailTest(TestCase):
def test_send_email(self):
# Send message.
mail.send_mail(
'Subject here', 'Here is the message.',
'from@example.com', ['to@example.com'],
fail_silently=False,
)
# Test that one message has been sent.
self.assertEqual(len(mail.outbox), 1)
# Verify that the subject of the first message is correct.
self.assertEqual(mail.outbox[0].subject, 'Subject here')
在 Django *TestCase
中的每个测试开始时,测试发件箱都会被清空。要手动清空发件箱,将空列表分配给 mail.outbox
:
from django.core import mail
# Empty the test outbox
mail.outbox = []