Remove sample from docstring (#2774)

Azure · Aug 15, 2024 · 6a25cc3 · 6a25cc3
1 parent f365c4b
commit 6a25cc3
Show file tree

Hide file tree

Showing 184 changed files with 10 additions and 37,830 deletions.
diff --git a/.chronus/changes/remove-sample-from-docstring-2024-7-15-15-33-37.md b/.chronus/changes/remove-sample-from-docstring-2024-7-15-15-33-37.md
@@ -0,0 +1,8 @@
+---
+changeKind: feature
+packages:
+  - "@autorest/python"
+  - "@azure-tools/typespec-python"
+---
+
+Remove samples from docstring of operation
diff --git a/...iapi/generated/azure/multiapi/sample/v1/aio/operations/_operation_group_one_operations.py b/...iapi/generated/azure/multiapi/sample/v1/aio/operations/_operation_group_one_operations.py
@@ -25,7 +25,6 @@
 
 from ... import models as _models
 from ...operations._operation_group_one_operations import build_test_two_request
-from .._vendor import MultiapiServiceClientMixinABC
 
 if sys.version_info >= (3, 9):
     from collections.abc import MutableMapping

diff --git a/...multiapi/generated/azure/multiapi/sample/v1/operations/_operation_group_one_operations.py b/...multiapi/generated/azure/multiapi/sample/v1/operations/_operation_group_one_operations.py
@@ -25,7 +25,6 @@
 
 from .. import models as _models
 from ..._serialization import Serializer
-from .._vendor import MultiapiServiceClientMixinABC
 
 if sys.version_info >= (3, 9):
     from collections.abc import MutableMapping

diff --git a/...iapi/generated/azure/multiapi/sample/v2/aio/operations/_operation_group_one_operations.py b/...iapi/generated/azure/multiapi/sample/v2/aio/operations/_operation_group_one_operations.py
@@ -26,7 +26,6 @@
 
 from ... import models as _models
 from ...operations._operation_group_one_operations import build_test_three_request, build_test_two_request
-from .._vendor import MultiapiServiceClientMixinABC
 
 if sys.version_info >= (3, 9):
     from collections.abc import MutableMapping

diff --git a/...iapi/generated/azure/multiapi/sample/v2/aio/operations/_operation_group_two_operations.py b/...iapi/generated/azure/multiapi/sample/v2/aio/operations/_operation_group_two_operations.py
@@ -25,7 +25,6 @@
 
 from ... import models as _models
 from ...operations._operation_group_two_operations import build_test_four_request
-from .._vendor import MultiapiServiceClientMixinABC
 
 if sys.version_info >= (3, 9):
     from collections.abc import MutableMapping

diff --git a/...multiapi/generated/azure/multiapi/sample/v2/operations/_operation_group_one_operations.py b/...multiapi/generated/azure/multiapi/sample/v2/operations/_operation_group_one_operations.py
@@ -26,7 +26,6 @@
 
 from .. import models as _models
 from ..._serialization import Serializer
-from .._vendor import MultiapiServiceClientMixinABC
 
 if sys.version_info >= (3, 9):
     from collections.abc import MutableMapping

diff --git a/...multiapi/generated/azure/multiapi/sample/v2/operations/_operation_group_two_operations.py b/...multiapi/generated/azure/multiapi/sample/v2/operations/_operation_group_two_operations.py
@@ -25,7 +25,6 @@
 
 from .. import models as _models
 from ..._serialization import Serializer
-from .._vendor import MultiapiServiceClientMixinABC
 
 if sys.version_info >= (3, 9):
     from collections.abc import MutableMapping

diff --git a/...iapi/generated/azure/multiapi/sample/v3/aio/operations/_operation_group_one_operations.py b/...iapi/generated/azure/multiapi/sample/v3/aio/operations/_operation_group_one_operations.py
@@ -32,7 +32,6 @@
     build_test_operation_group_paging_request,
     build_test_two_request,
 )
-from .._vendor import MultiapiServiceClientMixinABC
 
 if sys.version_info >= (3, 9):
     from collections.abc import MutableMapping

diff --git a/...iapi/generated/azure/multiapi/sample/v3/aio/operations/_operation_group_two_operations.py b/...iapi/generated/azure/multiapi/sample/v3/aio/operations/_operation_group_two_operations.py
@@ -26,7 +26,6 @@
 
 from ... import models as _models
 from ...operations._operation_group_two_operations import build_test_five_request, build_test_four_request
