Author: russellm
Date: 2009-01-29 06:31:11 -0600 (Thu, 29 Jan 2009)
New Revision: 9793
Modified:
django/trunk/docs/topics/email.txt
Log:
Fixed #8638 -- Added documentation on how to redirect email to a dummy server
for testing purposes. Thanks to Rob Hudson and Marc Fargas for their work on
the draft for this change.
Modified: django/trunk/docs/topics/email.txt
===================================================================
--- django/trunk/docs/topics/email.txt 2009-01-29 10:46:36 UTC (rev 9792)
+++ django/trunk/docs/topics/email.txt 2009-01-29 12:31:11 UTC (rev 9793)
@@ -350,3 +350,29 @@
connection = SMTPConnection() # Use default settings for connection
messages = get_notification_email()
connection.send_messages(messages)
+
+Testing e-mail sending
+----------------------
+
+The are times when you do not want Django to send e-mails at all. For example,
+while developing a website, you probably don't want to send out thousands of
+e-mails -- but you may want to validate that e-mails will be sent to the right
+people under the right conditions, and that those e-mails will contain the
+correct content.
+
+The easiest way to test your project's use of e-mail is to use a "dumb" e-mail
+server that receives the e-mails locally and displays them to the terminal,
+but does not actually send anything. Python has a built-in way to accomplish
+this with a single command::
+
+ python -m smtpd -n -c DebuggingServer localhost:1025
+
+This command will start a simple SMTP server listening on port 1025 of
+localhost. This server simply prints to standard output all email headers and
+the email body. You then only need to set the :setting:`EMAIL_HOST` and
+:setting:`EMAIL_PORT` accordingly, and you are set.
+
+For more entailed testing and processing of e-mails locally, see the Python
+documentation on the `SMTP Server`_.
+
+.. _SMTP Server: http://docs.python.org/library/smtpd.html
--~--~---------~--~----~------------~-------~--~----~
You received this message because you are subscribed to the Google Groups
"Django updates" group.
To post to this group, send email to [email protected]
To unsubscribe from this group, send email to
[email protected]
For more options, visit this group at
http://groups.google.com/group/django-updates?hl=en
-~----------~----~----~----~------~----~------~--~---
