CodeGen from PR 14501 in Azure/azure-rest-api-specs

Update READMEs. (Azure#14501)

* Readme Updates

* Code review feedback.

sdk/cognitiveservices/azure-cognitiveservices-personalizer/MANIFEST.in

@@ -1,3 +1,4 @@
+include _meta.json
 recursive-include tests *.py *.yaml
 include *.md
 include azure/__init__.py

sdk/cognitiveservices/azure-cognitiveservices-personalizer/_meta.json

@@ -0,0 +1,8 @@
+{
+  "autorest": "V2",
+  "use": "@microsoft.azure/autorest.python@~4.0.71",
+  "commit": "f97d1d9ec357dabb3ed5e7b974e3744f58c01564",
+  "repository_url": "https://github.com/Azure/azure-rest-api-specs",
+  "autorest_command": "autorest specification/cognitiveservices/data-plane/Personalizer/readme.md --keep-version-file --multiapi --no-async --python --python-mode=update --python-sdks-folder=/home/vsts/work/1/s/azure-sdk-for-python/sdk [email protected]/autorest.python@~4.0.71 --version=V2",
+  "readme": "specification/cognitiveservices/data-plane/Personalizer/readme.md"
+}

sdk/cognitiveservices/azure-cognitiveservices-personalizer/azure/cognitiveservices/personalizer/__init__.py

@@ -9,10 +9,11 @@
 # regenerated.
 # --------------------------------------------------------------------------
 
-from .personalizer_client import PersonalizerClient
-from .version import VERSION
+from ._configuration import PersonalizerClientv11Preview1Configuration
+from ._personalizer_clientv11_preview1 import PersonalizerClientv11Preview1
+__all__ = ['PersonalizerClientv11Preview1', 'PersonalizerClientv11Preview1Configuration']
 
-__all__ = ['PersonalizerClient']
+from .version import VERSION
 
 __version__ = VERSION
 

sdk/cognitiveservices/azure-cognitiveservices-personalizer/azure/cognitiveservices/personalizer/_configuration.py

@@ -0,0 +1,46 @@
+# coding=utf-8
+# --------------------------------------------------------------------------
+# Copyright (c) Microsoft Corporation. All rights reserved.
+# Licensed under the MIT License. See License.txt in the project root for
+# license information.
+#
+# Code generated by Microsoft (R) AutoRest Code Generator.
+# Changes may cause incorrect behavior and will be lost if the code is
+# regenerated.
+# --------------------------------------------------------------------------
+
+from msrest import Configuration
+
+from .version import VERSION
+
+
+class PersonalizerClientv11Preview1Configuration(Configuration):
+    """Configuration for PersonalizerClientv11Preview1
+    Note that all parameters used to create this instance are saved as instance
+    attributes.
+
+    :param endpoint: Supported Cognitive Services endpoint.
+    :type endpoint: str
+    :param credentials: Subscription credentials which uniquely identify
+     client subscription.
+    :type credentials: None
+    """
+
+    def __init__(
+            self, endpoint, credentials):
+
+        if endpoint is None:
+            raise ValueError("Parameter 'endpoint' must not be None.")
+        if credentials is None:
+            raise ValueError("Parameter 'credentials' must not be None.")
+        base_url = '{Endpoint}/personalizer/v1.1-preview.1'
+
+        super(PersonalizerClientv11Preview1Configuration, self).__init__(base_url)
+
+        # Starting Autorest.Python 4.0.64, make connection pool activated by default
+        self.keep_alive = True
+
+        self.add_user_agent('azure-cognitiveservices-personalizer/{}'.format(VERSION))
+
+        self.endpoint = endpoint
+        self.credentials = credentials

sdk/cognitiveservices/azure-cognitiveservices-personalizer/azure/cognitiveservices/personalizer/_personalizer_clientv11_preview1.py

@@ -0,0 +1,90 @@
+# coding=utf-8
+# --------------------------------------------------------------------------
+# Copyright (c) Microsoft Corporation. All rights reserved.
+# Licensed under the MIT License. See License.txt in the project root for
+# license information.
+#
+# Code generated by Microsoft (R) AutoRest Code Generator.
+# Changes may cause incorrect behavior and will be lost if the code is
+# regenerated.
+# --------------------------------------------------------------------------
+
+from msrest.service_client import SDKClient
+from msrest import Serializer, Deserializer
+
+from ._configuration import PersonalizerClientv11Preview1Configuration
+from .operations import PersonalizerClientv11Preview1OperationsMixin
+from msrest.exceptions import HttpOperationError
+from .operations import ServiceConfigurationOperations
+from .operations import PolicyOperations
+from .operations import EvaluationOperations
+from .operations import EvaluationsOperations
+from .operations import EventsOperations
+from .operations import LogOperations
+from .operations import ModelOperations
+from .operations import MultiSlotEventsOperations
+from .operations import MultiSlotOperations
+from . import models
+
+
+class PersonalizerClientv11Preview1(PersonalizerClientv11Preview1OperationsMixin, SDKClient):
+    """Personalizer Service is an Azure Cognitive Service that makes it easy to target content and experiences without complex pre-analysis or cleanup of past data. Given a context and featurized content, the Personalizer Service returns which content item to show to users in rewardActionId. As rewards are sent in response to the use of rewardActionId, the reinforcement learning algorithm will improve the model and improve performance of future rank calls.
+
+    :ivar config: Configuration for client.
+    :vartype config: PersonalizerClientv11Preview1Configuration
+
+    :ivar service_configuration: ServiceConfiguration operations
+    :vartype service_configuration: azure.cognitiveservices.personalizer.operations.ServiceConfigurationOperations
+    :ivar policy: Policy operations
+    :vartype policy: azure.cognitiveservices.personalizer.operations.PolicyOperations
+    :ivar evaluation: Evaluation operations
+    :vartype evaluation: azure.cognitiveservices.personalizer.operations.EvaluationOperations
+    :ivar evaluations: Evaluations operations
+    :vartype evaluations: azure.cognitiveservices.personalizer.operations.EvaluationsOperations
+    :ivar events: Events operations
+    :vartype events: azure.cognitiveservices.personalizer.operations.EventsOperations
+    :ivar log: Log operations
+    :vartype log: azure.cognitiveservices.personalizer.operations.LogOperations
+    :ivar model: Model operations
+    :vartype model: azure.cognitiveservices.personalizer.operations.ModelOperations
+    :ivar multi_slot_events: MultiSlotEvents operations
+    :vartype multi_slot_events: azure.cognitiveservices.personalizer.operations.MultiSlotEventsOperations
+    :ivar multi_slot: MultiSlot operations
+    :vartype multi_slot: azure.cognitiveservices.personalizer.operations.MultiSlotOperations
+
+    :param endpoint: Supported Cognitive Services endpoint.
+    :type endpoint: str
+    :param credentials: Subscription credentials which uniquely identify
+     client subscription.
+    :type credentials: None
+    """
+
+    def __init__(
+            self, endpoint, credentials):
+
+        self.config = PersonalizerClientv11Preview1Configuration(endpoint, credentials)
+        super(PersonalizerClientv11Preview1, self).__init__(self.config.credentials, self.config)
+
+        client_models = {k: v for k, v in models.__dict__.items() if isinstance(v, type)}
+        self.api_version = 'v1.1-preview.1'
+        self._serialize = Serializer(client_models)
+        self._deserialize = Deserializer(client_models)
+
+        self.service_configuration = ServiceConfigurationOperations(
+            self._client, self.config, self._serialize, self._deserialize)
+        self.policy = PolicyOperations(
+            self._client, self.config, self._serialize, self._deserialize)
+        self.evaluation = EvaluationOperations(
+            self._client, self.config, self._serialize, self._deserialize)
+        self.evaluations = EvaluationsOperations(
+            self._client, self.config, self._serialize, self._deserialize)
+        self.events = EventsOperations(
+            self._client, self.config, self._serialize, self._deserialize)
+        self.log = LogOperations(
+            self._client, self.config, self._serialize, self._deserialize)
+        self.model = ModelOperations(
+            self._client, self.config, self._serialize, self._deserialize)
+        self.multi_slot_events = MultiSlotEventsOperations(
+            self._client, self.config, self._serialize, self._deserialize)
+        self.multi_slot = MultiSlotOperations(
+            self._client, self.config, self._serialize, self._deserialize)

sdk/cognitiveservices/azure-cognitiveservices-personalizer/azure/cognitiveservices/personalizer/models/__init__.py

@@ -10,35 +10,106 @@
 # --------------------------------------------------------------------------
 
 try:
-    from .internal_error_py3 import InternalError
-    from .personalizer_error_py3 import PersonalizerError
-    from .error_response_py3 import ErrorResponse, ErrorResponseException
-    from .reward_request_py3 import RewardRequest
-    from .rankable_action_py3 import RankableAction
-    from .rank_request_py3 import RankRequest
-    from .ranked_action_py3 import RankedAction
-    from .rank_response_py3 import RankResponse
+    from ._models_py3 import ApprenticeLearningMetrics
+    from ._models_py3 import ApprenticeModeMetrics
+    from ._models_py3 import DateRange
+    from ._models_py3 import ErrorResponse, ErrorResponseException
+    from ._models_py3 import Evaluation
+    from ._models_py3 import EvaluationContract
+    from ._models_py3 import InternalError
+    from ._models_py3 import LogsProperties
+    from ._models_py3 import LogsPropertiesDateRange
+    from ._models_py3 import ModelProperties
+    from ._models_py3 import MultiSlotRankRequest
+    from ._models_py3 import MultiSlotRankResponse
+    from ._models_py3 import MultiSlotRewardRequest
+    from ._models_py3 import PersonalizerError
+    from ._models_py3 import PolicyContract
+    from ._models_py3 import PolicyReferenceContract
+    from ._models_py3 import PolicyResult
+    from ._models_py3 import PolicyResultSummary
+    from ._models_py3 import PolicyResultTotalSummary
+    from ._models_py3 import RankableAction
+    from ._models_py3 import RankedAction
+    from ._models_py3 import RankRequest
+    from ._models_py3 import RankResponse
+    from ._models_py3 import RewardRequest
+    from ._models_py3 import ServiceConfiguration
+    from ._models_py3 import ServiceStatus
+    from ._models_py3 import SlotRequest
+    from ._models_py3 import SlotResponse
+    from ._models_py3 import SlotReward
 except (SyntaxError, ImportError):
-    from .internal_error import InternalError
-    from .personalizer_error import PersonalizerError
-    from .error_response import ErrorResponse, ErrorResponseException
-    from .reward_request import RewardRequest
-    from .rankable_action import RankableAction
-    from .rank_request import RankRequest
-    from .ranked_action import RankedAction
-    from .rank_response import RankResponse
-from .personalizer_client_enums import (
-    ErrorCode,
+    from ._models import ApprenticeLearningMetrics
+    from ._models import ApprenticeModeMetrics
+    from ._models import DateRange
+    from ._models import ErrorResponse, ErrorResponseException
+    from ._models import Evaluation
+    from ._models import EvaluationContract
+    from ._models import InternalError
+    from ._models import LogsProperties
+    from ._models import LogsPropertiesDateRange
+    from ._models import ModelProperties
+    from ._models import MultiSlotRankRequest
+    from ._models import MultiSlotRankResponse
+    from ._models import MultiSlotRewardRequest
+    from ._models import PersonalizerError
+    from ._models import PolicyContract
+    from ._models import PolicyReferenceContract
+    from ._models import PolicyResult
+    from ._models import PolicyResultSummary
+    from ._models import PolicyResultTotalSummary
+    from ._models import RankableAction
+    from ._models import RankedAction
+    from ._models import RankRequest
+    from ._models import RankResponse
+    from ._models import RewardRequest
+    from ._models import ServiceConfiguration
+    from ._models import ServiceStatus
+    from ._models import SlotRequest
+    from ._models import SlotResponse
+    from ._models import SlotReward
+from ._personalizer_clientv11_preview1_enums import (
+    EvaluationJobStatus,
+    EvaluationType,
+    LearningMode,
+    PersonalizerErrorCode,
+    PolicySource,
 )
 
 __all__ = [
+    'ApprenticeLearningMetrics',
+    'ApprenticeModeMetrics',
+    'DateRange',
+    'ErrorResponse', 'ErrorResponseException',
+    'Evaluation',
+    'EvaluationContract',
     'InternalError',
+    'LogsProperties',
+    'LogsPropertiesDateRange',
+    'ModelProperties',
+    'MultiSlotRankRequest',
+    'MultiSlotRankResponse',
+    'MultiSlotRewardRequest',
     'PersonalizerError',
-    'ErrorResponse', 'ErrorResponseException',
-    'RewardRequest',
+    'PolicyContract',
+    'PolicyReferenceContract',
+    'PolicyResult',
+    'PolicyResultSummary',
+    'PolicyResultTotalSummary',
     'RankableAction',
-    'RankRequest',
     'RankedAction',
+    'RankRequest',
     'RankResponse',
-    'ErrorCode',
+    'RewardRequest',
+    'ServiceConfiguration',
+    'ServiceStatus',
+    'SlotRequest',
+    'SlotResponse',
+    'SlotReward',
+    'LearningMode',
+    'PersonalizerErrorCode',
+    'PolicySource',
+    'EvaluationJobStatus',
+    'EvaluationType',
 ]