bpo-37383: Updates docs to reflect AsyncMock call_count after await. (GH-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().
(cherry picked from commit b9f65f01fd761da7799f36d29b54518399d3458e)
Co-authored-by: Lisa Roach <lisaroach14@gmail.com>
diff --git a/Doc/library/unittest.mock.rst b/Doc/library/unittest.mock.rst
index 304ba53..b254754 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