CodeGen from PR 34547 in Azure/azure-rest-api-specs

Merge 9afaf7006571ee01ab1280c4af3aabf95ad27da4 into 9f69db7532b6706baedc004f2eda762196a3e1eb

Author: SDKAuto

sdk/translation/azure-ai-translation-text/MANIFEST.in

@@ -5,4 +5,4 @@ recursive-include tests *.py
 recursive-include samples *.py *.md
 include azure/__init__.py
 include azure/ai/__init__.py
-include azure/ai/translation/__init__.py
+include azure/ai/translation/__init__.py

sdk/translation/azure-ai-translation-text/_meta.json

@@ -0,0 +1,6 @@
+{
+  "commit": "1722bfc1c748dc5957aa8f4d9883f14844408224",
+  "repository_url": "https://github.com/Azure/azure-rest-api-specs",
+  "typespec_src": "specification/translation/Azure.AI.TextTranslation",
+  "@azure-tools/typespec-python": "0.44.2"
+}

sdk/translation/azure-ai-translation-text/apiview-properties.json

@@ -0,0 +1,33 @@
+{
+    "CrossLanguagePackageId": "TextTranslation",
+    "CrossLanguageDefinitionId": {
+        "azure.ai.translation.text.models.DetectedLanguage": "TextTranslation.DetectedLanguage",
+        "azure.ai.translation.text.models.ErrorDetails": "TextTranslation.ErrorDetails",
+        "azure.ai.translation.text.models.ErrorResponse": "TextTranslation.ErrorResponse",
+        "azure.ai.translation.text.models.GetSupportedLanguagesResult": "TextTranslation.GetSupportedLanguagesResult",
+        "azure.ai.translation.text.models.InputTextItem": "TextTranslation.InputTextItem",
+        "azure.ai.translation.text.models.LanguageScript": "TextTranslation.LanguageScript",
+        "azure.ai.translation.text.models.ReferenceSentencePair": "TextTranslation.ReferenceSentencePair",
+        "azure.ai.translation.text.models.SourceDictionaryLanguage": "TextTranslation.SourceDictionaryLanguage",
+        "azure.ai.translation.text.models.SourceText": "TextTranslation.SourceText",
+        "azure.ai.translation.text.models.TargetDictionaryLanguage": "TextTranslation.TargetDictionaryLanguage",
+        "azure.ai.translation.text.models.TranslateBodyDetails": "TextTranslation.TranslateBodyDetails",
+        "azure.ai.translation.text.models.TranslatedTextItem": "TextTranslation.TranslatedTextItem",
+        "azure.ai.translation.text.models.TranslateTarget": "TextTranslation.TranslateTarget",
+        "azure.ai.translation.text.models.TranslationLanguage": "TextTranslation.TranslationLanguage",
+        "azure.ai.translation.text.models.TranslationText": "TextTranslation.TranslationText",
+        "azure.ai.translation.text.models.TransliterableScript": "TextTranslation.TransliterableScript",
+        "azure.ai.translation.text.models.TransliteratedText": "TextTranslation.TransliteratedText",
+        "azure.ai.translation.text.models.TransliterationLanguage": "TextTranslation.TransliterationLanguage",
+        "azure.ai.translation.text.models.LanguageDirectionality": "TextTranslation.LanguageDirectionality",
+        "azure.ai.translation.text.models.TextType": "TextTranslation.TextType",
+        "azure.ai.translation.text.models.ProfanityAction": "TextTranslation.ProfanityAction",
+        "azure.ai.translation.text.models.ProfanityMarker": "TextTranslation.ProfanityMarker",
+        "azure.ai.translation.text.TextTranslationClient.get_supported_languages": "TextTranslation.getSupportedLanguages",
+        "azure.ai.translation.text.aio.TextTranslationClient.get_supported_languages": "TextTranslation.getSupportedLanguages",
+        "azure.ai.translation.text.TextTranslationClient.translate2": "TextTranslation.translate2",
+        "azure.ai.translation.text.aio.TextTranslationClient.translate2": "TextTranslation.translate2",
+        "azure.ai.translation.text.TextTranslationClient.transliterate": "TextTranslation.transliterate",
+        "azure.ai.translation.text.aio.TextTranslationClient.transliterate": "TextTranslation.transliterate"
+    }
+}

sdk/translation/azure-ai-translation-text/azure/ai/translation/text/__init__.py

@@ -5,18 +5,28 @@
 # Code generated by Microsoft (R) Python Code Generator.
 # Changes may cause incorrect behavior and will be lost if the code is regenerated.
 # --------------------------------------------------------------------------
+# pylint: disable=wrong-import-position
 
-from ._patch import TextTranslationClient
+from typing import TYPE_CHECKING
+
+if TYPE_CHECKING:
+    from ._patch import *  # pylint: disable=unused-wildcard-import
+
+from ._client import TextTranslationClient  # type: ignore
 from ._version import VERSION
 
 __version__ = VERSION
 
-
+try:
+    from ._patch import __all__ as _patch_all
+    from ._patch import *
+except ImportError:
+    _patch_all = []
 from ._patch import patch_sdk as _patch_sdk
 
 __all__ = [
     "TextTranslationClient",
 ]
