From 8dc4c746cead471986d4b97fddebc60b0421d04b Mon Sep 17 00:00:00 2001
From: Jean-Paul Calderone <exarkun@twistedmatrix.com>
Date: Thu, 2 Apr 2020 08:25:10 -0400
Subject: [PATCH] Pass less to determine_state_for_redeemed_voucher
And API docs
---
src/_zkapauthorizer/model.py | 9 ++++++++-
1 file changed, 8 insertions(+), 1 deletion(-)
diff --git a/src/_zkapauthorizer/model.py b/src/_zkapauthorizer/model.py
index 6a9b29c..b59e3a3 100644
--- a/src/_zkapauthorizer/model.py
+++ b/src/_zkapauthorizer/model.py
@@ -151,7 +151,7 @@ def memory_connect(path, *a, **kw):
return _connect(":memory:", *a, **kw)
-def determine_state_for_redeemed_voucher(existing_vouchers, new_voucher, now):
+def determine_state_for_redeemed_voucher(existing_vouchers, redeemed, now):
"""
Choose a state to store in the database for a voucher which was just
redeemed.
@@ -159,6 +159,13 @@ def determine_state_for_redeemed_voucher(existing_vouchers, new_voucher, now):
This takes into account what is known about previously redeemed vouchers
(if any) and watches for suspicious public key changes in the redemption
process.
+
+ :param list[Voucher] existing_vouchers: Vouchers which have been redeemed
+ in the past.
+
+ :param Redeemed redeemed: The newly redeemed voucher's state.
+
+ :param datetime now: The current time.
"""
return u"redeemed"
--
GitLab