[textanalytics] python sdk 2025-05-15-preview (#42928)

* Configurations:  'specification/cognitiveservices/Language.AnalyzeText/tspconfig.yaml', API Version: 2025-05-15-preview, SDK Release Type: beta, and CommitSHA: '261adc4ae25d7e639c4e13a1d63f0301e137c79d' in SpecRepo: 'https://github.com/Azure/azure-rest-api-specs' Pipeline run: https://dev.azure.com/azure-sdk/internal/_build/results?buildId=5314004 Refer to https://eng.ms/docs/products/azure-developer-experience/develop/sdk-release/sdk-release-prerequisites to prepare for SDK release.

* adjust the version to 6.0.0b1

* allow CI to temporarily ignore an entire path when necessary

* removed generated tests and samples

* check in all the tests from old branch

* udpated with new commit id

* checked in all samples from old branch

* change all azure.ai.language.text to azure.ai.textanalytics in tests

* changed all azure.ai.language.text to azure.ai.textanalytics in all samples

* added AnalyzeTextLROPoller and custom begin_analyze_text_job in _patch.py

* added AnalyzeTextAsyncLROPoller and custom begin_analyze_text_job in aio/_patch.py

* updated cspell.json

* udpated assets.json

* updated changelog

* removed _parse_operation_id from aio/_patch and import it from _patch.py

* added general readme

* updated link in readme

* make original begin_analyze_text_job private

* udpated snippets

* added disclaimer in old package readme

* fixed pylint

* updated release date

---------

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

Author: amber-Chen-86

.vscode/cspell.json

@@ -817,6 +817,74 @@
       "filename": "sdk/core/azure-core-tracing-opentelemetry/**",
       "words": [ "ctxt", "somethingstuid" ]
     },
+    {
+      "filename": "sdk/cognitivelanguage/azure-ai-textanalytics/**",
+      "words": [
+        "fhir",
+        "BRCPF",
+        "IDRG",
+        "EUGPS",
+        "PLREGON",
+        "REGON",
+        "ESDNI",
+        "USUK",
+        "ARMN",
+        "Bangla",
+        "ETHI",
+        "Ethi",
+        "GEOR",
+        "Geor",
+        "GREK",
+        "Grek",
+        "GUJR",
+        "Gujr",
+        "HANI",
+        "Hani",
+        "HEBR",
+        "Hebr",
+        "JPAN",
+        "Jpan",
+        "KHMR",
+        "Khmr",
+        "KNDA",
+        "Knda",
+        "LAOO",
+        "Laoo",
+        "MLYM",
+        "Mlym",
+        "MTEI",
+        "Mtei",
+        "Meitei",
+        "MYMR",
+        "Mymr",
+        "OLCK",
+        "Olck",
+        "ORYA",
+        "Orya",
+        "SHRD",
+        "Shrd",
+        "Sharada",
+        "TAML",
+        "Taml",
+        "TELU",
+        "Telu",
+        "THAA",
+        "Thaa",
+        "Thaana",
+        "TIBT",
+        "Tibt",
+        "UMLS",
+        "Effile",
+        "gont",
+        "mundo",
+        "naam",
+        "DBAUTH",
+        "Kelvey",
+        "CMLC",
+        "Absractive"
+      ],
+      "caseSensitive": false
+    },
     {
       "filename": "sdk/cognitivelanguage/azure-ai-language-conversations/**",
       "words": [ "conv", "summ", "Enviar", "presentación", "CLU's"],

eng/scripts/get_package_properties.py

@@ -5,6 +5,7 @@
 from typing import Dict, List
 
 from ci_tools.parsing import ParsedSetup
+from ci_tools.functions import PATHS_EXCLUDED_FROM_DISCOVERY
 
 additional_pr_triggers: Dict[str, List[str]] = {
     "azure-core":[
@@ -51,6 +52,13 @@
                 try:
                     parsed = ParsedSetup.from_path(root)
 
+                    # Remove any packages excluded from discovery
+                    # Skip packages whose folder path matches any entry in PATHS_EXCLUDED_FROM_DISCOVERY.
+                    # PATHS_EXCLUDED_FROM_DISCOVERY contains subpaths (eg. "sdk/foo/bar") relative to repo root.
+                    parsed_folder_norm = parsed.folder.replace("\\", "/")
+                    if any(excluded_path in parsed_folder_norm for excluded_path in PATHS_EXCLUDED_FROM_DISCOVERY):
+                        continue
+                    
                     dependent_packages = ""
                     if parsed.name in additional_pr_triggers:
                         dependent_packages = ",".join(additional_pr_triggers[parsed.name])

eng/tools/azure-sdk-tools/ci_tools/functions.py

@@ -43,6 +43,17 @@
     "azure-mgmt-core",
 ]
 
+# In very rare situations, we need to actively transition a package from one part of the code base to another
+# in a multi-stage process. For example, migrating "azure-ai-textanalytics" from "sdk/textanalytics" to "sdk/ai".
+# Both need to simultaneously exist for a short period of time, but we need to prevent discovery of the package
+# so that downstream checks aren't broken by this.
+# We need to actively prevent ourselves from discovering the package in its old location. To do that we:
+#  - Add the path to this list, any entrypoints that use discover_targeted_packages should exclude these paths
+#  - This will also affect usage of get_package_properties.py (Save-Package-Properties stage of CI), so please be aware of this!
+PATHS_EXCLUDED_FROM_DISCOVERY = [
+    "sdk/textanalytics/azure-ai-textanalytics",
+]
+
 TEST_COMPATIBILITY_MAP = {"azure-ai-ml": ">=3.7", "azure-ai-evaluation": ">=3.9, !=3.13.*"}
 TEST_PYTHON_DISTRO_INCOMPATIBILITY_MAP = {
     "azure-storage-blob": "pypy",
@@ -183,6 +194,15 @@ def glob_packages(glob_string: str, target_root_dir: str) -> List[str]:
         p for p in collected_top_level_directories if not any(part in ("test", "tests") for part in p.split(os.sep))
     ]
 
+    # remove any packages that might exist in the PATHS_EXCLUDED_FROM_DISCOVERY path list (relative from repo root)
+    excluded = set(PATHS_EXCLUDED_FROM_DISCOVERY)
+    filtered = []
+    for pkg_path in collected_top_level_directories:
+        rel = os.path.relpath(pkg_path, target_root_dir).replace(os.sep, '/')
+        if not any(rel == excl or rel.startswith(excl + '/') for excl in excluded):
+            filtered.append(pkg_path)
+    collected_top_level_directories = filtered
+
     # deduplicate, in case we have double coverage from the glob strings. Example: "azure-mgmt-keyvault,azure-mgmt-*"
     return list(set(collected_top_level_directories))
 

sdk/cognitivelanguage/azure-ai-textanalytics/CHANGELOG.md

@@ -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-textanalytics/LICENSE

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