bpo-37383: Updates docs to reflect AsyncMock call_count after await. (#15761)
* bpo-351428: Updates documentation to reflect AsyncMock call_count after await.
* Adds skip and fixes warning.
* Removes extra >>>.
* Adds ... in front of await mock().
diff --git a/Doc/library/unittest.mock.rst b/Doc/library/unittest.mock.rst
index 9bb3427..04ff8a6 100644
--- a/Doc/library/unittest.mock.rst
+++ b/Doc/library/unittest.mock.rst
@@ -514,6 +514,20 @@
>>> mock.call_count
2
+ For :class:`AsyncMock` the :attr:`call_count` is only iterated if the function
+ has been awaited:
+
+ >>> mock = AsyncMock()
+ >>> mock() # doctest: +SKIP
+ <coroutine object AsyncMockMixin._mock_call at ...>
+ >>> mock.call_count
+ 0
+ >>> async def main():
+ ... await mock()
+ ...
+ >>> asyncio.run(main())
+ >>> mock.call_count
+ 1
.. attribute:: return_value