async is async_mode in python3.7 and newer

Author: davidvilla

CHANGES.rst

@@ -1,3 +1,10 @@
+20190405
+========
+
+- Release 1.9.2
+- async() matcher is available as async_mode() for python3.7 and newer
+
+
 20141126
 ========
 

debian/changelog

@@ -1,3 +1,9 @@
+doublex (1.9.2-1) unstable; urgency=low
+
+  * New release
+
+ -- David Villa Alises <[email protected]>  Fri, 05 Apr 2019 11:24:14 +0200
+
 doublex (1.9.1-2) unstable; urgency=low
 
   * New release

docs/api.rst

@@ -86,7 +86,7 @@ for Spy methods
 
    See :ref:`called`.
 
-.. py:method:: called.async(timeout)
+.. py:method:: called.async_mode(timeout)
 
    The ``called`` assertion waits the corresponding invocation a maximum of `timeout`
    seconds.
@@ -95,9 +95,9 @@ for Spy methods
 
    ::
 
-       assert_that(spy.method, called().async(1))
+       assert_that(spy.method, called().async_mode(1))
 
-   See :ref:`async`.
+   See :ref:`async_mode`.
 
 
 .. py:method:: called.times(value)

docs/async-spies.rst

@@ -1,4 +1,4 @@
-.. _async:
+.. async_mode:
 
 Asynchronous spies
 ==================
@@ -86,7 +86,7 @@ barrier. If the ``write()`` invocation never happens, the ``barrier.wait()`` con
 after 1 second but the test fails, as must do. When all is right, the barrier waits just
 the required time.
 
-Well, this mechanism is a doublex builtin (the ``async`` matcher) since release 1.5.1
+Well, this mechanism is a doublex builtin (the ``async_mode`` matcher) since release 1.5.1
 providing the same behavior in a clearer way. The next is functionally equivalent to the
 listing just above:
 
@@ -104,7 +104,7 @@ listing just above:
            sut.some_method()
 
            # then
-           assert_that(spy.write, called().async(timeout=1))
+           assert_that(spy.write, called().async_mode(timeout=1))
 
 
 .. Local Variables:

docs/async-spies.rst.test

@@ -1,4 +1,4 @@
-.. _async:
+.. async_mode:
 
 Asynchronous spies
 ==================
@@ -86,7 +86,7 @@ barrier. If the ``write()`` invocation never happens, the ``barrier.wait()`` con
 after 1 second but the test fails, as must do. When all is right, the barrier waits just
 the required time.
 
-Well, this mechanism is a doublex builtin (the ``async`` matcher) since release 1.5.1
+Well, this mechanism is a doublex builtin (the ``async_mode`` matcher) since release 1.5.1
 providing the same behavior in a clearer way. The next is functionally equivalent to the
 listing just above:
 
@@ -104,7 +104,7 @@ listing just above:
            sut.some_method()
 
            # then
-           assert_that(spy.write, called().async(timeout=1))
+           assert_that(spy.write, called().async_mode(timeout=1))
 
 
 .. Local Variables:

doublex/internal.py

@@ -201,14 +201,12 @@ def delegates(self, delegate):
     def returns(self, value):
         self.context.retval = value
         self.delegates(func_returning(value))
-        return self
 
     def returns_input(self):
         if not self.context.args:
             raise TypeError("%s has no input args" % self)
 
         self.delegates(func_returning_input(self))
-        return self
 
     def raises(self, e):
         self.delegates(func_raising(e))

doublex/matchers.py

@@ -98,7 +98,7 @@ def _matches(self, method):
 
         if self._async_timeout:
             if self._times != any_time:
-                raise WrongApiUsage("'times' and 'async' are exclusive")
+                raise WrongApiUsage("'times' and 'async_mode' are exclusive")
             self.method._event.wait(self._async_timeout)
 
         return method._was_called(self.context, self._times)
@@ -127,7 +127,7 @@ def with_some_args(self, **kargs):
         self.context.check_some_args = True
         return self
 
-    def _async(self, timeout):
+    def async_mode(self, timeout):
         self._async_timeout = timeout
         return self
 
@@ -136,8 +136,9 @@ def times(self, n):
         return self
 
 
+#  backward compatibility
 if sys.version_info < (3, 7):
-    setattr(MethodCalled, 'async', MethodCalled._async)
+    setattr(MethodCalled, 'async', MethodCalled.async_mode)
 
 
 def called():

doublex/test/async_race_condition_test.py

@@ -41,4 +41,4 @@ def test_wrong_try_to_test_an_async_invocation(self):
         sut.some_method()
 
         # then
-        assert_that(spy.write, called()._async(1))
+        assert_that(spy.write, called().async_mode(1))

doublex/test/unit_tests.py

@@ -1345,7 +1345,7 @@ def test_spy_call_with_async_feature(self):
         sut.send_data()
 
         # then
-        assert_that(spy.write, called()._async(timeout=1))
+        assert_that(spy.write, called().async_mode(timeout=1))
 
     def test_spy_async_support_1_call_only(self):
         # given
@@ -1358,7 +1358,7 @@ def test_spy_async_support_1_call_only(self):
 
         # then
         with self.assertRaises(WrongApiUsage):
-            assert_that(spy.write, called()._async(timeout=1).with_args(3).times(2))
+            assert_that(spy.write, called().async_mode(timeout=1).with_args(3).times(2))
 
     def test_spy_async_stubbed(self):
         # given
@@ -1371,7 +1371,7 @@ def test_spy_async_stubbed(self):
         sut.send_data(3)
 
         # then
-        assert_that(spy.write, called()._async(timeout=1))
+        assert_that(spy.write, called().async_mode(timeout=1))
 
 
 # new on 1.7

version.py

@@ -1 +1 @@
-__version__ = '1.9.1'
+__version__ = '1.9.2'