-from .._vendor import MultiapiServiceClientMixinABC
 
 if sys.version_info >= (3, 9):
     from collections.abc import MutableMapping

diff --git a/...multiapi/generated/azure/multiapi/sample/v3/operations/_operation_group_one_operations.py b/...multiapi/generated/azure/multiapi/sample/v3/operations/_operation_group_one_operations.py
@@ -28,7 +28,6 @@
 
 from .. import models as _models
 from ..._serialization import Serializer
-from .._vendor import MultiapiServiceClientMixinABC
 
 if sys.version_info >= (3, 9):
     from collections.abc import MutableMapping

diff --git a/...multiapi/generated/azure/multiapi/sample/v3/operations/_operation_group_two_operations.py b/...multiapi/generated/azure/multiapi/sample/v3/operations/_operation_group_two_operations.py
@@ -26,7 +26,6 @@
 
 from .. import models as _models
 from ..._serialization import Serializer
-from .._vendor import MultiapiServiceClientMixinABC
 
 if sys.version_info >= (3, 9):
     from collections.abc import MutableMapping

diff --git a/packages/typespec-python/generator/pygen/codegen/serializers/builder_serializer.py b/packages/typespec-python/generator/pygen/codegen/serializers/builder_serializer.py
@@ -535,9 +535,9 @@ def _json_response_template_name(self) -> str:
         return "response"
 
     def example_template(self, builder: OperationType) -> List[str]:
+        if self.code_model.options["models_mode"] in ("msrest", "dpg"):
+            return []
         retval = super().example_template(builder)
-        if self.code_model.options["models_mode"] == "msrest":
-            return retval
         for response in builder.responses:
             polymorphic_subtypes: List[ModelType] = []
             if not response.type:

diff --git a/...nerator-core-access/specs/azure/clientgenerator/core/access/aio/operations/_operations.py b/...nerator-core-access/specs/azure/clientgenerator/core/access/aio/operations/_operations.py
@@ -72,14 +72,6 @@ async def no_decorator_in_public(self, *, name: str, **kwargs: Any) -> _models.N
          MutableMapping
         :rtype: ~specs.azure.clientgenerator.core.access.models.NoDecoratorModelInPublic
         :raises ~azure.core.exceptions.HttpResponseError:
