From 5cd7af58c933a093aa17515d099d45bc9347d2c8 Mon Sep 17 00:00:00 2001 From: Malcolm Tredinnick Date: Sun, 5 Oct 2008 06:39:26 +0000 Subject: [PATCH] Fixed a typo and clarified how django.core.mail.outbox works in the testing framework. Fixed #9237. git-svn-id: http://code.djangoproject.com/svn/django/trunk@9140 bcc190cf-cafb-0310-a4f2-bffc1f526a37 --- docs/topics/testing.txt | 7 ++++++- 1 file changed, 6 insertions(+), 1 deletion(-) diff --git a/docs/topics/testing.txt b/docs/topics/testing.txt index 0916f52388b..4f37b3bdc08 100644 --- a/docs/topics/testing.txt +++ b/docs/topics/testing.txt @@ -950,7 +950,7 @@ Django, such as your machine's mail server, if you're running one.) .. currentmodule:: django.core.mail -.. data:: django.core.mail.output +.. data:: django.core.mail.outbox During test running, each outgoing e-mail is saved in ``django.core.mail.outbox``. This is a simple list of all @@ -961,6 +961,11 @@ dummy :class:`<~django.core.mail.SMTPConnection>`. When the test framework is torn down, the standard :class:`<~django.core.mail.SMTPConnection>` class is restored, and the test outbox is destroyed. +The ``outbox`` attribute is a special attribute that is created *only* when +the tests are run. It doesn't normally exist as part of the +:mod:`django.core.mail` module and you can't import it directly. The code +below shows how to access this attribute correctly. + Here's an example test that examines ``django.core.mail.outbox`` for length and contents::