Generate and implement Face SDK via TypeSpec

.vscode/cspell.json

@@ -1775,6 +1775,29 @@
         "wday",
         "SNOMED"
       ]
+    },
+    {
+      "filename": "sdk/face/azure-ai-vision-face/**",
+      "words": [
+        "mros",
+        "Nify",
+        "ctxt",
+        "wday",
+        "faceid",
+        "facelistid",
+        "largefacelistid",
+        "persongroupid",
+        "largepersongroupid",
+        "dynamicpersongroupid",
+        "personid",
+        "maxnumofcandidatesreturned"
+      ]
+    },
+    {
+      "filename": "sdk/face/azure-ai-vision-face/tests/**",
+      "words": [
+        "dcid"
+      ]
     }
   ],
   "allowCompoundWords": true

sdk/face/azure-ai-vision-face/CHANGELOG.md

@@ -0,0 +1,31 @@
+# Release History
+
+## 1.0.0b1 (Unreleased)
+
+This is the first preview of the `azure-ai-vision-face` client library that follows the [Azure Python SDK Design Guidelines](https://azure.github.io/azure-sdk/python_design.html).
+This library replaces the package [azure-cognitiveservices-vision-face](https://pypi.org/project/azure-cognitiveservices-vision-face/).
+
+This package's [documentation](https://github.com/Azure/azure-sdk-for-python/tree/main/sdk/face/azure-ai-vision-face/) and [samples](https://github.com/Azure/azure-sdk-for-python/tree/main/sdk/face/azure-ai-vision-face/samples) demonstrate the new API.
+
+### Features Added
+
+- Added support for Liveness detection.
+- Added support for `person` and `dynamic_person_group` operations.
+- Added support for face recognition with `PersonDirectory` (`identify_from_person_directory()` and `identify_from_dynamic_person_group()`).
+- Asynchronous APIs are added under `azure.ai.vision.face.aio` namespace.
+- Authentication with Microsoft Entra ID is supported using `DefaultAzureCredential()` from `azure.identity`.
+
+### Breaking Changes
+
+- This library supports only the Azure AI Face v1.1-preview.1 API.
+- The namespace/package name for Azure AI Face has changed from `azure.cognitiveservices.vision.face` to `azure.ai.vision.face`.
+- Three client design:
+  - `FaceClient` to perform core Face functions such as face detection, recognition(identification and verification),
+    finding similar faces and grouping faces.
+  - `FaceAdministrationClient` to managed the following data structures that hold data on faces and persons for
+    Face recognition, like `face_list`, `large_face_list`, `person_group`, `large_person_group`, `person` and
+	`dynamic_person_group`.
+  - `FaceSessionClient` to interact with sessions which is used for Liveness detection.
+- New function names that comply with [Azure Python SDK Design Guidelines](https://azure.github.io/azure-sdk/python_design.html):
+  - For example, the method `person_group_person.create()` is changed to `create_person_group_person()`.
+- The Snapshot operations are all removed as [the Snapshot API is no longer supported](https://azure.microsoft.com/updates/facelimitedaccess/).

sdk/face/azure-ai-vision-face/LICENSE

@@ -0,0 +1,21 @@
+Copyright (c) Microsoft Corporation.
+
+MIT License
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED *AS IS*, WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

sdk/face/azure-ai-vision-face/MANIFEST.in

@@ -0,0 +1,8 @@
+include *.md
+include LICENSE
+include azure/ai/vision/face/py.typed
+recursive-include tests *.py
+recursive-include samples *.py *.md
+include azure/__init__.py
+include azure/ai/__init__.py
+include azure/ai/vision/__init__.py

sdk/face/azure-ai-vision-face/_meta.json

@@ -0,0 +1,7 @@
+{
+  "commit": "37acfe2967e5e1be1169146ac461eb1875c9476e",
+  "repository_url": "https://github.com/Azure/azure-rest-api-specs",
+  "typespec_src": "specification/ai/Face",
+  "@azure-tools/typespec-python": "0.23.8",
+  "@autorest/python": "6.13.15"
+}

sdk/face/azure-ai-vision-face/assets.json

@@ -0,0 +1,6 @@
+{
+  "AssetsRepo": "Azure/azure-sdk-assets",
+  "AssetsRepoPrefixPath": "python",
+  "TagPrefix": "python/face/azure-ai-vision-face",
+  "Tag": "python/face/azure-ai-vision-face_6a3095279a"
+}

sdk/face/azure-ai-vision-face/azure/__init__.py

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

sdk/face/azure-ai-vision-face/azure/ai/__init__.py

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

sdk/face/azure-ai-vision-face/azure/ai/vision/__init__.py

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

sdk/face/azure-ai-vision-face/azure/ai/vision/face/__init__.py

@@ -0,0 +1,26 @@
+# 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) Python Code Generator.
+# Changes may cause incorrect behavior and will be lost if the code is regenerated.
+# --------------------------------------------------------------------------
+
+from ._patch import FaceClient
+from ._client import FaceAdministrationClient
+from ._patch import FaceSessionClient
+from ._version import VERSION
+
+__version__ = VERSION
+
+
+from ._patch import patch_sdk as _patch_sdk
+
+__all__ = [
+    "FaceClient",
+    "FaceAdministrationClient",
+    "FaceSessionClient",
+]
+
+
+_patch_sdk()