Merge pull request #9507 from tk0miya/9479_autodoc_mocked_target

Fix #9479: autodoc: Emit a warning if target is a mocked object

Author: tk0miya

CHANGES

@@ -14,6 +14,7 @@ Features added
 --------------
 
 * #9445: autodoc: Support class properties
+* #9479: autodoc: Emit a warning if target is a mocked object
 * #9445: py domain: ``:py:property:`` directive supports ``:classmethod:``
   option to describe the class property
 

sphinx/ext/autodoc/__init__.py

@@ -913,6 +913,10 @@ def generate(self, more_content: Optional[StringList] = None, real_modname: str
         if not self.import_object():
             return
 
+        if ismock(self.object):
+            logger.warning(__('A mocked object is detected: %r'),
+                           self.name, type='autodoc')
+
         # If there is no real module defined, figure out which to use.
         # The real module is used in the module analyzer to look up the module
         # where the attribute documentation would actually be found in.