From: Miss Islington (bot) <31488909+miss-islington@users.noreply.github.com>
Date: Thu, 29 Aug 2019 06:39:47 +0000 (-0700)
Subject: bpo-35946: Improve assert_called_with documentation (GH-11796)
X-Git-Tag: v3.8.0b4~12
X-Git-Url: https://granicus.if.org/sourcecode?a=commitdiff_plain;h=612d3935ec0b2fbe88b3fae8167f0c503c61a9ca;p=python

bpo-35946: Improve assert_called_with documentation (GH-11796)

(cherry picked from commit f5896a05edf5df91fb1b55bd481ba5b2a3682f4e)

Co-authored-by: Rémi Lapeyre <remi.lapeyre@henki.fr>
---

diff --git a/Doc/library/unittest.mock.rst b/Doc/library/unittest.mock.rst
index 19e9715102..304ba53227 100644
--- a/Doc/library/unittest.mock.rst
+++ b/Doc/library/unittest.mock.rst
@@ -317,8 +317,8 @@ the *new_callable* argument to :func:`patch`.
 
     .. method:: assert_called_with(*args, **kwargs)
 
-        This method is a convenient way of asserting that calls are made in a
-        particular way:
+        This method is a convenient way of asserting that the last call has been
+        made in a particular way:
 
             >>> mock = Mock()
             >>> mock.method(1, 2, 3, test='wow')
diff --git a/Lib/unittest/mock.py b/Lib/unittest/mock.py
index b3dc640f8f..3faeb4c9af 100644
--- a/Lib/unittest/mock.py
+++ b/Lib/unittest/mock.py
@@ -854,7 +854,7 @@ class NonCallableMock(Base):
             raise AssertionError(msg)
 
     def assert_called_with(self, /, *args, **kwargs):
-        """assert that the mock was called with the specified arguments.
+        """assert that the last call was made with the specified arguments.
 
         Raises an AssertionError if the args and keyword args passed in are
         different to the last call to the mock."""