[AutoPR track2_azure-maps-search] [Hub Generated] Review request for description changes under maps/data-plane/Route & Search

sdk/maps/azure-maps-creator/CHANGELOG.md

@@ -0,0 +1,5 @@
+# Release History
+
+## 0.1.0 (1970-01-01)
+
+* Initial Release

sdk/maps/azure-maps-creator/MANIFEST.in

@@ -0,0 +1,6 @@
+include _meta.json
+recursive-include tests *.py *.yaml
+include *.md
+include azure/__init__.py
+include azure/maps/__init__.py
+

sdk/maps/azure-maps-creator/README.md

@@ -0,0 +1,27 @@
+# Microsoft Azure SDK for Python
+
+This is the Microsoft Azure MyService Management Client Library.
+This package has been tested with Python 2.7, 3.5, 3.6, 3.7 and 3.8.
+For a more complete view of Azure libraries, see the [azure sdk python release](https://aka.ms/azsdk/python/all).
+
+
+# Usage
+
+
+To learn how to use this package, see the [quickstart guide](https://aka.ms/azsdk/python/mgmt)
+
+
+
+For docs and references, see [Python SDK References](https://docs.microsoft.com/python/api/overview/azure/)
+Code samples for this package can be found at [MyService Management](https://docs.microsoft.com/samples/browse/?languages=python&term=Getting%20started%20-%20Managing&terms=Getting%20started%20-%20Managing) on docs.microsoft.com.
+Additional code samples for different Azure services are available at [Samples Repo](https://aka.ms/azsdk/python/mgmt/samples)
+
+
+# Provide Feedback
+
+If you encounter any bugs or have suggestions, please file an issue in the
+[Issues](https://github.com/Azure/azure-sdk-for-python/issues)
+section of the project. 
+
+
+![Impressions](https://azure-sdk-impressions.azurewebsites.net/api/impressions/azure-sdk-for-python%2Fazure-maps-creator%2FREADME.png)

sdk/maps/azure-maps-creator/_meta.json

@@ -0,0 +1,11 @@
+{
+  "autorest": "3.4.5",
+  "use": [
+    "@autorest/python@5.8.4",
+    "@autorest/modelerfour@4.19.2"
+  ],
+  "commit": "0b942f5b5d8c261a4e5cd173de774caf6eb09f59",
+  "repository_url": "https://github.com/Azure/azure-rest-api-specs",
+  "autorest_command": "autorest specification/maps/data-plane/Creator/readme.md --multiapi --python --python-mode=update --python-sdks-folder=/home/vsts/work/1/s/azure-sdk-for-python/sdk --track2 --use=@autorest/python@5.8.4 --use=@autorest/modelerfour@4.19.2 --version=3.4.5",
+  "readme": "specification/maps/data-plane/Creator/readme.md"
+}

sdk/maps/azure-maps-creator/azure/__init__.py

@@ -0,0 +1 @@
+__path__ = __import__("pkgutil").extend_path(__path__, __name__)

sdk/maps/azure-maps-creator/azure/maps/__init__.py

@@ -0,0 +1 @@
+__path__ = __import__("pkgutil").extend_path(__path__, __name__)

sdk/maps/azure-maps-creator/azure/maps/creator/__init__.py

@@ -0,0 +1,19 @@
+# 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 ._creator_client import CreatorClient
+from ._version import VERSION
+
+__version__ = VERSION
+__all__ = ['CreatorClient']
+
+try:
+    from ._patch import patch_sdk  # type: ignore
+    patch_sdk()
+except ImportError:
+    pass

sdk/maps/azure-maps-creator/azure/maps/creator/_configuration.py

@@ -0,0 +1,73 @@
+# 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 typing import TYPE_CHECKING
+
+from azure.core.configuration import Configuration
+from azure.core.pipeline import policies
+
+from ._version import VERSION
+
+if TYPE_CHECKING:
+    # pylint: disable=unused-import,ungrouped-imports
+    from typing import Any, Optional, Union
+
+    from azure.core.credentials import TokenCredential
+
+
+class CreatorClientConfiguration(Configuration):
+    """Configuration for CreatorClient.
+
+    Note that all parameters used to create this instance are saved as instance
+    attributes.
+
+    :param credential: Credential needed for the client to connect to Azure.
+    :type credential: ~azure.core.credentials.TokenCredential
+    :param x_ms_client_id: Specifies which account is intended for usage in conjunction with the Azure AD security model.  It represents a unique ID for the Azure Maps account and can be retrieved from the Azure Maps management  plane Account API. To use Azure AD security in Azure Maps see the following `articles <https://aka.ms/amauthdetails>`_ for guidance.
+    :type x_ms_client_id: str
+    :param geography: This parameter specifies where the Azure Maps Creator resource is located.  Valid values are us and eu.
+    :type geography: str or ~azure.maps.creator.models.Geography
+    """
+
+    def __init__(
+        self,
+        credential,  # type: "TokenCredential"
+        x_ms_client_id=None,  # type: Optional[str]
+        geography="us",  # type: Union[str, "_models.Geography"]
+        **kwargs  # type: Any
+    ):
+        # type: (...) -> None
+        if credential is None:
+            raise ValueError("Parameter 'credential' must not be None.")
+        if geography is None:
+            raise ValueError("Parameter 'geography' must not be None.")
+        super(CreatorClientConfiguration, self).__init__(**kwargs)
+
+        self.credential = credential
+        self.x_ms_client_id = x_ms_client_id
+        self.geography = geography
+        self.credential_scopes = kwargs.pop('credential_scopes', ['https://atlas.microsoft.com/.default'])
+        kwargs.setdefault('sdk_moniker', 'maps-creator/{}'.format(VERSION))
+        self._configure(**kwargs)
+
+    def _configure(
+        self,
+        **kwargs  # type: Any
+    ):
+        # type: (...) -> None
+        self.user_agent_policy = kwargs.get('user_agent_policy') or policies.UserAgentPolicy(**kwargs)
+        self.headers_policy = kwargs.get('headers_policy') or policies.HeadersPolicy(**kwargs)
+        self.proxy_policy = kwargs.get('proxy_policy') or policies.ProxyPolicy(**kwargs)
+        self.logging_policy = kwargs.get('logging_policy') or policies.NetworkTraceLoggingPolicy(**kwargs)
+        self.http_logging_policy = kwargs.get('http_logging_policy') or policies.HttpLoggingPolicy(**kwargs)
+        self.retry_policy = kwargs.get('retry_policy') or policies.RetryPolicy(**kwargs)
+        self.custom_hook_policy = kwargs.get('custom_hook_policy') or policies.CustomHookPolicy(**kwargs)
+        self.redirect_policy = kwargs.get('redirect_policy') or policies.RedirectPolicy(**kwargs)
+        self.authentication_policy = kwargs.get('authentication_policy')
+        if self.credential and not self.authentication_policy:
+            self.authentication_policy = policies.BearerTokenCredentialPolicy(self.credential, *self.credential_scopes, **kwargs)

sdk/maps/azure-maps-creator/azure/maps/creator/_creator_client.py

@@ -0,0 +1,124 @@
+# 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 typing import TYPE_CHECKING
+
+from azure.core import PipelineClient
+from msrest import Deserializer, Serializer
+
+if TYPE_CHECKING:
+    # pylint: disable=unused-import,ungrouped-imports
+    from typing import Any, Optional, Union
+
+    from azure.core.credentials import TokenCredential
+    from azure.core.pipeline.transport import HttpRequest, HttpResponse
+
+from ._configuration import CreatorClientConfiguration
+from .operations import AliasOperations
+from .operations import DataOperations
+from .operations import DatasetOperations
+from .operations import ConversionOperations
+from .operations import FeatureStateOperations
+from .operations import SpatialOperations
+from .operations import TilesetOperations
+from .operations import WFSOperations
+from . import models
+
+
+class CreatorClient(object):
+    """APIs for managing aliases in Azure Maps.
+
+    :ivar alias: AliasOperations operations
+    :vartype alias: azure.maps.creator.operations.AliasOperations
+    :ivar data: DataOperations operations
+    :vartype data: azure.maps.creator.operations.DataOperations
+    :ivar dataset: DatasetOperations operations
+    :vartype dataset: azure.maps.creator.operations.DatasetOperations
+    :ivar conversion: ConversionOperations operations
+    :vartype conversion: azure.maps.creator.operations.ConversionOperations
+    :ivar feature_state: FeatureStateOperations operations
+    :vartype feature_state: azure.maps.creator.operations.FeatureStateOperations
+    :ivar spatial: SpatialOperations operations
+    :vartype spatial: azure.maps.creator.operations.SpatialOperations
+    :ivar tileset: TilesetOperations operations
+    :vartype tileset: azure.maps.creator.operations.TilesetOperations
+    :ivar wfs: WFSOperations operations
+    :vartype wfs: azure.maps.creator.operations.WFSOperations
+    :param credential: Credential needed for the client to connect to Azure.
+    :type credential: ~azure.core.credentials.TokenCredential
+    :param x_ms_client_id: Specifies which account is intended for usage in conjunction with the Azure AD security model.  It represents a unique ID for the Azure Maps account and can be retrieved from the Azure Maps management  plane Account API. To use Azure AD security in Azure Maps see the following `articles <https://aka.ms/amauthdetails>`_ for guidance.
+    :type x_ms_client_id: str
+    :param geography: This parameter specifies where the Azure Maps Creator resource is located.  Valid values are us and eu.
+    :type geography: str or ~azure.maps.creator.models.Geography
+    :keyword int polling_interval: Default waiting time between two polls for LRO operations if no Retry-After header is present.
+    """
+
+    def __init__(
+        self,
+        credential,  # type: "TokenCredential"
+        x_ms_client_id=None,  # type: Optional[str]
+        geography="us",  # type: Union[str, "_models.Geography"]
+        **kwargs  # type: Any
+    ):
+        # type: (...) -> None
+        base_url = 'https://{geography}.atlas.microsoft.com'
+        self._config = CreatorClientConfiguration(credential, x_ms_client_id, geography, **kwargs)
+        self._client = PipelineClient(base_url=base_url, config=self._config, **kwargs)
+
+        client_models = {k: v for k, v in models.__dict__.items() if isinstance(v, type)}
+        self._serialize = Serializer(client_models)
+        self._serialize.client_side_validation = False
+        self._deserialize = Deserializer(client_models)
+
+        self.alias = AliasOperations(
+            self._client, self._config, self._serialize, self._deserialize)
+        self.data = DataOperations(
+            self._client, self._config, self._serialize, self._deserialize)
+        self.dataset = DatasetOperations(
+            self._client, self._config, self._serialize, self._deserialize)
+        self.conversion = ConversionOperations(
+            self._client, self._config, self._serialize, self._deserialize)
+        self.feature_state = FeatureStateOperations(
+            self._client, self._config, self._serialize, self._deserialize)
+        self.spatial = SpatialOperations(
+            self._client, self._config, self._serialize, self._deserialize)
+        self.tileset = TilesetOperations(
+            self._client, self._config, self._serialize, self._deserialize)
+        self.wfs = WFSOperations(
+            self._client, self._config, self._serialize, self._deserialize)
+
+    def _send_request(self, http_request, **kwargs):
+        # type: (HttpRequest, Any) -> HttpResponse
+        """Runs the network request through the client's chained policies.
+
+        :param http_request: The network request you want to make. Required.
+        :type http_request: ~azure.core.pipeline.transport.HttpRequest
+        :keyword bool stream: Whether the response payload will be streamed. Defaults to True.
+        :return: The response of your network call. Does not do error handling on your response.
+        :rtype: ~azure.core.pipeline.transport.HttpResponse
+        """
+        path_format_arguments = {
+            'geography': self._serialize.url("self._config.geography", self._config.geography, 'str'),
+        }
+        http_request.url = self._client.format_url(http_request.url, **path_format_arguments)
+        stream = kwargs.pop("stream", True)
+        pipeline_response = self._client._pipeline.run(http_request, stream=stream, **kwargs)
+        return pipeline_response.http_response
+
+    def close(self):
+        # type: () -> None
+        self._client.close()
+
+    def __enter__(self):
+        # type: () -> CreatorClient
+        self._client.__enter__()
+        return self
+
+    def __exit__(self, *exc_details):
+        # type: (Any) -> None
+        self._client.__exit__(*exc_details)

sdk/maps/azure-maps-creator/azure/maps/creator/_metadata.json

@@ -0,0 +1,110 @@
+{
+    "chosen_version": "",
+    "total_api_version_list": ["1.0", "2.0"],
+    "client": {
+        "name": "CreatorClient",
+        "filename": "_creator_client",
+        "description": "APIs for managing aliases in Azure Maps.",
+        "base_url": null,
+        "custom_base_url": "\u0027https://{geography}.atlas.microsoft.com\u0027",
+        "azure_arm": false,
+        "has_lro_operations": true,
+        "client_side_validation": false,
+        "sync_imports": "{\"typing\": {\"azurecore\": {\"azure.core.credentials\": [\"TokenCredential\"]}}, \"conditional\": {\"stdlib\": {\"typing\": [\"Any\", \"Optional\", \"Union\"]}, \"azurecore\": {\"azure.core.pipeline.transport\": [\"HttpRequest\", \"HttpResponse\"]}}, \"regular\": {\"azurecore\": {\"azure.profiles\": [\"KnownProfiles\", \"ProfileDefinition\"], \"azure.profiles.multiapiclient\": [\"MultiApiClientMixin\"], \"msrest\": [\"Deserializer\", \"Serializer\"], \"azure.core\": [\"PipelineClient\"]}, \"local\": {\"._configuration\": [\"CreatorClientConfiguration\"]}}}",
+        "async_imports": "{\"typing\": {\"azurecore\": {\"azure.core.credentials_async\": [\"AsyncTokenCredential\"]}}, \"conditional\": {\"stdlib\": {\"typing\": [\"Any\", \"Optional\", \"Union\"]}, \"azurecore\": {\"azure.core.pipeline.transport\": [\"AsyncHttpResponse\", \"HttpRequest\"]}}, \"regular\": {\"azurecore\": {\"azure.profiles\": [\"KnownProfiles\", \"ProfileDefinition\"], \"azure.profiles.multiapiclient\": [\"MultiApiClientMixin\"], \"msrest\": [\"Deserializer\", \"Serializer\"], \"azure.core\": [\"AsyncPipelineClient\"]}, \"local\": {\"._configuration\": [\"CreatorClientConfiguration\"]}}}"
+    },
+    "global_parameters": {
+        "sync": {
+            "credential": {
+                "signature": "credential,  # type: \"TokenCredential\"",
+                "description": "Credential needed for the client to connect to Azure.",
+                "docstring_type": "~azure.core.credentials.TokenCredential",
+                "required": true
+            },
+            "x_ms_client_id": {
+                "signature": "x_ms_client_id=None,  # type: Optional[str]",
+                "description": "Specifies which account is intended for usage in conjunction with the Azure AD security model.  It represents a unique ID for the Azure Maps account and can be retrieved from the Azure Maps management  plane Account API. To use Azure AD security in Azure Maps see the following `articles \u003chttps://aka.ms/amauthdetails\u003e`_ for guidance.",
+                "docstring_type": "str",
+                "required": false
+            },
+            "geography": {
+                "signature": "geography=\"us\",  # type: Union[str, \"_models.Geography\"]",
+                "description": "This parameter specifies where the Azure Maps Creator resource is located.  Valid values are us and eu.",
+                "docstring_type": "str or ~azure.maps.creator.models.Geography",
+                "required": true
+            }
+        },
+        "async": {
+            "credential": {
+                "signature": "credential: \"AsyncTokenCredential\",",
+                "description": "Credential needed for the client to connect to Azure.",
+                "docstring_type": "~azure.core.credentials_async.AsyncTokenCredential",
+                "required": true
+            },
+            "x_ms_client_id": {
+                "signature": "x_ms_client_id: Optional[str] = None,",
+                "description": "Specifies which account is intended for usage in conjunction with the Azure AD security model.  It represents a unique ID for the Azure Maps account and can be retrieved from the Azure Maps management  plane Account API. To use Azure AD security in Azure Maps see the following `articles \u003chttps://aka.ms/amauthdetails\u003e`_ for guidance.",
+                "docstring_type": "str",
+                "required": false
+            },
+            "geography": {
+                "signature": "geography: Union[str, \"_models.Geography\"] = \"us\",",
+                "description": "This parameter specifies where the Azure Maps Creator resource is located.  Valid values are us and eu.",
+                "docstring_type": "str or ~azure.maps.creator.models.Geography",
+                "required": true
+            }
+        },
+        "constant": {
+        },
+        "call": "credential, x_ms_client_id, geography",
+        "service_client_specific": {
+            "sync": {
+                "api_version": {
+                    "signature": "api_version=None, # type: Optional[str]",
+                    "description": "API version to use if no profile is provided, or if missing in profile.",
+                    "docstring_type": "str",
+                    "required": false
+                },
+                "profile": {
+                    "signature": "profile=KnownProfiles.default, # type: KnownProfiles",
+                    "description": "A profile definition, from KnownProfiles to dict.",
+                    "docstring_type": "azure.profiles.KnownProfiles",
+                    "required": false
+                }
+            },
+            "async": {
+                "api_version": {
+                    "signature": "api_version: Optional[str] = None,",
+                    "description": "API version to use if no profile is provided, or if missing in profile.",
+                    "docstring_type": "str",
+                    "required": false
+                },
+                "profile": {
+                    "signature": "profile: KnownProfiles = KnownProfiles.default,",
+                    "description": "A profile definition, from KnownProfiles to dict.",
+                    "docstring_type": "azure.profiles.KnownProfiles",
+                    "required": false
+                }
+            }
+        }
+    },
+    "config": {
+        "credential": true,
+        "credential_scopes": ["https://atlas.microsoft.com/.default"],
+        "credential_default_policy_type": "BearerTokenCredentialPolicy",
+        "credential_default_policy_type_has_async_version": true,
+        "credential_key_header_name": null,
+        "sync_imports": "{\"regular\": {\"azurecore\": {\"azure.core.configuration\": [\"Configuration\"], \"azure.core.pipeline\": [\"policies\"]}, \"local\": {\"._version\": [\"VERSION\"]}}, \"conditional\": {\"stdlib\": {\"typing\": [\"Any\", \"Optional\", \"Union\"]}}, \"typing\": {\"azurecore\": {\"azure.core.credentials\": [\"TokenCredential\"]}}}",
+        "async_imports": "{\"regular\": {\"azurecore\": {\"azure.core.configuration\": [\"Configuration\"], \"azure.core.pipeline\": [\"policies\"]}, \"local\": {\".._version\": [\"VERSION\"]}}, \"conditional\": {\"stdlib\": {\"typing\": [\"Any\", \"Optional\", \"Union\"]}}, \"typing\": {\"azurecore\": {\"azure.core.credentials_async\": [\"AsyncTokenCredential\"]}}}"
+    },
+    "operation_groups": {
+        "alias": "AliasOperations",
+        "data": "DataOperations",
+        "dataset": "DatasetOperations",
+        "conversion": "ConversionOperations",
+        "feature_state": "FeatureStateOperations",
+        "spatial": "SpatialOperations",
+        "tileset": "TilesetOperations",
+        "wfs": "WFSOperations"
+    }
+}