-
+__all__.extend([p for p in _patch_all if p not in __all__])  # pyright: ignore
 
 _patch_sdk()

sdk/translation/azure-ai-translation-text/azure/ai/translation/text/_client.py

@@ -8,17 +8,18 @@
 
 from copy import deepcopy
 from typing import Any
+from typing_extensions import Self
 
 from azure.core import PipelineClient
 from azure.core.pipeline import policies
 from azure.core.rest import HttpRequest, HttpResponse
 
 from ._configuration import TextTranslationClientConfiguration
 from ._operations import TextTranslationClientOperationsMixin
-from ._serialization import Deserializer, Serializer
+from ._utils.serialization import Deserializer, Serializer
 
 
-class TextTranslationClient(TextTranslationClientOperationsMixin):  # pylint: disable=client-accepts-api-version-keyword
+class TextTranslationClient(TextTranslationClientOperationsMixin):
     """Text translation is a cloud-based REST API feature of the Translator service that uses neural
     machine translation technology to enable quick and accurate source-to-target text translation
     in real time across all supported languages.
@@ -37,16 +38,12 @@ class TextTranslationClient(TextTranslationClientOperationsMixin):  # pylint: di
     Detect. Returns the source code language code and a boolean variable denoting whether the
     detected language is supported for text translation and transliteration.
 
-    Dictionary lookup. Returns equivalent words for the source term in the target language.
-
-    Dictionary example Returns grammatical structure and context examples for the source term and
-    target term pair.
-
     :param endpoint: Supported Text Translation endpoints (protocol and hostname, for example:
-         https://api.cognitive.microsofttranslator.com). Required.
+         `https://api.cognitive.microsofttranslator.com
+     <https://api.cognitive.microsofttranslator.com>`_). Required.
     :type endpoint: str
-    :keyword api_version: Mandatory API version parameter. Default value is "3.0". Note that
-     overriding this default value may result in unsupported behavior.
+    :keyword api_version: Mandatory API version parameter. Default value is "2025-05-01-preview".
+     Note that overriding this default value may result in unsupported behavior.
     :paramtype api_version: str
     """
 
@@ -55,6 +52,7 @@ def __init__(  # pylint: disable=missing-client-constructor-parameter-credential
     ) -> None:
         _endpoint = "{Endpoint}"
         self._config = TextTranslationClientConfiguration(endpoint=endpoint, **kwargs)
+
         _policies = kwargs.pop("policies", None)
         if _policies is None:
             _policies = [
@@ -107,7 +105,7 @@ def send_request(self, request: HttpRequest, *, stream: bool = False, **kwargs:
     def close(self) -> None:
         self._client.close()
 
-    def __enter__(self) -> "TextTranslationClient":
+    def __enter__(self) -> Self:
         self._client.__enter__()
         return self
 

sdk/translation/azure-ai-translation-text/azure/ai/translation/text/_configuration.py

@@ -13,22 +13,23 @@
 from ._version import VERSION
 
 
-class TextTranslationClientConfiguration:  # pylint: disable=too-many-instance-attributes,name-too-long
+class TextTranslationClientConfiguration:  # pylint: disable=too-many-instance-attributes
     """Configuration for TextTranslationClient.
 
     Note that all parameters used to create this instance are saved as instance
     attributes.
 
     :param endpoint: Supported Text Translation endpoints (protocol and hostname, for example:
-         https://api.cognitive.microsofttranslator.com). Required.
+         `https://api.cognitive.microsofttranslator.com
+     <https://api.cognitive.microsofttranslator.com>`_). Required.
     :type endpoint: str
-    :keyword api_version: Mandatory API version parameter. Default value is "3.0". Note that
-     overriding this default value may result in unsupported behavior.
+    :keyword api_version: Mandatory API version parameter. Default value is "2025-05-01-preview".
+     Note that overriding this default value may result in unsupported behavior.
     :paramtype api_version: str
     """
 
     def __init__(self, endpoint: str, **kwargs: Any) -> None:
-        api_version: str = kwargs.pop("api_version", "3.0")
+        api_version: str = kwargs.pop("api_version", "2025-05-01-preview")
 
         if endpoint is None:
             raise ValueError("Parameter 'endpoint' must not be None.")

sdk/translation/azure-ai-translation-text/azure/ai/translation/text/_operations/__init__.py

@@ -5,14 +5,21 @@
 # Code generated by Microsoft (R) Python Code Generator.
 # Changes may cause incorrect behavior and will be lost if the code is regenerated.
 # --------------------------------------------------------------------------
+# pylint: disable=wrong-import-position
 
-from ._patch import TextTranslationClientOperationsMixin
+from typing import TYPE_CHECKING
 
+if TYPE_CHECKING:
+    from ._patch import *  # pylint: disable=unused-wildcard-import
 
+from ._operations import TextTranslationClientOperationsMixin  # type: ignore
+
+from ._patch import __all__ as _patch_all
+from ._patch import *
 from ._patch import patch_sdk as _patch_sdk
 
 __all__ = [
     "TextTranslationClientOperationsMixin",
 ]
-
+__all__.extend([p for p in _patch_all if p not in __all__])  # pyright: ignore
 _patch_sdk()