Document test_utils.make_mocked_coro function (#1113)

Author: f0t0n

aiohttp/test_utils.py

@@ -381,16 +381,7 @@ def make_mocked_request(method, path, headers=None, *,
 
 
 def make_mocked_coro(return_value):
-    """A coroutine mock.
-
-    Behavees like a coroutine which returns return_value.
-
-    But it is also a mock object, you might test it as usual Mock:
-
-    mocked = mocke_mocked_coro(1)
-    assert 1 == await mocked(1, 2)
-    mocked.assert_called_with(1, 2)
-    """
+    """Creates a coroutine mock."""
     @asyncio.coroutine
     def mock_coro(*args, **kwargs):
         return return_value

docs/testing.rst

@@ -447,6 +447,23 @@ aiohttp.test_utils
    :undoc-members:
    :show-inheritance:
 
+.. function:: make_mocked_coro(return_value)
+
+  Creates a coroutine mock.
+
+  Behaves like a coroutine which returns `return_value`.
+  But it is also a mock object, you might test it as usual Mock::
+
+      mocked = make_mocked_coro(1)
+      assert 1 == await mocked(1, 2)
+      mocked.assert_called_with(1, 2)
+
+
+  :param return_value: A value that the the mock object will return when
+      called.
+  :returns: A mock object that behaves as a coroutine which returns
+      `return_value` when called.
+
 
 .. _pytest: http://pytest.org/latest/
 .. _pytest-aiohttp: https://pypi.python.org/pypi/pytest-aiohttp