From: Christopher Allan Webber <cwebber@dustycloud.org>
Date: Wed, 4 May 2011 13:11:37 +0000 (-0500)
Subject: A simple, maybe obvious, docstring for util.send_email()
X-Git-Url: https://vcs.fsf.org/?a=commitdiff_plain;h=61ec968b0d1a3681bbc049d651f67100b64e1f6d;p=mediagoblin.git

A simple, maybe obvious, docstring for util.send_email()
---

diff --git a/mediagoblin/util.py b/mediagoblin/util.py
index 5b578a00..d24b59b6 100644
--- a/mediagoblin/util.py
+++ b/mediagoblin/util.py
@@ -142,6 +142,16 @@ def _clear_test_inboxes():
 ### ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
 def send_email(from_addr, to_addrs, subject, message_body):
+    """
+    Simple email sending wrapper, use this so we can capture messages
+    for unit testing purposes.
+
+    Args:
+     - from_addr: address you're sending the email from
+     - to_addrs: list of recipient email addresses
+     - subject: subject of the email
+     - message_body: email body text
+    """
     # TODO: make a mock mhost if testing is enabled
     if TESTS_ENABLED:
         mhost = FakeMhost()