From 7ee0152fd9232a66d42ef1537229f4f23ebaf9b2 Mon Sep 17 00:00:00 2001
From: Jean-Paul Calderone <exarkun@twistedmatrix.com>
Date: Thu, 28 May 2020 10:26:03 -0400
Subject: [PATCH] docstring

---
 src/_zkapauthorizer/tests/test_storage_client.py | 13 +++++++++++++
 1 file changed, 13 insertions(+)

diff --git a/src/_zkapauthorizer/tests/test_storage_client.py b/src/_zkapauthorizer/tests/test_storage_client.py
index 61274b2..611bc61 100644
--- a/src/_zkapauthorizer/tests/test_storage_client.py
+++ b/src/_zkapauthorizer/tests/test_storage_client.py
@@ -387,6 +387,19 @@ class PassFactoryTests(TestCase):
         )
 
     def _test_disallowed_transition(self, num_passes, setup_op, invalid_op):
+        """
+        Assert that after some setup operation completes, another operation raises
+        ``ValueError``.
+
+        :param int num_passes: The number of passes to make available from the
+            factory.
+
+        :param (IPassGroup -> None) setup_op: Some initial operation to
+            perform with the pass group.
+
+        :param (IPassGroup -> None) invalid_op: Some follow-up operation to
+            perform with the pass group and to assert raises an exception.
+        """
         message = u"message"
         factory = pass_factory(integer_passes(num_passes))
         group = factory.get(message, num_passes)
-- 
GitLab