From f4ccdd967eb818c3c7f1ced6f4be24f25515e39f Mon Sep 17 00:00:00 2001
From: Jean-Paul Calderone <exarkun@twistedmatrix.com>
Date: Tue, 20 Aug 2019 14:05:43 -0400
Subject: [PATCH] Fix/finish this docstring
---
src/_zkapauthorizer/controller.py | 7 ++++---
1 file changed, 4 insertions(+), 3 deletions(-)
diff --git a/src/_zkapauthorizer/controller.py b/src/_zkapauthorizer/controller.py
index a96e003..c0d5536 100644
--- a/src/_zkapauthorizer/controller.py
+++ b/src/_zkapauthorizer/controller.py
@@ -150,10 +150,11 @@ class PaymentController(object):
2. The controller tells the data store to remember the voucher.
The data store provides durability for the voucher which represents an investment (ie, a purchase) on the part of the client.
- 3. The controller tells the store to hand all currently idle vouchers to a redeemer.
- In normal operation, only the newly added voucher will be idle.
-
+ 3. The controller hands the voucher and some random tokens to a redeemer.
+ In the future, this step will need to be retried in the case of failures.
+ 4. When the voucher has been redeemed for passes, the controller hands them to the data store with the voucher.
+ The data store marks the voucher as redeemed and stores the passes for use by the storage client.
"""
store = attr.ib()
redeemer = attr.ib()
--
GitLab