From 7f632419ffc69a226d8a9e7fa3aa7ac5a3a9f93e Mon Sep 17 00:00:00 2001 From: "Miss Islington (bot)" <31488909+miss-islington@users.noreply.github.com> Date: Fri, 19 Jul 2024 10:03:43 +0200 Subject: [3.13] gh-65453: Docs - clarify AttributeError behaviour on PropertyMock (GH-121666) (GH-121968) MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Fixed at EuroPython 24 sprints. (cherry picked from commit 94e6644584d9cb08a4edcd1027e288386184816b) Co-authored-by: Vlastimil Zíma --- Doc/library/unittest.mock.rst | 14 ++++++++++++++ 1 file changed, 14 insertions(+) diff --git a/Doc/library/unittest.mock.rst b/Doc/library/unittest.mock.rst index d8ba24c..2e0e062 100644 --- a/Doc/library/unittest.mock.rst +++ b/Doc/library/unittest.mock.rst @@ -860,6 +860,20 @@ object:: 3 >>> p.assert_called_once_with() +.. caution:: + + If an :exc:`AttributeError` is raised by :class:`PropertyMock`, + it will be interpreted as a missing descriptor and + :meth:`~object.__getattr__` will be called on the parent mock:: + + >>> m = MagicMock() + >>> no_attribute = PropertyMock(side_effect=AttributeError) + >>> type(m).my_property = no_attribute + >>> m.my_property + + + See :meth:`~object.__getattr__` for details. + .. class:: AsyncMock(spec=None, side_effect=None, return_value=DEFAULT, wraps=None, name=None, spec_set=None, unsafe=False, **kwargs) -- cgit v0.12