-
-        Example:
-            .. code-block:: python
-
-                # response body for status code(s): 200
-                response == {
-                    "name": "str"
-                }
         """
         error_map: MutableMapping[int, Type[HttpResponseError]] = {
             401: ClientAuthenticationError,
@@ -140,14 +132,6 @@ async def public_decorator_in_public(self, *, name: str, **kwargs: Any) -> _mode
          MutableMapping
         :rtype: ~specs.azure.clientgenerator.core.access.models.PublicDecoratorModelInPublic
         :raises ~azure.core.exceptions.HttpResponseError:
-
-        Example:
-            .. code-block:: python
-
-                # response body for status code(s): 200
-                response == {
-                    "name": "str"
-                }
         """
         error_map: MutableMapping[int, Type[HttpResponseError]] = {
             401: ClientAuthenticationError,
@@ -228,14 +212,6 @@ async def _no_decorator_in_internal(  # pylint: disable=protected-access
          MutableMapping
         :rtype: ~specs.azure.clientgenerator.core.access.models._models.NoDecoratorModelInInternal
         :raises ~azure.core.exceptions.HttpResponseError:
-
-        Example:
-            .. code-block:: python
-
-                # response body for status code(s): 200
-                response == {
-                    "name": "str"
-                }
         """
         error_map: MutableMapping[int, Type[HttpResponseError]] = {
             401: ClientAuthenticationError,
@@ -303,14 +279,6 @@ async def _internal_decorator_in_internal(  # pylint: disable=protected-access
         :rtype:
          ~specs.azure.clientgenerator.core.access.models._models.InternalDecoratorModelInInternal
         :raises ~azure.core.exceptions.HttpResponseError:
-
-        Example:
-            .. code-block:: python
-
-                # response body for status code(s): 200
-                response == {
-                    "name": "str"
-                }
         """
         error_map: MutableMapping[int, Type[HttpResponseError]] = {
             401: ClientAuthenticationError,
@@ -377,14 +345,6 @@ async def _public_decorator_in_internal(
          MutableMapping
         :rtype: ~specs.azure.clientgenerator.core.access.models.PublicDecoratorModelInInternal
         :raises ~azure.core.exceptions.HttpResponseError:
-
-        Example:
-            .. code-block:: python
-
-                # response body for status code(s): 200
-                response == {
-                    "name": "str"
-                }
         """
         error_map: MutableMapping[int, Type[HttpResponseError]] = {
             401: ClientAuthenticationError,
@@ -462,14 +422,6 @@ async def public(self, *, name: str, **kwargs: Any) -> _models.SharedModel:
         :return: SharedModel. The SharedModel is compatible with MutableMapping
         :rtype: ~specs.azure.clientgenerator.core.access.models.SharedModel
         :raises ~azure.core.exceptions.HttpResponseError:
-
-        Example:
-            .. code-block:: python
-
-                # response body for status code(s): 200
-                response == {
-                    "name": "str"
-                }
         """
         error_map: MutableMapping[int, Type[HttpResponseError]] = {
             401: ClientAuthenticationError,
@@ -529,14 +481,6 @@ async def _internal(self, *, name: str, **kwargs: Any) -> _models.SharedModel:
         :return: SharedModel. The SharedModel is compatible with MutableMapping
         :rtype: ~specs.azure.clientgenerator.core.access.models.SharedModel
         :raises ~azure.core.exceptions.HttpResponseError:
-
-        Example:
-            .. code-block:: python
-
-                # response body for status code(s): 200
-                response == {
-                    "name": "str"
-                }
         """
         error_map: MutableMapping[int, Type[HttpResponseError]] = {
             401: ClientAuthenticationError,
@@ -627,17 +571,6 @@ async def _operation(  # pylint: disable=protected-access
         :return: OuterModel. The OuterModel is compatible with MutableMapping
         :rtype: ~specs.azure.clientgenerator.core.access.models._models.OuterModel
         :raises ~azure.core.exceptions.HttpResponseError:
-
-        Example:
-            .. code-block:: python
-
-                # response body for status code(s): 200
-                response == {
-                    "inner": {
-                        "name": "str"
-                    },
-                    "name": "str"
-                }
         """
         error_map: MutableMapping[int, Type[HttpResponseError]] = {
             401: ClientAuthenticationError,
@@ -707,21 +640,6 @@ async def _discriminator(  # pylint: disable=protected-access
         :return: AbstractModel. The AbstractModel is compatible with MutableMapping
         :rtype: ~specs.azure.clientgenerator.core.access.models._models.AbstractModel
         :raises ~azure.core.exceptions.HttpResponseError:
-
-        Example:
-            .. code-block:: python
-
-                # The response is polymorphic. The following are possible polymorphic responses based
-                  off discriminator "kind":
-
-                # JSON input template for discriminator value "real":
-                abstract_model = {
-                    "kind": "real",
-                    "name": "str"
-                }
-
-                # response body for status code(s): 200
-                response == abstract_model
         """
         error_map: MutableMapping[int, Type[HttpResponseError]] = {
             401: ClientAuthenticationError,

diff --git a/...t-generator-core-access/specs/azure/clientgenerator/core/access/operations/_operations.py b/...t-generator-core-access/specs/azure/clientgenerator/core/access/operations/_operations.py
@@ -246,14 +246,6 @@ def no_decorator_in_public(self, *, name: str, **kwargs: Any) -> _models.NoDecor
          MutableMapping
         :rtype: ~specs.azure.clientgenerator.core.access.models.NoDecoratorModelInPublic
         :raises ~azure.core.exceptions.HttpResponseError:
-
-        Example:
-            .. code-block:: python
-
-                # response body for status code(s): 200
-                response == {
-                    "name": "str"
-                }
         """
         error_map: MutableMapping[int, Type[HttpResponseError]] = {
             401: ClientAuthenticationError,
@@ -314,14 +306,6 @@ def public_decorator_in_public(self, *, name: str, **kwargs: Any) -> _models.Pub
          MutableMapping
         :rtype: ~specs.azure.clientgenerator.core.access.models.PublicDecoratorModelInPublic
         :raises ~azure.core.exceptions.HttpResponseError:
-
-        Example:
-            .. code-block:: python
-
-                # response body for status code(s): 200
-                response == {
-                    "name": "str"
-                }
         """
         error_map: MutableMapping[int, Type[HttpResponseError]] = {
             401: ClientAuthenticationError,
@@ -402,14 +386,6 @@ def _no_decorator_in_internal(  # pylint: disable=protected-access
          MutableMapping
         :rtype: ~specs.azure.clientgenerator.core.access.models._models.NoDecoratorModelInInternal
         :raises ~azure.core.exceptions.HttpResponseError:
-
-        Example:
-            .. code-block:: python
-
-                # response body for status code(s): 200
-                response == {
-                    "name": "str"
-                }
         """
         error_map: MutableMapping[int, Type[HttpResponseError]] = {
             401: ClientAuthenticationError,
@@ -477,14 +453,6 @@ def _internal_decorator_in_internal(  # pylint: disable=protected-access
         :rtype:
          ~specs.azure.clientgenerator.core.access.models._models.InternalDecoratorModelInInternal
         :raises ~azure.core.exceptions.HttpResponseError:
-
-        Example:
-            .. code-block:: python
-
-                # response body for status code(s): 200
-                response == {
-                    "name": "str"
-                }
         """
         error_map: MutableMapping[int, Type[HttpResponseError]] = {
             401: ClientAuthenticationError,
@@ -549,14 +517,6 @@ def _public_decorator_in_internal(self, *, name: str, **kwargs: Any) -> _models.
          MutableMapping
         :rtype: ~specs.azure.clientgenerator.core.access.models.PublicDecoratorModelInInternal
         :raises ~azure.core.exceptions.HttpResponseError:
-
-        Example:
-            .. code-block:: python
-
-                # response body for status code(s): 200
-                response == {
-                    "name": "str"
-                }
         """
         error_map: MutableMapping[int, Type[HttpResponseError]] = {
             401: ClientAuthenticationError,
@@ -634,14 +594,6 @@ def public(self, *, name: str, **kwargs: Any) -> _models.SharedModel:
         :return: SharedModel. The SharedModel is compatible with MutableMapping
         :rtype: ~specs.azure.clientgenerator.core.access.models.SharedModel
         :raises ~azure.core.exceptions.HttpResponseError:
-
-        Example:
-            .. code-block:: python
-
-                # response body for status code(s): 200
-                response == {
-                    "name": "str"
-                }
         """
         error_map: MutableMapping[int, Type[HttpResponseError]] = {
             401: ClientAuthenticationError,
@@ -701,14 +653,6 @@ def _internal(self, *, name: str, **kwargs: Any) -> _models.SharedModel:
         :return: SharedModel. The SharedModel is compatible with MutableMapping
         :rtype: ~specs.azure.clientgenerator.core.access.models.SharedModel
         :raises ~azure.core.exceptions.HttpResponseError:
-
-        Example:
-            .. code-block:: python
-
-                # response body for status code(s): 200
-                response == {
-                    "name": "str"
-                }
         """
         error_map: MutableMapping[int, Type[HttpResponseError]] = {
             401: ClientAuthenticationError,
@@ -797,17 +741,6 @@ def _operation(self, *, name: str, **kwargs: Any) -> _models._models.OuterModel:
         :return: OuterModel. The OuterModel is compatible with MutableMapping
         :rtype: ~specs.azure.clientgenerator.core.access.models._models.OuterModel
         :raises ~azure.core.exceptions.HttpResponseError:
-
-        Example:
-            .. code-block:: python
-
-                # response body for status code(s): 200
-                response == {
-                    "inner": {
-                        "name": "str"
-                    },
-                    "name": "str"
-                }
         """
         error_map: MutableMapping[int, Type[HttpResponseError]] = {
             401: ClientAuthenticationError,
@@ -877,21 +810,6 @@ def _discriminator(  # pylint: disable=protected-access
         :return: AbstractModel. The AbstractModel is compatible with MutableMapping
         :rtype: ~specs.azure.clientgenerator.core.access.models._models.AbstractModel
         :raises ~azure.core.exceptions.HttpResponseError:
-
-        Example:
-            .. code-block:: python
-
-                # The response is polymorphic. The following are possible polymorphic responses based
-                  off discriminator "kind":
-
-                # JSON input template for discriminator value "real":
-                abstract_model = {
-                    "kind": "real",
-                    "name": "str"
-                }
-
-                # response body for status code(s): 200
-                response == abstract_model
         """
         error_map: MutableMapping[int, Type[HttpResponseError]] = {
             401: ClientAuthenticationError,