Fix Sphinx error in core (#32417)

* Fix Sphinx error in core

* Mode Sphinx update

* Fix all Sphinx issues

Author: lmazuel

sdk/core/azure-core/azure/core/exceptions.py

@@ -172,25 +172,29 @@ class ODataV4Format:
 
     Example of JSON:
 
-    error: {
-        "code": "ValidationError",
-        "message": "One or more fields contain incorrect values: ",
-        "details": [
-            {
-                "code": "ValidationError",
-                "target": "representation",
-                "message": "Parsing error(s): String '' does not match regex pattern '^[^{}/ :]+(?: :\\\\d+)?$'.
-                Path 'host', line 1, position 297."
-            },
-            {
+    .. code-block:: json
+
+        {
+            "error": {
                 "code": "ValidationError",
-                "target": "representation",
-                "message": "Parsing error(s): The input OpenAPI file is not valid for the OpenAPI specificate
-                https: //github.com/OAI/OpenAPI-Specification/blob/master/versions/2.0.md
-                (schema https://github.com/OAI/OpenAPI-Specification/blob/master/schemas/v2.0/schema.json)."
+                "message": "One or more fields contain incorrect values: ",
+                "details": [
+                    {
+                        "code": "ValidationError",
+                        "target": "representation",
+                        "message": "Parsing error(s): String '' does not match regex pattern '^[^{}/ :]+(?: :\\\\d+)?$'.
+                        Path 'host', line 1, position 297."
+                    },
+                    {
+                        "code": "ValidationError",
+                        "target": "representation",
+                        "message": "Parsing error(s): The input OpenAPI file is not valid for the OpenAPI specificate
+                        https: //github.com/OAI/OpenAPI-Specification/blob/master/versions/2.0.md
+                        (schema https://github.com/OAI/OpenAPI-Specification/blob/master/schemas/v2.0/schema.json)."
+                    }
+                ]
             }
-        ]
-    }
+        }
 
     :param dict json_object: A Python dict representing a ODataV4 JSON
     :ivar str ~.code: Its value is a service-defined error code.

sdk/core/azure-core/azure/core/messaging.py

@@ -216,8 +216,8 @@ def from_dict(cls, event: Dict[str, Any]) -> CloudEvent[DataType]:
 
     @classmethod
     def from_json(cls, event: Any) -> CloudEvent[DataType]:
-        """
-        Returns the deserialized CloudEvent object when a json payload is provided.
+        """Returns the deserialized CloudEvent object when a json payload is provided.
+
         :param event: The json string that should be converted into a CloudEvent. This can also be
          a storage QueueMessage, eventhub's EventData or ServiceBusMessage
         :type event: object

sdk/core/azure-core/azure/core/pipeline/policies/_base.py

@@ -110,14 +110,6 @@ def on_exception(
 
         :param request: The Pipeline request object
         :type request: ~azure.core.pipeline.PipelineRequest
-
-        .. admonition:: Example:
-
-            .. literalinclude:: ../samples/test_example_sansio.py
-                :start-after: [START on_exception]
-                :end-before: [END on_exception]
-                :language: python
-                :dedent: 4
         """
         return
 

sdk/core/azure-core/azure/core/tracing/_abstract_span.py

@@ -144,7 +144,7 @@ def set_http_attributes(self, request: HttpRequestType, response: Optional[HttpR
         Add correct attributes for a http client span.
 
         :param request: The request made
-        :type request: HttpRequest
+        :type request: azure.core.rest.HttpRequest
         :param response: The response received by the server. Is None if no response received.
         :type response: ~azure.core.pipeline.transport.HttpResponse or ~azure.core.pipeline.transport.AsyncHttpResponse
         """
@@ -268,7 +268,7 @@ def set_http_attributes(
         Add correct attributes for a http client span.
 
         :param request: The request made
-        :type request: HttpRequest
+        :type request: azure.core.rest.HttpRequest
         :param response: The response received from the server. Is None if no response received.
         :type response: ~azure.core.pipeline.transport.HttpResponse or ~azure.core.pipeline.transport.AsyncHttpResponse
         """

sdk/core/azure-core/doc/azure.core.rst

@@ -35,7 +35,7 @@ azure.core.credentials
    :inherited-members:
 
 azure.core.credentials_async
----------------------
+----------------------------
 
 .. automodule:: azure.core.credentials_async
    :members:
@@ -50,7 +50,7 @@ azure.core.exceptions
    :undoc-members:
 
 azure.core.messaging
--------------------
+--------------------
 
 .. automodule:: azure.core.messaging
    :members:
@@ -74,23 +74,23 @@ azure.core.settings
    :inherited-members:
 
 azure.core.serialization
--------------------
+------------------------
 
 .. automodule:: azure.core.serialization
    :members:
    :undoc-members:
    :inherited-members:
 
 azure.core.rest
--------------------
+---------------
 
 .. automodule:: azure.core.rest
    :members:
    :undoc-members:
    :inherited-members:
 
 azure.core.utils
--------------------
+----------------
 
 .. automodule:: azure.core.utils
    :members:

sdk/core/azure-core/doc/azure.rst

@@ -3,6 +3,7 @@ mypy = true
 type_check_samples = true
 verifytypes = true
 pyright = false
+strict_sphinx = true
 # For test environments or static checks where a check should be run by default, not explicitly disabling will enable the check.
 # pylint is enabled by default, so there is no reason for a pylint = true in every pyproject.toml.
 #