Manually generate iothub

sdk/iothub/azure-mgmt-iothub/HISTORY.rst

@@ -3,6 +3,17 @@
 Release History
 ===============
 
+0.10.0 (2020-01-09)
++++++++++++++++++++
+
+**Features**
+
+- Support for multi-api
+
+**Breaking changes**
+
+- Model IotHubProperties no longer has parameter device_streams
+
 0.9.0 (2019-10-09)
 ++++++++++++++++++
 

sdk/iothub/azure-mgmt-iothub/README.rst

@@ -6,7 +6,7 @@ This is the Microsoft Azure IoTHub Management Client Library.
 Azure Resource Manager (ARM) is the next generation of management APIs that
 replace the old Azure Service Management (ASM).
 
-This package has been tested with Python 2.7, 3.5, 3.6 and 3.7.
+This package has been tested with Python 2.7, 3.5, 3.6, 3.7 and 3.8.
 
 For the older Azure Service Management (ASM) libraries, see
 `azure-servicemanagement-legacy <https://pypi.python.org/pypi/azure-servicemanagement-legacy>`__ library.

sdk/iothub/azure-mgmt-iothub/azure/mgmt/iothub/_iot_hub_client.py

@@ -12,58 +12,209 @@
 from msrest.service_client import SDKClient
 from msrest import Serializer, Deserializer
 
+from azure.profiles import KnownProfiles, ProfileDefinition
+from azure.profiles.multiapiclient import MultiApiClientMixin
 from ._configuration import IotHubClientConfiguration
-from .operations import Operations
-from .operations import IotHubResourceOperations
-from .operations import ResourceProviderCommonOperations
-from .operations import CertificatesOperations
-from .operations import IotHubOperations
-from . import models
 
 
-class IotHubClient(SDKClient):
+
+class IotHubClient(MultiApiClientMixin, SDKClient):
     """Use this API to manage the IoT hubs in your Azure subscription.
 
+    This ready contains multiple API versions, to help you deal with all Azure clouds
+    (Azure Stack, Azure Government, Azure China, etc.).
+    By default, uses latest API version available on public Azure.
+    For production, you should stick a particular api-version and/or profile.
+    The profile sets a mapping between the operation group and an API version.
+    The api-version parameter sets the default API version if the operation
+    group is not described in the profile.
+
     :ivar config: Configuration for client.
     :vartype config: IotHubClientConfiguration
 
-    :ivar operations: Operations operations
-    :vartype operations: azure.mgmt.iothub.operations.Operations
-    :ivar iot_hub_resource: IotHubResource operations
-    :vartype iot_hub_resource: azure.mgmt.iothub.operations.IotHubResourceOperations
-    :ivar resource_provider_common: ResourceProviderCommon operations
-    :vartype resource_provider_common: azure.mgmt.iothub.operations.ResourceProviderCommonOperations
-    :ivar certificates: Certificates operations
-    :vartype certificates: azure.mgmt.iothub.operations.CertificatesOperations
-    :ivar iot_hub: IotHub operations
-    :vartype iot_hub: azure.mgmt.iothub.operations.IotHubOperations
-
     :param credentials: Credentials needed for the client to connect to Azure.
     :type credentials: :mod:`A msrestazure Credentials
      object<msrestazure.azure_active_directory>`
-    :param subscription_id: The subscription identifier.
+    :param subscription_id: Subscription credentials which uniquely identify
+     Microsoft Azure subscription. The subscription ID forms part of the URI
+     for every service call.
     :type subscription_id: str
+    :param str api_version: API version to use if no profile is provided, or if
+     missing in profile.
     :param str base_url: Service URL
+    :param profile: A profile definition, from KnownProfiles to dict.
+    :type profile: azure.profiles.KnownProfiles
     """
 
-    def __init__(
-            self, credentials, subscription_id, base_url=None):
+    DEFAULT_API_VERSION = '2019-11-04'
+    _PROFILE_TAG = "azure.mgmt.iothub.IotHubClient"
+    LATEST_PROFILE = ProfileDefinition({
+        _PROFILE_TAG: {
+            None: DEFAULT_API_VERSION,
+        }},
+        _PROFILE_TAG + " latest"
+    )
 
