[Conv authoring] python sdk 20250515preview (#42149)

* Configurations:  'specification/cognitiveservices/Language.AnalyzeConversations-authoring/tspconfig.yaml', API Version: 2025-05-15-preview, SDK Release Type: beta, and CommitSHA: 'df0a8bf7d27c634671572b2adb7835cf54975a56' in SpecRepo: 'https://github.com/Azure/azure-rest-api-specs'

* updated commit id

* initiate first version of project main client

* updated the operation distribution in authoringClient and projectAuthoringClient

* added test for create_project

* added four operation groups to the Custom Project Client

* move import and export to authoring client level

* complete the test for train

* add 7 features to custom projectOperations

* move getImportStatus and getExportStatus into authoringClient level

* added remaining features for custom projectOperations

* added variable project_operations to custom authoringProjectClient

* added deployment_operations in custom authoringProjectClient

* Added ExportedModelOperations in custom authoringProjectClient

* added trainedModelOperations in custom authoringProjectClient

* bypass super init for projectClient by implementing the whole init in custom projectClient

* add custom async authoringProjectClient

* adjust aio operations patch.py

* add __all__ in aio client patch

* modify operation group clientName

* added aio custom operation groups

* updated _utils in patch.py

* updated test_train recording for test

* remove conversationauthoring prefix from all models

* added _operations suffix to operation groups

* remove conversationauthoring prefix from aio operation patch

* made all getStatus methods private

* removed prefix AnalyzeConversationAuthoring

* rename the input type to options and output type to details

* removed conversation authoring prefix in test

* add custom function for begin_exported to return LROPoller[State]

* Define custom LROPoller for begin_deploy_project

* add custom jobstrategy and JobsPollingMethod for custom begin_deploy_project

* added custom poller with concrete result type for other features

* add overload for other custom poller features

* make all LROPoller[None] private

* run tsp-client to format

* run tsp-client to format

* added custom begin_delete_project with result type ProjectDeletionState

* make import and delete_project private

* renamed to `begin_import`

* split patch to four patch operation group

* run tsp-client to format

* dropped the _operations on these ivar names.

* make project_name a required keyword-only parameter

* removed project from overload signature for some remaining features

* split the operations to a ProjectOperationsDeploymentsRelated, and inherit from it

* use tsp-client to format

* added async version deployment operation group

* added async custom exported model operations group

* add custom async operation groups

* add aio custom trained model operations group

* dropped the _operations on async ivar names.

* make api version key-word in client initialization

* updated api version doc

* reomved generated tests and generated samples

* add tests for create projects

* added test for import

* added test for export

* added tests for get project

* add tests for delete project

* add tests for train

* add tests for cancel training jobs

* add test for get model evaluation summary

* add tests for get model evaluation result

* added tests for load snap

* added test for delete trained model

* added test for swap deployments

* added tests for delete deployment

* added tests for deploy project

* added tests for get deployments

* temporarily commit assign deployment resources

* added porjectname as keywork paramater in aio projectClient

* push recording to an assets repo

* add samples for tests

* complete general readme

* updated the sample/readme

* updated location of azure-sdk-tools in dev_requirements.txt

* modified cspell for conversation authoring

* fix some broken links in readme

* fixed broken links and add authentication client samples

* updated change log

* add samples for unassign deployment resource

* added # type: ignore in auto-generated client

* added # type: ignore to fix MyPy

* run tsp-client to refresh

* fixed all pylint

* removed await for get_model_evaluation_results in test and sample

* fixed Attribute "_resource" already defined

* update sync samples

* udpated test and sample for getEvaluationSummary

* removed https://azuresdkdocs.z19.web.core.windows.net/ related entries in readme

* updated [api_reference_authoring] in readme

* fix docstring Unexpected indentation

* try to fix Incompatible types in assignment

* fixed unexpected unindent. [docutils]

* fixed "Field list ends without a blank line; unexpected unindent. [docutils]"

* modified all async samples

* add custom cancel_training_job and add tests

* updated tag in assets.json

* update samples for cancel training job

* update readme

* added asseartion for cancel training job tests

* updated PowerShellPreparer to EnvironmentVariableLoader in tests

* make delete_ in deployment op group return LROPoller[None]

* make begin_delete in exportedModel op group return LROPoller[None]

* revert begin_load_snapshot to return LROPoller[None]

* revert some operations in project op group to return LROPoller[None]

* adjust the test for delete deployments.

* udpate async operation group to return LROPoller[None]

* udpate functions to return LROPoller[None] in client level

* adjuset tests to LROPoller[None]

* test on LROPollers

* update import, create functions to return LROPoller[None]

* update LROPoller tests and update tag in assets.json

* update all samples about LROPoller[None]

* updated readme

* update cancel training job and test

* added azure.ai.language.conversations (runtime) as hard dependency

* changed the dependency version to 2.0.0b1

* removed kwarg from docstring of client init

* update tag in assets.json

* adjust the sample for delete project async

* fixed pylint

* fixed generate Docs

* removed the extra samples

* add api-version as keyword for both async and sync projectClient

* removed private docstring

* remove getattr in HttpResponseError instance, use their error and message attributes

* remove getattr in HttpResponseError instance, use their error and message attributes in all tests

* added docstring for all sync patch functions

* added docstring for all async patch functions

* fix pylint

* added azure-ai-language-conversations to shared_requirements.txt

---------

Co-authored-by: azure-sdk <[email protected]>

Author: amber-Chen-86

.vscode/cspell.json

@@ -829,6 +829,11 @@
       "filename": "sdk/cognitivelanguage/azure-ai-language-conversations/azure/ai/language/conversations/**/_serialization.py",
       "words": [ "ctxt", "wday", "mday", "astimezone", "unflattened", "JSONify", "deseralize" ]
     },
+    {
+      "filename": "sdk/cognitivelanguage/azure-ai-language-conversations-authoring/**",
+      "words": [ "unassigning" ],
+      "caseSensitive": false
+    },
     {
       "filename": "sdk/cognitivelanguage/azure-ai-language-questionanswering/**",
       "words": [ "qnas", "qnamaker", "ADTO" ],

sdk/cognitivelanguage/azure-ai-language-conversations-authoring/CHANGELOG.md

@@ -0,0 +1,6 @@
+# Release History
+
+## 1.0.0b1 (2025-08-25)
+
+### Features Added
+* Initial release

sdk/cognitivelanguage/azure-ai-language-conversations-authoring/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/cognitivelanguage/azure-ai-language-conversations-authoring/MANIFEST.in

@@ -0,0 +1,9 @@
+include *.md
+include LICENSE
+include azure/ai/language/conversations/authoring/py.typed
+recursive-include tests *.py
+recursive-include samples *.py *.md
+include azure/__init__.py
+include azure/ai/__init__.py
+include azure/ai/language/__init__.py
+include azure/ai/language/conversations/__init__.py