Skip to content
Closed
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension


Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
2 changes: 1 addition & 1 deletion sdk/translation/azure-ai-translation-text/MANIFEST.in
Original file line number Diff line number Diff line change
Expand Up @@ -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
6 changes: 6 additions & 0 deletions sdk/translation/azure-ai-translation-text/_meta.json
Original file line number Diff line number Diff line change
@@ -0,0 +1,6 @@
{
"commit": "147495e1b6cfe5607d481278e31857dc929b42fa",
"repository_url": "https://github.com/Azure/azure-rest-api-specs",
"typespec_src": "specification/translation/Azure.AI.TextTranslation",
"@azure-tools/typespec-python": "0.44.2"
}
33 changes: 33 additions & 0 deletions sdk/translation/azure-ai-translation-text/apiview-properties.json
Original file line number Diff line number Diff line change
@@ -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.TranslateBody": "TextTranslation.TranslateBody",
"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.translate": "TextTranslation.translate",
"azure.ai.translation.text.aio.TextTranslationClient.translate": "TextTranslation.translate",
"azure.ai.translation.text.TextTranslationClient.transliterate": "TextTranslation.transliterate",
"azure.ai.translation.text.aio.TextTranslationClient.transliterate": "TextTranslation.transliterate"
}
}
Original file line number Diff line number Diff line change
Expand Up @@ -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()
Original file line number Diff line number Diff line change
Expand Up @@ -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.
Expand All @@ -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
"""

Expand All @@ -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 = [
Expand Down Expand Up @@ -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

Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -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.")
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -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()
Loading