我需要测试我的Django应用程序是否发送了具有正确内容的电子邮件。我不想依赖外部系统(例如临时gmail帐户),因为我没有测试实际的电子邮件服务...
我可能想在发送电子邮件时将电子邮件本地存储在一个文件夹中。关于如何实现的任何提示?
Answers:
您可以使用文件后端发送电子邮件,这对于开发和测试是非常方便的解决方案。电子邮件不会发送,而是存储在您可以指定的文件夹中!
Django测试框架内置了一些帮助器,可以帮助您测试电子邮件服务。
来自文档的示例(简短版本):
from django.core import mail
from django.test import TestCase
class EmailTest(TestCase):
def test_send_email(self):
mail.send_mail('Subject here', 'Here is the message.',
'from@example.com', ['to@example.com'],
fail_silently=False)
self.assertEqual(len(mail.outbox), 1)
self.assertEqual(mail.outbox[0].subject, 'Subject here')
send_mail
没有用。
mail
怎么办?
mail.outbox
时仍可以访问send_mail
。
mail.outbox[0].body
即使send_mail
在其他地方执行了邮件发送,也会显示给您已发送的电子邮件。
如果您要进行单元测试,最好的解决方案是使用django提供的内存中后端。
EMAIL_BACKEND = 'django.core.mail.backends.locmem.EmailBackend'
以将其用作py.test固定装置为例
@pytest.fixture(autouse=True)
def email_backend_setup(self, settings):
settings.EMAIL_BACKEND = 'django.core.mail.backends.locmem.EmailBackend'
在每个测试中,mail.outbox
服务器都会重置,因此测试之间没有副作用。
from django.core import mail
def test_send(self):
mail.send_mail('subject', 'body.', 'from@example.com', ['to@example.com'])
assert len(mail.outbox) == 1
def test_send_again(self):
mail.send_mail('subject', 'body.', 'from@example.com', ['to@example.com'])
assert len(mail.outbox) == 1
使用MailHog
受MailCatcher启发,易于安装。
使用Go构建-MailHog无需安装在多个平台上即可运行。
此外,它还有一个名为Jim的组件,MailHog Chaos Monkey,它使您能够测试正在发生的各种问题的电子邮件发送:
吉姆能做什么?
- 拒绝连接
- 限速连接
- 拒绝身份验证
- 拒绝发件人
- 拒绝收件人
在此处了解更多信息。
(与原始mailcatcher不同,它在发送带有emoji表情的电子邮件时失败了,该电子邮件使用UTF-8编码,并且在当前版本中并未得到真正修复,MailHog可以正常工作。)
对于不需要发送附件的任何项目,我使用django-mailer,它的好处是所有出站电子邮件最终都排在队列中,直到我触发它们的发送,甚至在它们发送之后,也都将它们记录下来-所有这些内容都可以在Admin中看到,从而可以轻松快速地检查您通过电子邮件发送的代码试图插入管道的内容。
修补SMTPLib以进行测试可以帮助测试发送邮件而不发送邮件。
将此处的一些内容捆绑在一起,这是基于的简单设置filebased.EmailBackend
。这将呈现一个链接到各个日志文件的列表视图,这些日志文件具有方便地带有时间戳的文件名。单击列表中的链接,将在浏览器中显示该消息(原始):
设定值
EMAIL_BACKEND = "django.core.mail.backends.filebased.EmailBackend"
EMAIL_FILE_PATH = f"{MEDIA_ROOT}/email_out"
视图
import os
from django.conf import settings
from django.shortcuts import render
def mailcheck(request):
path = f"{settings.MEDIA_ROOT}/email_out"
mail_list = os.listdir(path)
return render(request, "mailcheck.html", context={"mail_list": mail_list})
模板
{% if mail_list %}
<ul>
{% for msg in mail_list %}
<li>
<a href="{{ MEDIA_URL }}email_out/{{msg}}">{{ msg }}</a>
</li>
{% endfor %}
</ul>
{% else %}
No messages found.
{% endif %}
网址
path("mailcheck/", view=mailcheck, name="mailcheck"),
为什么不通过继承自smtpd.SMTPServer
和启动您自己的非常简单的SMTP服务器threading.Thread
:
class TestingSMTPServer(smtpd.SMTPServer, threading.Thread):
def __init__(self, port=25):
smtpd.SMTPServer.__init__(
self,
('localhost', port),
('localhost', port),
decode_data=False
)
threading.Thread.__init__(self)
def process_message(self, peer, mailfrom, rcpttos, data, **kwargs):
self.received_peer = peer
self.received_mailfrom = mailfrom
self.received_rcpttos = rcpttos
self.received_data = data
def run(self):
asyncore.loop()
每当SMTP服务器收到邮件请求时,都会调用process_message,您可以在该处执行任何操作。
在测试代码中,执行以下操作:
smtp_server = TestingSMTPServer()
smtp_server.start()
do_thing_that_would_send_a_mail()
smtp_server.close()
self.assertIn(b'hello', smtp_server.received_data)
只记得close()
在asyncore.dispatcher
调用smtp_server.close()
结束asyncore循环(停止从听音服务器)。
如果您有可用的TomCat服务器或其他Servlet引擎,则“ Post Hoc”是一种不错的方法,它是一种小型服务器,在外观上与SMTP服务器完全相同,但是它包含一个用户界面,可用于查看和检查已发送的电子邮件。它是开源的,免费提供。
在以下位置找到它:Post Hoc GitHub Site
请参阅博客文章: PostHoc:测试发送电子邮件的应用程序