Commit 5cd7af58 authored by Malcolm Tredinnick's avatar Malcolm Tredinnick
Browse files

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
parent 7e4d2778

docs/topics/testing.txt

+6 −1
Original line number Diff line number Diff line
@@ -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::