summaryrefslogtreecommitdiff
path: root/docs/topics/testing.txt
diff options
context:
space:
mode:
Diffstat (limited to 'docs/topics/testing.txt')
-rw-r--r--docs/topics/testing.txt7
1 files changed, 6 insertions, 1 deletions
diff --git a/docs/topics/testing.txt b/docs/topics/testing.txt
index 0916f52388..4f37b3bdc0 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::