summaryrefslogtreecommitdiff
path: root/src/mailman/docs/autorespond.txt
diff options
context:
space:
mode:
Diffstat (limited to 'src/mailman/docs/autorespond.txt')
-rw-r--r--src/mailman/docs/autorespond.txt37
1 files changed, 37 insertions, 0 deletions
diff --git a/src/mailman/docs/autorespond.txt b/src/mailman/docs/autorespond.txt
index d2e4797f7..7aac90b1c 100644
--- a/src/mailman/docs/autorespond.txt
+++ b/src/mailman/docs/autorespond.txt
@@ -70,3 +70,40 @@ Now the day flips over and all the counts reset.
0
>>> response_set.todays_count(address, Response.command)
0
+
+
+Response dates
+--------------
+
+You can also use the response set to get the date of the last response sent.
+
+ >>> response = response_set.last_response(address, Response.hold)
+ >>> response.mailing_list
+ <mailing list "test@example.com" at ...>
+ >>> response.address
+ <Address: aperson@example.com [not verified] at ...>
+ >>> response.response_type
+ <EnumValue: Response.hold [int=1]>
+ >>> response.date_sent
+ datetime.date(2005, 8, 1)
+
+When another response is sent today, that becomes the last one sent.
+
+ >>> response_set.response_sent(address, Response.command)
+ >>> response_set.last_response(address, Response.command).date_sent
+ datetime.date(2005, 8, 2)
+
+ >>> factory.fast_forward(days=3)
+ >>> response_set.response_sent(address, Response.command)
+ >>> response_set.last_response(address, Response.command).date_sent
+ datetime.date(2005, 8, 5)
+
+If there's been no response sent to a particular address, None is returned.
+
+ >>> address = config.db.user_manager.create_address(
+ ... u'bperson@example.com')
+
+ >>> response_set.todays_count(address, Response.command)
+ 0
+ >>> print response_set.last_response(address, Response.command)
+ None