Inorder implementation

.flake8

@@ -11,4 +11,4 @@ ignore =
   E731
 exclude = .git,.github,.cache,.mypy_cache,.pytest_cache,docs,.venv,.build,build
 max-complexity = 10
-max-line-length = 79
+max-line-length = 89

CHANGES.txt

@@ -12,6 +12,25 @@ Release 2.0.0
   check can be disabled with the environment variable `MOCKITO_CONTEXT_MANAGERS_CHECK_USAGE="0"`.
 - The `between` matcher now supports open ranges, e.g. `between=(0,)` to assert that at least
   0 interactions occurred.
+- Added a first-class `InOrder` API via ``mockito.InOrder`` (also available as
+  ``mockito.inorder.InOrder``). The legacy in-order mode only supported one mock at a time;
+  the new API supports true cross-mock order verification.
+
+  Migration (old limited style -> new style)::
+
+      # Before (legacy, single-mock order only)
+      from mockito import inorder
+      inorder.verify(cat).meow()
+      inorder.verify(cat).purr()
+
+      # Now (preferred, explicit cross-mock order)
+      from mockito import InOrder
+      in_order = InOrder(cat, dog)
+      in_order.verify(cat).meow()
+      in_order.verify(dog).bark()
+
+- The legacy in-order verification mode (``inorder.verify(...)``)
+  is deprecated in favor of ``InOrder(...)``.
 
 
 

docs/the-functions.rst

@@ -22,6 +22,12 @@ This looks like a plethora of verification functions, and especially since  you
 .. autofunction:: verifyZeroInteractions
 .. autofunction:: verifyExpectedInteractions
 
+In-order verification across one or multiple observed objects is provided by
+:class:`InOrder`.
+
+.. autoclass:: InOrder
+   :class-doc-from: class
+
 Note that `verifyExpectedInteractions` was named `verifyNoUnwantedInteractions` in v1.
 The usage of `verifyNoUnwantedInteractions` is deprecated.
 

mockito/__init__.py

@@ -38,6 +38,7 @@
     ArgumentError,
 )
 from . import inorder
+from .inorder import InOrder
 from .spying import spy, spy2
 from .mocking import mock
 from .verification import VerificationError
@@ -67,6 +68,7 @@
     'verifyExpectedInteractions',
     'verifyStubbedInvocationsAreUsed',
     'inorder',
+    'InOrder',
     'unstub',
     'forget_invocations',
     'VerificationError',