+    def __init__(self, credentials, subscription_id, api_version=None, base_url=None, profile=KnownProfiles.default):
         self.config = IotHubClientConfiguration(credentials, subscription_id, base_url)
-        super(IotHubClient, 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 = '2019-07-01-preview'
-        self._serialize = Serializer(client_models)
-        self._deserialize = Deserializer(client_models)
-
-        self.operations = Operations(
-            self._client, self.config, self._serialize, self._deserialize)
-        self.iot_hub_resource = IotHubResourceOperations(
-            self._client, self.config, self._serialize, self._deserialize)
-        self.resource_provider_common = ResourceProviderCommonOperations(
-            self._client, self.config, self._serialize, self._deserialize)
-        self.certificates = CertificatesOperations(
-            self._client, self.config, self._serialize, self._deserialize)
-        self.iot_hub = IotHubOperations(
-            self._client, self.config, self._serialize, self._deserialize)
+        super(IotHubClient, self).__init__(
+            credentials,
+            self.config,
+            api_version=api_version,
+            profile=profile
+        )
+
+    @classmethod
+    def _models_dict(cls, api_version):
+        return {k: v for k, v in cls.models(api_version).__dict__.items() if isinstance(v, type)}
+
+    @classmethod
+    def models(cls, api_version=DEFAULT_API_VERSION):
+        """Module depends on the API version:
+
+           * 2016-02-03: :mod:`v2016_02_03.models<azure.mgmt.iothub.v2016_02_03.models>`
+           * 2017-01-19: :mod:`v2017_01_19.models<azure.mgmt.iothub.v2017_01_19.models>`
+           * 2017-07-01: :mod:`v2017_07_01.models<azure.mgmt.iothub.v2017_07_01.models>`
+           * 2018-01-22: :mod:`v2018_01_22.models<azure.mgmt.iothub.v2018_01_22.models>`
+           * 2018-04-01: :mod:`v2018_04_01.models<azure.mgmt.iothub.v2018_04_01.models>`
+           * 2019-03-22: :mod:`v2019_03_22.models<azure.mgmt.iothub.v2019_03_22.models>`
+           * 2019-11-04: :mod:`v2019_11_04.models<azure.mgmt.iothub.v2019_11_04.models>`
+        """
+        if api_version == '2016-02-03':
+            from .v2016_02_03 import models
+            return models
+        elif api_version == '2017-01-19':
+            from .v2017_01_19 import models
+            return models
+        elif api_version == '2017-07-01':
+            from .v2017_07_01 import models
+            return models
+        elif api_version == '2018-01-22':
+            from .v2018_01_22 import models
+            return models
+        elif api_version == '2018-04-01':
+            from .v2018_04_01 import models
+            return models
+        elif api_version == '2019-03-22':
+            from .v2019_03_22 import models
+            return models
+        elif api_version == '2019-11-04':
+            from .v2019_11_04 import models
+            return models
+        raise NotImplementedError("APIVersion {} is not available".format(api_version))
+
+    @property
+    def certificates(self):
+        """Instance depends on the API version:
+
+           * 2017-07-01: :class:`CertificatesOperations<azure.mgmt.iothub.v2017_07_01.operations.CertificatesOperations>`
+           * 2018-01-22: :class:`CertificatesOperations<azure.mgmt.iothub.v2018_01_22.operations.CertificatesOperations>`
+           * 2018-04-01: :class:`CertificatesOperations<azure.mgmt.iothub.v2018_04_01.operations.CertificatesOperations>`
+           * 2019-03-22: :class:`CertificatesOperations<azure.mgmt.iothub.v2019_03_22.operations.CertificatesOperations>`
+           * 2019-11-04: :class:`CertificatesOperations<azure.mgmt.iothub.v2019_11_04.operations.CertificatesOperations>`
+        """
+        api_version = self._get_api_version('certificates')
+        if api_version == '2017-07-01':
+            from .v2017_07_01.operations import CertificatesOperations as OperationClass
+        elif api_version == '2018-01-22':
+            from .v2018_01_22.operations import CertificatesOperations as OperationClass
+        elif api_version == '2018-04-01':
+            from .v2018_04_01.operations import CertificatesOperations as OperationClass
+        elif api_version == '2019-03-22':
+            from .v2019_03_22.operations import CertificatesOperations as OperationClass
+        elif api_version == '2019-11-04':
+            from .v2019_11_04.operations import CertificatesOperations as OperationClass
+        else:
+            raise NotImplementedError("APIVersion {} is not available".format(api_version))
+        return OperationClass(self._client, self.config, Serializer(self._models_dict(api_version)), Deserializer(self._models_dict(api_version)))
+
+    @property
+    def iot_hub(self):
+        """Instance depends on the API version:
+
+           * 2019-03-22: :class:`IotHubOperations<azure.mgmt.iothub.v2019_03_22.operations.IotHubOperations>`
+           * 2019-11-04: :class:`IotHubOperations<azure.mgmt.iothub.v2019_11_04.operations.IotHubOperations>`
+        """
+        api_version = self._get_api_version('iot_hub')
+        if api_version == '2019-03-22':
+            from .v2019_03_22.operations import IotHubOperations as OperationClass
+        elif api_version == '2019-11-04':
+            from .v2019_11_04.operations import IotHubOperations as OperationClass
+        else:
+            raise NotImplementedError("APIVersion {} is not available".format(api_version))
+        return OperationClass(self._client, self.config, Serializer(self._models_dict(api_version)), Deserializer(self._models_dict(api_version)))
+
+    @property
+    def iot_hub_resource(self):
+        """Instance depends on the API version:
+
+           * 2016-02-03: :class:`IotHubResourceOperations<azure.mgmt.iothub.v2016_02_03.operations.IotHubResourceOperations>`
+           * 2017-01-19: :class:`IotHubResourceOperations<azure.mgmt.iothub.v2017_01_19.operations.IotHubResourceOperations>`
+           * 2017-07-01: :class:`IotHubResourceOperations<azure.mgmt.iothub.v2017_07_01.operations.IotHubResourceOperations>`
+           * 2018-01-22: :class:`IotHubResourceOperations<azure.mgmt.iothub.v2018_01_22.operations.IotHubResourceOperations>`
+           * 2018-04-01: :class:`IotHubResourceOperations<azure.mgmt.iothub.v2018_04_01.operations.IotHubResourceOperations>`
+           * 2019-03-22: :class:`IotHubResourceOperations<azure.mgmt.iothub.v2019_03_22.operations.IotHubResourceOperations>`
+           * 2019-11-04: :class:`IotHubResourceOperations<azure.mgmt.iothub.v2019_11_04.operations.IotHubResourceOperations>`
+        """
+        api_version = self._get_api_version('iot_hub_resource')
+        if api_version == '2016-02-03':
+            from .v2016_02_03.operations import IotHubResourceOperations as OperationClass
+        elif api_version == '2017-01-19':
+            from .v2017_01_19.operations import IotHubResourceOperations as OperationClass
+        elif api_version == '2017-07-01':
+            from .v2017_07_01.operations import IotHubResourceOperations as OperationClass
+        elif api_version == '2018-01-22':
+            from .v2018_01_22.operations import IotHubResourceOperations as OperationClass
+        elif api_version == '2018-04-01':
+            from .v2018_04_01.operations import IotHubResourceOperations as OperationClass
+        elif api_version == '2019-03-22':
+            from .v2019_03_22.operations import IotHubResourceOperations as OperationClass
+        elif api_version == '2019-11-04':
+            from .v2019_11_04.operations import IotHubResourceOperations as OperationClass
+        else:
+            raise NotImplementedError("APIVersion {} is not available".format(api_version))
+        return OperationClass(self._client, self.config, Serializer(self._models_dict(api_version)), Deserializer(self._models_dict(api_version)))
+
+    @property
+    def operations(self):
+        """Instance depends on the API version:
+
+           * 2017-07-01: :class:`Operations<azure.mgmt.iothub.v2017_07_01.operations.Operations>`
+           * 2018-01-22: :class:`Operations<azure.mgmt.iothub.v2018_01_22.operations.Operations>`
+           * 2018-04-01: :class:`Operations<azure.mgmt.iothub.v2018_04_01.operations.Operations>`
+           * 2019-03-22: :class:`Operations<azure.mgmt.iothub.v2019_03_22.operations.Operations>`
+           * 2019-11-04: :class:`Operations<azure.mgmt.iothub.v2019_11_04.operations.Operations>`
+        """
+        api_version = self._get_api_version('operations')
+        if api_version == '2017-07-01':
+            from .v2017_07_01.operations import Operations as OperationClass
+        elif api_version == '2018-01-22':
+            from .v2018_01_22.operations import Operations as OperationClass
+        elif api_version == '2018-04-01':
+            from .v2018_04_01.operations import Operations as OperationClass
+        elif api_version == '2019-03-22':
+            from .v2019_03_22.operations import Operations as OperationClass
+        elif api_version == '2019-11-04':
+            from .v2019_11_04.operations import Operations as OperationClass
+        else:
+            raise NotImplementedError("APIVersion {} is not available".format(api_version))
+        return OperationClass(self._client, self.config, Serializer(self._models_dict(api_version)), Deserializer(self._models_dict(api_version)))
+
+    @property
+    def resource_provider_common(self):
+        """Instance depends on the API version:
+
+           * 2018-04-01: :class:`ResourceProviderCommonOperations<azure.mgmt.iothub.v2018_04_01.operations.ResourceProviderCommonOperations>`
+           * 2019-03-22: :class:`ResourceProviderCommonOperations<azure.mgmt.iothub.v2019_03_22.operations.ResourceProviderCommonOperations>`
+           * 2019-11-04: :class:`ResourceProviderCommonOperations<azure.mgmt.iothub.v2019_11_04.operations.ResourceProviderCommonOperations>`
+        """
+        api_version = self._get_api_version('resource_provider_common')
+        if api_version == '2018-04-01':
+            from .v2018_04_01.operations import ResourceProviderCommonOperations as OperationClass
+        elif api_version == '2019-03-22':
+            from .v2019_03_22.operations import ResourceProviderCommonOperations as OperationClass
+        elif api_version == '2019-11-04':
+            from .v2019_11_04.operations import ResourceProviderCommonOperations as OperationClass
+        else:
+            raise NotImplementedError("APIVersion {} is not available".format(api_version))
+        return OperationClass(self._client, self.config, Serializer(self._models_dict(api_version)), Deserializer(self._models_dict(api_version)))

sdk/iothub/azure-mgmt-iothub/azure/mgmt/iothub/models.py

@@ -0,0 +1,7 @@
+# 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.
+# --------------------------------------------------------------------------
+from .v2019_11_04.models import *

sdk/iothub/azure-mgmt-iothub/azure/mgmt/iothub/v2016_02_03/__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 ._configuration import IotHubClientConfiguration
+from ._iot_hub_client import IotHubClient
+__all__ = ['IotHubClient', 'IotHubClientConfiguration']
+
+from .version import VERSION
+
+__version__ = VERSION
+

sdk/iothub/azure-mgmt-iothub/azure/mgmt/iothub/v2016_02_03/_configuration.py

@@ -0,0 +1,48 @@
+# 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 msrestazure import AzureConfiguration
+
+from .version import VERSION
+
+
+class IotHubClientConfiguration(AzureConfiguration):
+    """Configuration for IotHubClient
+    Note that all parameters used to create this instance are saved as instance
+    attributes.
+
+    :param credentials: Credentials needed for the client to connect to Azure.
+    :type credentials: :mod:`A msrestazure Credentials
+     object<msrestazure.azure_active_directory>`
+    :param subscription_id: The subscription identifier.
+    :type subscription_id: str
+    :param str base_url: Service URL
+    """
+
+    def __init__(
+            self, credentials, subscription_id, base_url=None):
+
+        if credentials is None:
+            raise ValueError("Parameter 'credentials' must not be None.")
+        if subscription_id is None:
+            raise ValueError("Parameter 'subscription_id' must not be None.")
+        if not base_url:
+            base_url = 'https://management.azure.com'
+
+        super(IotHubClientConfiguration, 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-mgmt-iothub/{}'.format(VERSION))
+        self.add_user_agent('Azure-SDK-For-Python')
+
+        self.credentials = credentials
+        self.subscription_id = subscription_id