[DevCenter] azure-developer-devcenter 1.0.0b2 (Azure#28530)

# Description

This pull request includes changes to the azure-developer-devcenter SDK that constitute version 1.0.0b2. This SDK version is built around version **2022-11-11-preview** of our Data Plane API. The most notable change from 1.0.0b1 is the use of an endpoint URI to construct clients, rather than tenant ID + dev center name, which was the architecture board's largest point of feedback for us in our initial review.

# All SDK Contribution checklist:
- [x] **The pull request does not introduce [breaking changes]**
- [x] **CHANGELOG is updated for new features, bug fixes or other significant changes.**
- [x] **I have read the [contribution guidelines](https://github.com/Azure/azure-sdk-for-python/blob/main/CONTRIBUTING.md).**

## General Guidelines and Best Practices
- [x] Title of the pull request is clear and informative.
- [x] There are a small number of commits, each of which have an informative message. This means that previously merged commits do not appear in the history of the PR. For more information on cleaning up the commits in your PR, [see this page](https://github.com/Azure/azure-powershell/blob/master/documentation/development-docs/cleaning-up-commits.md).

### [Testing Guidelines](https://github.com/Azure/azure-sdk-for-python/blob/main/CONTRIBUTING.md##building-and-testing)
- [x] Pull request includes test coverage for the included changes.

Author: sebrenna

sdk/devcenter/azure-developer-devcenter/CHANGELOG.md

@@ -1,14 +1,26 @@
 # Release History
 
-## 1.0.0b2 (Unreleased)
+## 1.0.0b2 (2023-02-07)
 
-### Features Added
+This release updates the Azure DevCenter library to use the 2022-11-11-preview API.
 
 ### Breaking Changes
 
+- `DevCenterClient` now accepts an endpoint URI on construction rather than tenant ID + dev center name.
+
+### Features Added
+
+- Added upcoming actions APIs to dev boxes.
+    - `delay_upcoming_action`
+    - `get_upcoming_action`
+    - `list_upcoming_actions`
+    - `skip_upcoming_action`
+
 ### Bugs Fixed
 
-### Other Changes
+- Invalid response types removed from `begin_delete_dev_box`, `begin_start_dev_box`, and `begin_stop_dev_box` APIs.
+- Invalid `begin_delete_environment_action` API removed from `DevCenterClient`.
+- Unimplemented artifacts APIs removed from `DevCenterClient`.
 
 ## 1.0.0b1 (2022-11-11)
 

sdk/devcenter/azure-developer-devcenter/azure/developer/devcenter/__init__.py

@@ -13,12 +13,14 @@
 
 try:
     from ._patch import __all__ as _patch_all
-    from ._patch import *  # type: ignore # pylint: disable=unused-wildcard-import
+    from ._patch import *  # pylint: disable=unused-wildcard-import
 except ImportError:
     _patch_all = []
 from ._patch import patch_sdk as _patch_sdk
 
-__all__ = ["DevCenterClient"]
+__all__ = [
+    "DevCenterClient",
+]
 __all__.extend([p for p in _patch_all if p not in __all__])
 
 _patch_sdk()

sdk/devcenter/azure-developer-devcenter/azure/developer/devcenter/_client.py

@@ -18,8 +18,6 @@
 
 if TYPE_CHECKING:
     # pylint: disable=unused-import,ungrouped-imports
-    from typing import Dict
-
     from azure.core.credentials import TokenCredential
 
 
@@ -32,38 +30,20 @@ class DevCenterClient:  # pylint: disable=client-accepts-api-version-keyword
     :vartype dev_boxes: azure.developer.devcenter.operations.DevBoxesOperations
     :ivar environments: EnvironmentsOperations operations
     :vartype environments: azure.developer.devcenter.operations.EnvironmentsOperations
-    :param tenant_id: The tenant to operate on. Required.
-    :type tenant_id: str
-    :param dev_center: The DevCenter to operate on. Required.
-    :type dev_center: str
+    :param endpoint: The DevCenter-specific URI to operate on. Required.
+    :type endpoint: str
     :param credential: Credential needed for the client to connect to Azure. Required.
     :type credential: ~azure.core.credentials.TokenCredential
-    :param dev_center_dns_suffix: The DNS suffix used as the base for all devcenter requests.
-     Default value is "devcenter.azure.com".
-    :type dev_center_dns_suffix: str
-    :keyword api_version: Api Version. Default value is "2022-03-01-preview". Note that overriding
+    :keyword api_version: Api Version. Default value is "2022-11-11-preview". Note that overriding
      this default value may result in unsupported behavior.
     :paramtype api_version: str
     :keyword int polling_interval: Default waiting time between two polls for LRO operations if no
      Retry-After header is present.
     """
 
-    def __init__(
-        self,
-        tenant_id: str,
-        dev_center: str,
-        credential: "TokenCredential",
-        dev_center_dns_suffix: str = "devcenter.azure.com",
-        **kwargs: Any
-    ) -> None:
-        _endpoint = "https://{tenantId}-{devCenter}.{devCenterDnsSuffix}"
-        self._config = DevCenterClientConfiguration(
-            tenant_id=tenant_id,
-            dev_center=dev_center,
-            credential=credential,
-            dev_center_dns_suffix=dev_center_dns_suffix,
-            **kwargs
-        )
+    def __init__(self, endpoint: str, credential: "TokenCredential", **kwargs: Any) -> None:
+        _endpoint = "{endpoint}"
+        self._config = DevCenterClientConfiguration(endpoint=endpoint, credential=credential, **kwargs)
         self._client = PipelineClient(base_url=_endpoint, config=self._config, **kwargs)
 
         self._serialize = Serializer()
@@ -93,27 +73,18 @@ def send_request(self, request: HttpRequest, **kwargs: Any) -> HttpResponse:
 
         request_copy = deepcopy(request)
         path_format_arguments = {
-            "tenantId": self._serialize.url("self._config.tenant_id", self._config.tenant_id, "str", skip_quote=True),
-            "devCenter": self._serialize.url(
-                "self._config.dev_center", self._config.dev_center, "str", skip_quote=True
-            ),
-            "devCenterDnsSuffix": self._serialize.url(
-                "self._config.dev_center_dns_suffix", self._config.dev_center_dns_suffix, "str", skip_quote=True
-            ),
+            "endpoint": self._serialize.url("self._config.endpoint", self._config.endpoint, "str", skip_quote=True),
         }
 
         request_copy.url = self._client.format_url(request_copy.url, **path_format_arguments)
         return self._client.send_request(request_copy, **kwargs)
 
-    def close(self):
-        # type: () -> None
+    def close(self) -> None:
         self._client.close()
 
-    def __enter__(self):
-        # type: () -> DevCenterClient
+    def __enter__(self) -> "DevCenterClient":
         self._client.__enter__()
         return self
 
-    def __exit__(self, *exc_details):
-        # type: (Any) -> None
+    def __exit__(self, *exc_details) -> None:
         self._client.__exit__(*exc_details)

sdk/devcenter/azure-developer-devcenter/azure/developer/devcenter/_configuration.py

@@ -6,13 +6,19 @@
 # Changes may cause incorrect behavior and will be lost if the code is regenerated.
 # --------------------------------------------------------------------------
 
+import sys
 from typing import Any, TYPE_CHECKING
 
 from azure.core.configuration import Configuration
 from azure.core.pipeline import policies
 
 from ._version import VERSION
 
+if sys.version_info >= (3, 8):
+    from typing import Literal  # pylint: disable=no-name-in-module, ungrouped-imports
+else:
+    from typing_extensions import Literal  # type: ignore  # pylint: disable=ungrouped-imports
+
 if TYPE_CHECKING:
     # pylint: disable=unused-import,ungrouped-imports
     from azure.core.credentials import TokenCredential
@@ -24,53 +30,32 @@ class DevCenterClientConfiguration(Configuration):  # pylint: disable=too-many-i
     Note that all parameters used to create this instance are saved as instance
     attributes.
 
-    :param tenant_id: The tenant to operate on. Required.
-    :type tenant_id: str
-    :param dev_center: The DevCenter to operate on. Required.
-    :type dev_center: str
+    :param endpoint: The DevCenter-specific URI to operate on. Required.
+    :type endpoint: str
     :param credential: Credential needed for the client to connect to Azure. Required.
     :type credential: ~azure.core.credentials.TokenCredential
-    :param dev_center_dns_suffix: The DNS suffix used as the base for all devcenter requests.
-     Default value is "devcenter.azure.com".
-    :type dev_center_dns_suffix: str
-    :keyword api_version: Api Version. Default value is "2022-03-01-preview". Note that overriding
+    :keyword api_version: Api Version. Default value is "2022-11-11-preview". Note that overriding
      this default value may result in unsupported behavior.
     :paramtype api_version: str
     """
 
-    def __init__(
-        self,
-        tenant_id: str,
-        dev_center: str,
-        credential: "TokenCredential",
-        dev_center_dns_suffix: str = "devcenter.azure.com",
-        **kwargs: Any
-    ) -> None:
+    def __init__(self, endpoint: str, credential: "TokenCredential", **kwargs: Any) -> None:
         super(DevCenterClientConfiguration, self).__init__(**kwargs)
-        api_version = kwargs.pop("api_version", "2022-03-01-preview")  # type: str
+        api_version: Literal["2022-11-11-preview"] = kwargs.pop("api_version", "2022-11-11-preview")
 
-        if tenant_id is None:
-            raise ValueError("Parameter 'tenant_id' must not be None.")
-        if dev_center is None:
-            raise ValueError("Parameter 'dev_center' must not be None.")
+        if endpoint is None:
+            raise ValueError("Parameter 'endpoint' must not be None.")
         if credential is None:
             raise ValueError("Parameter 'credential' must not be None.")
-        if dev_center_dns_suffix is None:
-            raise ValueError("Parameter 'dev_center_dns_suffix' must not be None.")
 
-        self.tenant_id = tenant_id
-        self.dev_center = dev_center
+        self.endpoint = endpoint
         self.credential = credential
-        self.dev_center_dns_suffix = dev_center_dns_suffix
         self.api_version = api_version
         self.credential_scopes = kwargs.pop("credential_scopes", ["https://devcenter.azure.com/.default"])
         kwargs.setdefault("sdk_moniker", "developer-devcenter/{}".format(VERSION))
         self._configure(**kwargs)
 
-    def _configure(
-        self, **kwargs  # type: Any
-    ):
-        # type: (...) -> None
+    def _configure(self, **kwargs: Any) -> 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)