Allow users to suppress autodoc.mocked_object warnings (#9732)

Co-authored-by: Adam Turner <[email protected]>

Author: CyrilRoelandteNovance

CHANGES.rst

@@ -50,6 +50,8 @@ Features added
   pattern doesn't match any documents, via the new ``toc.glob_not_matching``
   warning sub-type.
   Patch by Slawek Figiel.
+* #9732: Add the new ``autodoc.mock_objects`` warnings sub-type.
+  Patch by Cyril Roelandt.
 
 Bugs fixed
 ----------

doc/usage/configuration.rst

@@ -1404,6 +1404,7 @@ Options for warning control
 
    * ``autodoc``
    * ``autodoc.import_object``
+   * ``autodoc.mocked_object``
    * ``autosectionlabel.<document name>``
    * ``autosummary``
    * ``autosummary.import_cycle``
@@ -1453,6 +1454,11 @@ Options for warning control
    .. versionadded:: 8.2
       Added ``toc.empty_glob``.
 
+   .. versionadded:: 8.2
+
+      Added ``autodoc.mocked_object``
+
+
 Builder options
 ===============
 

sphinx/ext/autodoc/__init__.py

@@ -1032,7 +1032,10 @@ def generate(
         )
         if ismock(self.object) and not docstrings:
             logger.warning(
-                __('A mocked object is detected: %r'), self.name, type='autodoc'
+                __('A mocked object is detected: %r'),
+                self.name,
+                type='autodoc',
+                subtype='mocked_object',
             )
 
         # check __module__ of object (for members not given explicitly)