document and reorganize method order in DigestModTestCaseMixin

python · picnixz · Mar 3, 2025 · Feb 13, 2025 · Feb 13, 2025 · Feb 13, 2025
commit ca7851c1228fac9a8e859b97a18be544682fae55
@@ -589,11 +589,14 @@ def func(self, *, __name=name):  # __name needed to bind 'name'
 
 
 class DigestModTestCaseMixin(CreatorMixin, DigestMixin):
+    """Tests for the 'digestmod' parameter."""
 
     def assert_raises_missing_digestmod(self):
+        """A context manager catching errors when a digestmod is missing."""
         return self.assertRaisesRegex(TypeError, "Missing required.*digestmod")
 
     def assert_raises_unknown_digestmod(self):
+        """A context manager catching errors when a digestmod is unknown."""
         return self.assertRaisesRegex(ValueError, "[Uu]nsupported.*")
 
     def test_constructor_missing_digestmod(self):
@@ -614,6 +617,12 @@ def do_test_constructor_unknown_digestmod(self, catcher):
             with self.subTest(args=args, kwds=kwds), catcher():
                 func(*args, **kwds)
 
+    def cases_missing_digestmod_in_constructor(self):
+        raise NotImplementedError
+
+    def cases_unknown_digestmod_in_constructor(self):
+        raise NotImplementedError
+
     def make_invalid_digestmod_cases(self, func, invalid_values):
         """Generate cases for either missing or unknown digestmod tests."""
         key = b'unused key'
@@ -627,12 +636,6 @@ def make_invalid_digestmod_cases(self, func, invalid_values):
             cases.append((func, (key,), kwargs | {'msg': msg}))
         return cases
 
-    def cases_missing_digestmod_in_constructor(self):
-        raise NotImplementedError
-
-    def cases_unknown_digestmod_in_constructor(self):
-        raise NotImplementedError
-
 
 class ConstructorTestCaseMixin(CreatorMixin, DigestMixin, CheckerMixin):
     """HMAC constructor tests based on HMAC-SHA-2/256."""